worlddata.info APIworlddata.info ↗
Access country statistics, demographics, economy, education, and quality of life data for every nation via the worlddata.info API. 18 endpoints.
curl -X GET 'https://api.parse.bot/scraper/e59330b6-d0ac-495e-a6cc-98d959184a75/get_population_growth_worldwide?period=2015-2024' \ -H 'X-API-Key: $PARSE_API_KEY'
Get population growth rates for countries worldwide. Returns a ranked list of countries with their average annual growth rate and total growth for the specified period.
| Param | Type | Description |
|---|---|---|
| period | string | Time period range in format 'YYYY-YYYY' (e.g. '2015-2024', '2005-2014', '1960-2024'). |
{
"type": "object",
"fields": {
"data": "array of objects with Country/Region, Ø Growth/year, Growth <period> fields",
"period": "string, the requested period"
},
"sample": {
"data": {
"data": [
{
"Country/Region": "Equatorial Guinea",
"Ø Growth/year": "5.50%",
"Growth 2015-2024": "40.50%",
"Country/Region_url": "https://www.worlddata.info/africa/equatorial-guinea/populationgrowth.php"
}
],
"period": "2015-2024"
},
"status": "success"
}
}About the worlddata.info API
The worlddata.info API covers 18 endpoints returning country-level statistics across population, economy, education, health, and more. A single call to get_country_overview returns structured sections on languages, religions, economy, transport, land use, and political indicators for any country. Other endpoints expose global rankings for life expectancy, quality of life, average IQ, refugee flows, and educational attainment — all as structured JSON arrays.
Country Profiles and Comparisons
get_country_overview accepts a country_path parameter in continent/country format (e.g. europe/germany, asia/japan) and returns a sections object grouping rows by topic: Languages, Religions, Economy, and more. compare_countries takes two ISO 3166-1 alpha-3 codes and returns a side-by-side breakdown across General information, Population, Economy, Infrastructure, Healthcare, Education, and Climate sections. get_country_economy breaks out Economic performance and Imports/Exports sections for a single country, including top companies and budget data.
Population and Demographics
get_population_growth_worldwide accepts an optional period parameter in YYYY-YYYY format — such as 2015-2024 or 1960-2024 — and returns a ranked list of countries with average annual growth rate and total growth over the period. get_country_population_history returns year-by-year records including birth and death rates benchmarked against world averages. get_life_expectancy_worldwide adds male and female life expectancy alongside birth and death rates per country.
Global Rankings and Indices
get_quality_of_life returns country scores across seven weighted sub-indices: Stability (15%), Rights (20%), Health (15%), Safety (10%), Climate (15%), Costs (15%), and Popularity. get_education_by_country ranks countries from elementary through doctoral attainment levels with an overall ranking score. get_iq_by_country pairs average IQ with average income, education expenditure per inhabitant, and average daily maximum temperature. get_average_body_height provides average height, weight, and BMI by country.
Reference and Search
get_country_codes returns every major code standard per country: ISO 3166-1 alpha-2 and alpha-3, numeric, IOC, FIPS 10, license plate, and internet domain. get_languages_worldwide lists languages by number of native speakers, the count of countries each is spoken in, and worldwide percentage. get_religions_worldwide ranks religions by global follower percentage and total count. search_site accepts a free-text query and returns matching pages with title, URL, and description, useful for discovering what country or indicator paths exist.
- Build a country comparison tool using
compare_countriesto surface side-by-side Economy and Healthcare metrics. - Track demographic trends over decades by calling
get_population_growth_worldwidewith differentperiodvalues such as1960-2024and2015-2024. - Enrich a dataset with standardized identifiers using
get_country_codesto map between ISO alpha-2, alpha-3, IOC, and FIPS 10 codes. - Power a quality-of-life dashboard with the seven weighted sub-scores from
get_quality_of_life. - Analyze education inequality by combining
get_education_by_countryattainment levels withget_iq_by_countryexpenditure figures. - Visualize global refugee patterns using origin and destination country tallies from
get_refugees_data. - Generate regional breakdowns of language and country data for a specific continent using
get_countries_by_region.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does worlddata.info offer an official developer API?+
What does `get_country_overview` return, and how do I specify a country?+
sections object whose keys are topic names — Languages, Religions, Economy, Transport, Land use, and Political indicators — each mapping to an array of row objects. You supply a country_path string in continent/country format, for example africa/nigeria or america/usa. If you are unsure of the path for a country, search_site can help you find the correct slug.Does the API expose historical economic time-series data, such as annual GDP figures per country?+
get_country_economy returns current economic performance, imports/exports, and budget sections, but does not expose a year-by-year GDP series. Historical population records are available through get_country_population_history. You can fork this API on Parse and revise it to add a historical economic time-series endpoint.Can I filter quality-of-life results to a specific region or continent?+
get_quality_of_life returns all countries at once without a region filter parameter. Regional groupings are available via get_countries_by_region, but that endpoint covers sub-region demographics rather than quality-of-life scores. You can fork this API on Parse and revise it to add a region-filtered quality-of-life endpoint.