Snooker API plans and limits

What each plan reads, its limits and the headers that report them.

The Free key: 30 calls a minute and 50 a day, reading yesterday, today and what is scheduled ahead on every endpoint. Real data, never samples.

The paid plans read the whole record from 1927 with higher limits. Prices are on Pricing.

Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-Quota-Remaining. Past the minute's limit the answer is 429 rate_limited, past the day's 429 quota_exceeded, each with Retry-After in seconds. GET /v1/usage shows where your key stands and is not counted.

On every plan, matches more than 48 hours ahead are not returned.