Rate Limits
Understand usage limits for the Open Data Dictionary API.
To ensure fair usage for all users, the API has rate limits in place.
Plans
| Plan | Daily Limit | Reset Time |
|---|---|---|
| Free | 100 requests/day | Midnight UTC |
| Pro (coming soon) | 10,000 requests/day | Midnight UTC |
Rate Limit Headers
Every API response includes rate limit information in headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Your daily request limit |
X-RateLimit-Remaining | Requests remaining today |
X-RateLimit-Reset | UTC timestamp when the limit resets |
When You Exceed the Limit
If you exceed your daily limit, the API returns a 429 Too Many Requests response:
The response includes a Retry-After header indicating how many seconds until the limit resets. Wait for the reset or upgrade your plan to continue making requests.
Checking Your Usage
View your current usage in your Account Settings page under the "API Token" section.
Running into limits?
See the Troubleshooting guide for tips on optimizing your requests.