Overview
The Posts API allows you to create and schedule content across multiple social media platforms from a single endpoint.Supported Platforms
| Platform | Endpoint | Content Limit |
|---|---|---|
/v1/posts/instagram | 2,200 characters | |
/v1/posts/linkedin | 3,000 characters | |
| X (Twitter) | /v1/posts/x | 280 characters |
| Threads | /v1/posts/threads | 500 characters |
Authentication
All Posts API endpoints require authentication via API key:Common Fields
All platforms share these fields:| Field | Type | Description |
|---|---|---|
user_id | UUID | Your user ID (must match API key owner) |
title | string | Internal title for organization (max 200 chars) |
status | enum | draft, scheduled, published, failed |
scheduled_date | ISO 8601 | When to publish (for scheduled posts) |
hashtags | string[] | Hashtags without # prefix |
media_urls | string[] | URLs of media to attach |
Post Status Workflow
| Status | Description |
|---|---|
draft | Saved but not scheduled |
scheduled | Will be published at scheduled_date |
published | Successfully posted to platform |
failed | Publishing failed (check error logs) |
Rate Limiting
| Limit | Value |
|---|---|
| Requests per minute | 30 |
| Max payload size | 50KB |