Rate Limits

Every API key has a daily call limit based on its tier. The counter resets on your first request after midnight UTC.

Limits by tier

Tier	Daily limit	Max page size
Free	100	100
Tier 1	1,000	250
Tier 2	10,000	500
Tier 3	100,000	1,000
Tier 4	1,000,000	1,000

Response headers

Every authenticated response includes rate limit headers:

Header	Description
`X-RateLimit-Limit`	Your daily limit
`X-RateLimit-Remaining`	Calls remaining today
`X-RateLimit-Used-Monthly`	Total calls this billing month

Example:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 842
X-RateLimit-Used-Monthly: 4523

When you hit the limit

If you exceed your daily limit, you’ll receive a 429 Too Many Requests response:

{
  "error": "Rate limit exceeded",
  "message": "Daily limit of 1000 requests exceeded.",
  "limit": 1000,
  "upgrade_url": "https://docs.trythinkbase.com/pricing"
}

The counter resets on your first request after midnight UTC. The X-RateLimit-Remaining header will show 0 until the reset.

Page size limits

The limit query parameter (results per page) is clamped to your tier’s maximum. If you request limit=500 on a Free tier key, you’ll get 100 results.

Tips

Use the X-RateLimit-Remaining header to pace your requests.
Cache responses when possible. Debate data doesn’t change every second.
If you consistently hit your limit, consider upgrading your tier.

​Rate Limits

​Limits by tier

​Response headers

​When you hit the limit

​Page size limits

​Tips