Skip to main content

​
Base URL

EnvironmentURL
Productionhttps://app.autoposting.ai/api-proxy
All API paths below are relative to this base. The interactive playground on each endpoint page is pre-configured with it.

​
Authentication

Pass your API key on every request: 
Authorization: Bearer sk-social-your-key
Generate keys in the dashboard or via POST /api-keys. Keys are org-scoped and work for all content operations.

​
Response Format

Every endpoint returns a consistent JSON envelope: 
{
  "success": true,
  "data": { }
}

​
Error Codes

StatusCodeMeaning
400—Bad request — missing or invalid parameters
401—Unauthorized — invalid or missing API key
402insufficient_creditsNot enough credits for this operation
403billing_suspendedSubscription expired or suspended
404—Resource not found or not owned by your org
409—Conflict — missing connection, expired token, or duplicate
429—Rate limited — back off and retry
500—Internal server error
All mutation endpoints enforce billing status. Suspended orgs receive 403 billing_suspended on all content-creation routes.

​
Pagination

Offset-based pagination on all list endpoints:
ParameterDefaultMaxDescription
limit50100Items per page
offset0—Items to skip
Responses include a total count for computing page ranges: 
GET /posts?brandSlug=my-brand&limit=20&offset=40

​
Rate Limiting

Signup is limited to 5 requests per IP per hour. General API requests are subject to per-org limits. On 429, back off and retry after the interval indicated in the response.

​
Health Check

curl https://app.autoposting.ai/api-proxy/health
# { "success": true }
No authentication required. Returns 200 OK when the API is operational.

TypeScript SDK

Zero-dependency TypeScript client for Node.js 20+.

MCP Tools

Call the API through AI assistants.

CLI Commands

Terminal access to all operations.

Authentication

Session tokens, OAuth flows, and API keys.