Endpoint overview

Find REST endpoint contracts for account lookup, publication, media, generation, sources, inbox, analytics, and credits.

Base URL: https://backend.blotato.com/v2

Auth Header: blotato-api-key: YOUR_API_KEY

For a task-oriented entry point, read Start with an AI agent. Use the public operation index for coverage of the live OpenAPI document, or the agent reference for compact request examples.

Rate limits below describe selected routes. A dash means no limit is stated in this table, not unlimited access. Follow Rate limits.

---

Account

Method	Endpoint	Description	Rate Limit
GET	/users/me	Verify API key, get user info	—
GET	/users/me/usage	Get connected-account usage, active-contact usage, and active-contact limit	—
GET	/users/me/accounts	List connected social accounts	—
GET	/users/me/accounts/:id/subaccounts	Get Facebook/LinkedIn page IDs	—
GET	/social/pinterest/boards	List Pinterest boards (get boardId)	45 / min

Credits

Method	Endpoint	Description	Rate Limit
GET	/credits	Get credit balance and pricing	—
POST	/credits	Create a Stripe Checkout link to buy credits	10 / hour

Post

Method	Endpoint	Description	Rate Limit
POST	/posts	Create and publish a post	30 / min
GET	/posts	List posts (scheduled, published, failed)	60 / min
GET	/posts/:postSubmissionId	Poll post publishing status	60 / min
GET	/published-posts	List published posts with latest analytics	—
GET	/published-posts/:id	Get a published post and its original payload	—
POST	/media	Upload media from URL (optional)	30 / min

Analytics

Method	Endpoint	Description	Rate Limit
GET	/analytics	List top-performing posts	—
GET	/analytics/platforms	Compare platform performance	—
GET	/analytics/summary	Get publishing and analytics totals	—
GET	/posts/:id/analytics	Get analytics for a published post	—

Comments

Method	Endpoint	Description	Rate Limit
GET	/comments	List comments on your posts	60 / min
GET	/comments/:commentId	Get a single comment	60 / min
POST	/comments	Post a comment on a published post	30 / min

Messages

Method	Endpoint	Description	Rate Limit
GET	/conversations	List direct-message conversations	60 / min
GET	/conversations/:conversationId	Get a single conversation	60 / min
GET	/messages	List messages	60 / min
GET	/messages/:messageId	Get a single message	60 / min
POST	/messages	Send a direct message	30 / min

DM Automations

Method	Endpoint	Description	Rate Limit
GET	/dm-automations	List DM automations	60 / min
GET	/dm-automations/:id	Get a DM automation	60 / min
POST	/dm-automations	Create a DM automation	30 / min
PATCH	/dm-automations/:id	Update a DM automation	30 / min
PATCH	/dm-automations/:flowId/triggers/:triggerId	Update a single trigger	30 / min
DELETE	/dm-automations/:id	Archive a DM automation	30 / min
GET	/dm-automations/:id/runs	List automation runs	60 / min
GET	/dm-automations/:id/logs	List automation logs	60 / min
GET	/dm-automations/:id/analytics	Get automation stats	60 / min

Scheduled Posts

Method	Endpoint	Description	Rate Limit
GET	/schedules	List scheduled posts	—
GET	/schedules/:id	Get a scheduled post	—
PATCH	/schedules/:id	Update a scheduled post	—
DELETE	/schedules/:id	Delete a scheduled post	—

Visual

Method	Endpoint	Description	Rate Limit
POST	/videos/from-templates	Create visual from template	30 / min
GET	/videos/creations/:id	Poll visual creation status	—
GET	/videos/templates	List available templates	—
DELETE	/videos/:id	Delete a video	—

Source

Method	Endpoint	Description	Rate Limit
POST	/source-resolutions-v3	Extract content from URL or text	30 / min
GET	/source-resolutions-v3/:id	Poll source extraction status	60 / min

---

Async Pattern

Publishing, source extraction, visual generation, comment posting, and message sending use operation-specific completion checks. Uploads and configuration changes do not use this same polling pattern:

1. Submit a POST request to create the resource

2. Use the returned ID to poll the GET endpoint at the intervals in Async jobs and polling

3. Stop when the status reaches a terminal value

See Async Workflows for the full protocol and examples.