API Overview, Access, and Pricing

Access and pricing

• The Developer API is an add-on on top of an active subscription.
• Pricing: $5/month or $50/year, purchased from Settings → Billing → Add-ons.
• After purchase, you can create and rotate API keys in Settings → Developers.

Authentication

• Each request must include Authorization: Bearer <api_key>.
• Keys are scoped to your workspace; rotate if you suspect leakage.

Core endpoints

• POST /v1/posts: create a draft with per-platform payloads.
• POST /v1/schedule: queue a scheduled post with scheduledAt timestamps.
• GET /v1/posts: list posts with status filters (draft, scheduled, published, failed).

Rate limits

• Default: 100 write requests/hour per workspace; read endpoints allow higher volume but should still be paginated.
• 429 responses include Retry-After headers—back off before retrying.

Webhooks

• Configure a webhook endpoint to receive publish status updates. We send postId, platform, status, and error (if any).

Best practices

• Validate media size locally before upload to avoid platform rejections.
• Use idempotency keys on POST /v1/posts when retrying after timeouts.
• Keep API keys out of client-side code; proxy through your backend.