Rate Limits

Monthly Quotas

Each plan has monthly limits that reset on the 1st of each month (UTC):

Burst Rate Limiting

To prevent abuse, API requests are limited to 60 requests per minute per API key (sliding window). This is separate from monthly quotas.

Quota behavior

• All plans: Hard monthly post limit. Requests beyond your plan's limit return 429 until the next billing cycle. Upgrade anytime for more capacity.
• Scale / Enterprise: Custom quotas — contact us at hey@chirpie.ai.

Handling 429 Responses

When you hit a limit, the API returns 429:

{
  "error": {
    "code": "rate_limited",
    "message": "Monthly post limit exceeded (50/50 used). Upgrade your plan at chirpie.ai/dashboard/billing"
  }
}

Best Practices

1. Check your usage before bulk operations — use the dashboard billing page
2. Implement exponential backoff for burst rate limits
3. Batch scheduling — schedule posts with staggered times rather than posting all at once
4. Use threads — a 10-post thread is one API call (though it counts as 10 posts against your quota)

Platform Rate Limits

In addition to Chirpie's limits, each platform enforces its own rate limits:

X/Twitter

X enforces approximately 200 tweets/user/day. If X rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Bluesky

Bluesky enforces rate limits via the AT Protocol (approximately 1,667 actions/day, 35 actions/30 seconds). If Bluesky rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

LinkedIn

LinkedIn enforces approximately 100 posts per day per member. If LinkedIn rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Threads

Threads enforces a limit of 250 posts per 24-hour period. If Threads rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Mastodon

Mastodon enforces a default limit of 300 posts per 3-hour period (varies by instance). If Mastodon rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Instagram

Instagram enforces a limit of 50 posts per 24-hour period. If Instagram rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Facebook

Facebook enforces a limit of 4,800 API calls per 24-hour period per page. If Facebook rate-limits your page, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Telegram

Telegram enforces approximately 30 messages per second to the same chat. If Telegram rate-limits your bot, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Reddit

Reddit enforces approximately 60 requests per minute and 100 posts per 24 hours per account. If Reddit rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Pinterest

Pinterest enforces approximately 1,000 API calls per hour. If Pinterest rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

TikTok

If TikTok rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

YouTube

YouTube enforces a daily upload quota of approximately 6 videos per day (10,000 units/day). If YouTube rate-limits your channel, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Google Business Profile

Google Business Profile enforces API quotas per project. If Google rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Snapchat

Snapchat enforces rate limits per application. If Snapchat rate-limits your account, Chirpie returns a 502 error. Scheduled posts will be retried automatically.

Character Limits