Rate Limits

Rate limits protect the API from abuse and ensure fair usage for all builders.

Rate Limit Tiers

Tier	Limit	Window	Scope
Public	15 requests	1 minute	Per IP
Builder	60 requests	1 minute	Per API Key

Rate Limit Headers

Every response includes rate limit information:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1705312800

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when limit resets

Rate Limit Exceeded

When you exceed the rate limit, you’ll receive:

{
  "success": false,
  "statusCode": 429,
  "message": "Rate limit exceeded. Try again in 45 seconds."
}

Best Practices

Cache responses when possible

Use pagination to reduce request count

Implement exponential backoff on 429 errors

Monitor your usage via the /builder/usage endpoint

Exponential Backoff Example

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After') || Math.pow(2, i);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }

    return response;
  }
  throw new Error('Max retries exceeded');
}

Endpoint-Specific Limits

Public Endpoints (No Auth)

Endpoint	Limit
`GET /v1/missions`	15/min
`GET /v1/missions/:tweetId`	15/min
`GET /v1/missions/:tweetId/submissions`	15/min

Builder Endpoints (API Key Required)

Endpoint	Limit
`GET /v1/builder/missions/:tweetId/submissions`	60/min
`GET /v1/builder/stats`	60/min
`GET /v1/builder/usage`	60/min
`PATCH /v1/builder/submissions/:id/approve`	60/min
`PATCH /v1/builder/submissions/:id/reject`	60/min
`PATCH /v1/builder/submissions/:id/reset`	60/min

Rate limits are configurable by administrators and may change. Always check the response headers for current limits.

Getting Started

Product Updates

Onsite Missions

Social Missions

Platform Features

Open API

Support

Rate Limit Tiers

Rate Limit Headers

Rate Limit Exceeded

Best Practices

Exponential Backoff Example

Endpoint-Specific Limits

Public Endpoints (No Auth)

Builder Endpoints (API Key Required)

​Rate Limit Tiers

​Rate Limit Headers

​Rate Limit Exceeded

​Best Practices

​Exponential Backoff Example

​Endpoint-Specific Limits

​Public Endpoints (No Auth)

​Builder Endpoints (API Key Required)

Rate Limit Tiers

Rate Limit Headers

Rate Limit Exceeded

Best Practices

Exponential Backoff Example

Endpoint-Specific Limits

Public Endpoints (No Auth)

Builder Endpoints (API Key Required)