API Documentation

Free REST API for global statistics. JSON responses. No authentication required for basic access.

Base URL: https://statisticsoftheworld.com

Rate Limits & Pricing

Tier	Rate Limit	Price	Auth
Anonymous	100 req/day	Free	None (IP-based)
Developer	1,000 req/day	Free	`X-API-Key`
Pro	50,000 req/day	$49/mo	`X-API-Key`
Business	500,000 req/day	$500/mo	`X-API-Key`
Enterprise	Unlimited	Custom	`X-API-Key`

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Tier

GET/api/v1/countries

List all 217 countries with metadata.

Example curl

curl https://statisticsoftheworld.com/api/v1/countries

Response

{"count":217,"data":[{"id":"USA","name":"United States","region":"North America",...}]}

GET/api/v1/countries/:id

Get a single country with all latest indicator values.

Example curl

curl https://statisticsoftheworld.com/api/v1/countries/USA

Response

{"country":{"id":"CAN","name":"Canada",...},"indicators":[{"id":"IMF.NGDPD","value":2420000000000,...}]}

GET/api/v1/indicators

List all indicators with categories and metadata.

Example curl

curl https://statisticsoftheworld.com/api/v1/indicators

Response

{"count":335,"categories":[...],"data":[{"id":"SP.POP.TOTL","label":"Population",...}]}

GET/api/v1/indicators/:id

Get a single indicator ranked across all countries.

Example curl

curl https://statisticsoftheworld.com/api/v1/indicators/USA

Response

{"indicator":{...},"count":192,"data":[{"rank":1,"countryId":"USA","value":31820000000000},...]}

GET/api/v1/history/:indicator/:country

Get 20+ years of historical data for an indicator-country pair.

Example curl

curl https://statisticsoftheworld.com/api/v1/history/SP.POP.TOTL/CAN

Response

{"indicator":{...},"country":"CAN","data":[{"year":2000,"value":744631000000},{"year":2001,...}]}

GET/api/v1/rankings/:indicator

Get ranked list of countries for an indicator. Supports ?limit=N parameter.

Example curl

curl https://statisticsoftheworld.com/api/v1/rankings/SP.POP.TOTL

Response

{"indicator":{...},"count":192,"data":[{"rank":1,"countryId":"CHN","country":"China","value":1425893000},...]}

IMF World Economic Outlook

World Bank WDI

FRED (Federal Reserve)

Yahoo Finance

European Central Bank

Alpha Vantage

ExchangeRate-API