Macroeconomic Indicators API: GDP, Inflation & Demographics by Country

The EODHD Macro Indicators API exposes 39 macroeconomic time series per country — GDP, inflation, unemployment, demographics, trade balances, debt ratios and more. Data is sourced from the World Bank World Development Indicators (WDI) and refreshed annually as the World Bank publishes new vintages. Most series start in 1960; the latest available year is typically the previous calendar year.

API Endpoint

https://eodhd.com/api/macro-indicator/{country}

Path Parameter

Query Parameters

Available Indicators

39 indicators are exposed. The Status column reflects how regularly the underlying World Bank series is updated and whether the data is suitable for current analysis. See Known Limitations for the indicators flagged as data issue or historical.

National Accounts and Growth

Prices and Inflation

Trade and External Sector

Government Finance and Debt

Population and Demographics

Labour, Poverty and Income

Financial Markets and Business Environment

Environment and Geography

Country Codes

The country path parameter accepts ISO 3166-1 alpha-3 codes — three letters, case-insensitive. Common examples: USA (United States), FRA (France), DEU (Germany), GBR (United Kingdom), JPN (Japan), CHN (China), IND (India), BRA (Brazil).

The endpoint also accepts World Bank aggregate codes, which return aggregated regional or income-group data. The most useful aggregates:

The full list of World Bank country and aggregate codes is published at api.worldbank.org/v2/country.

Request Example

https://eodhd.com/api/macro-indicator/FRA?indicator=inflation_consumer_prices_annual&api_token=YOUR_TOKEN&fmt=json

curl --location "https://eodhd.com/api/macro-indicator/FRA?indicator=inflation_consumer_prices_annual&api_token=YOUR_TOKEN&fmt=json"

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/macro-indicator/FRA?indicator=inflation_consumer_prices_annual&api_token=YOUR_TOKEN&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

import requests

url = f'https://eodhd.com/api/macro-indicator/FRA?indicator=inflation_consumer_prices_annual&api_token=YOUR_TOKEN&fmt=json'
data = requests.get(url).json()

print(data)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/macro-indicator/FRA?indicator=inflation_consumer_prices_annual&api_token=YOUR_TOKEN&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

Response Format

The response is a JSON array of observations, one per year, ordered from newest to oldest. Each observation has the same shape regardless of the requested indicator:

[
  {
    "CountryCode": "FRA",
    "CountryName": "France",
    "Indicator": "Inflation, consumer prices (annual %)",
    "Date": "2024-12-31",
    "Period": "Annual",
    "Value": 1.999
  },
  {
    "CountryCode": "FRA",
    "CountryName": "France",
    "Indicator": "Inflation, consumer prices (annual %)",
    "Date": "2023-12-31",
    "Period": "Annual",
    "Value": 4.9296
  }
]

An empty array [] is returned when the country code is recognised but no observations exist for the requested indicator. The same empty-array response is also returned when the country code is unknown — check that the country actually has data before treating an empty array as “no observations”.

Response Codes

Known Limitations

• Annual frequency only. All series are published at annual cadence. For quarterly or monthly macro releases (GDP nowcasts, CPI flash, central bank decisions), use the Economic Events Data API instead.
• Refresh cadence depends on the source. The World Bank publishes WDI updates on an annual cycle, typically several months after the reference year ends. Expect the latest year to be one to two years behind the current calendar year for most series.
• Country coverage is uneven across indicators. Several indicators are only collected for certain country groups: total_debt_service_percent_gni applies to IBRD/IDA borrowers; prevalence_hiv_total is empty for the US and some high-income countries; debt_percent_gdp coverage depends on whether the country reports to the IMF GFS database.
• Historical-only indicators. startup_procedures_register, cash_surplus_deficit_percent_gdp and internet_users_per_hundred are exposed for backward compatibility but the underlying World Bank series stopped updating in 2019, 2014 and 2015 respectively. The Doing Business programme was discontinued by the World Bank in 2021.
• Data quality flags. Three indicators currently return values that appear out of expected range: co2_emissions_tons_per_capita, internet_users_per_hundred and cash_surplus_deficit_percent_gdp. Treat these as unverified until the data feed is reviewed. Other indicators have been spot-checked against the World Bank WDI portal and match.
• Unknown country codes return an empty array, not a 404. A request with an unrecognised country code (e.g. a two-letter ISO code, or a typo) returns HTTP 200 with an empty JSON array, identical to the response for a recognised country with no data. Validate the country code before issuing the request.
• CSV output truncates decimals. The fmt=csv option emits integer-only values for the Value column. Use fmt=json (the default) if you need full precision.

Sign up & Get Data