Rate limits

The limit

Each key may make a set number of calls a minute. The current number is on the pricing page. It is counted per key, in one-minute windows, the same in test and live.

Past the limit

HTTP/1.1 429 Too Many Requests
Retry-After: 60
X-Request-Id: req_8f2c41d09b7e4a6f

The body carries error.code: rate_limited. Wait the seconds in Retry-After, then carry on. Calls refused this way are not held or replayed.

Staying inside it

• Cache. A list of games read once an hour serves every visitor in that hour.
• Page with limit=100 instead of making many small requests.
• Fetch on your server on a schedule, not once per page view.

Needing more

Write to us with what you are building and roughly how many calls a day. Staff can raise the limit for one key.