Rate Limiting

The GIFQ API enforces a limit of 10 requests per second per API token. Each token's quota is tracked independently — traffic from one integration does not affect another.

When the limit is exceeded, the API returns HTTP 429 along with a Retry-After header indicating how many seconds to wait before retrying.

Response

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json
{
  "message": "Too many requests. Try again later.",
  "status": "error"
}

Handling 429s

Read the Retry-After header and pause requests for that many seconds before continuing. A value of 1 means you can resume after one second.

IP fallback

Requests that reach the API without an X-Api-Token header are throttled by IP address under the same 10 requests/second limit.