RanklyBee logoRanklyBee

Rate limits

Read the response headers and pace API requests safely.

Per-token request limit

Each token can make up to 100 requests per minute. You can have up to 10 active tokens.

Authenticated responses include:

HeaderMeaning
X-RateLimit-LimitRequests allowed in the current minute.
X-RateLimit-RemainingRequests remaining in the current minute.
X-RateLimit-ResetUnix timestamp when the current window resets.
Retry-AfterHow long to wait after a 429 response.

When the limit is exceeded, the API returns 429 RATE_LIMIT_EXCEEDED. Wait for Retry-After before retrying.

Retry guidance

  • Reads are safe to retry after a timeout.
  • Do not retry UNAUTHORIZED, SCOPE_REQUIRED, or VALIDATION_ERROR until the request is corrected.
  • For RATE_LIMIT_EXCEEDED, wait for Retry-After before retrying.

Authentication

Create scoped tokens and keep API access limited to the workspaces you need.

Error handling

Handle stable error codes and validation failures.

On this page

Per-token request limitRetry guidance