API v2 Documentation

Endpoints Code Lookup

Rate Limits

All National Statistical accounts are rate limited. All rate limits reset at the top of each hour.

The meta block in XML and JSON-formatted data will include information on your API key's current rate limitation status. Please review our three-strike policies on API abuse.

HeaderDescription
X-RateLimit-RemainingThe number of API requests allowable before the time specified in X-Rate-Limit-Reset.
X-RateLimit-LimitThe number of API requests allowable each hour.
X-RateLimit-ResetThe time (US Eastern) when the rate limit will be reset to the number in X-RateLimit-Limit.

Below is a sample PHP-formatted meta block for an authorized subscriber.

[User] => Anna Lytic
[X-RateLimit-Remaining] => 3592
[X-RateLimit-Limit] => 5000
[X-Rate-Limit-Reset] => 2022-04-27 03:00:04