API

Rate limits and request size

Each key has a request rate limit, and public routes have a smaller one per address. Over the limit the API answers rate_limited with a Retry-After header saying how many seconds to wait. Bodies are limited to 256 KB on API routes, so media goes to storage through a signed address.

Updated 2026-10-26

  • Key routes: limited per key; the numbers are in the security scheme of the reference.
  • Public routes and free tools: 30 requests a minute and 1,000 a day per address, with no key.
  • Bodies: 256 KB on API routes. Larger files use media uploads.

Back off for the number of seconds in Retry-After, then retry with the same Idempotency-Key.

Try it

Start a trial

7-day trial for $1. Connect your accounts and schedule a week of posts in one sitting.

Start a trial
Free in your browser

Free tools

Count characters the way each network does, split threads and preview posts. No account needed.

Open the tools
For builders

API and MCP

Post to every network from your own code or assistant with one key, signed webhooks and idempotent requests.

See the API

Get this week’s posts scheduled

Connect your accounts, write once and let 1Post publish on time while you get on with the rest of your day.