Neeflow API Documentation

Automate your social media publishing across 10+ platforms. Create posts, upload media, generate AI content, and monitor performance — all via a simple REST API.

FacebookInstagramTikTokX (Twitter)LinkedInYouTubePinterestThreadsBlueskyGoogle Business

Base URL

https://app.neeflow.com/api/v1

Authentication

All API requests require an API key passed via the X-API-Key header.

Create your API key in the Developer Dashboard after logging in.

curl -H "X-API-Key: ask_xxxxxxxxxxxxxxxx" \
  https://app.neeflow.com/api/v1/channels
Security: API keys are hashed using bcrypt — the raw key is shown only once at creation. Treat it like a password and rotate regularly.

Rate Limits

API calls are quota-limited per plan per month. Check your limits in the response headers:

X-RateLimit-Limit

Monthly quota

X-RateLimit-Remaining

Calls remaining

X-RateLimit-Reset

Reset timestamp (ISO 8601)

When your quota is exhausted, the API returns 429 Too Many Requests.

Response Format

All responses follow a consistent JSON envelope:

✓ Success (200 / 201)

{
  "success": true,
  "data": { ... }
}

✕ Error (4xx / 5xx)

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Description"
  }
}

Automation Flow

Here's a typical end-to-end automation workflow using the Neeflow API:

1
POST/api/v1/media/upload

Upload images or videos to the media library

2
POST/api/v1/ai/generate

Generate AI-powered captions using your brand voice

3
POST/api/v1/posts

Create a post with media + AI content

4
POST/api/v1/posts/{id}/publish

Publish immediately or schedule for later

5
GET/api/v1/analytics

Monitor publishing results and performance

6
POST/api/v1/posts/{id}/retry

Auto-retry any failed platform publishes

Channels

1

Posts

5

Post Actions

3

Automation

1

Media

2

Approvals

2

AI Content

2

Monitoring

2

Account

1

Ready to automate?

Create a free account to get your API key and start publishing to 10+ platforms.

Get Started Free Open Playground