TRADING ECONOMICS | GIS World Indicators

Covers 196 countries with historical series and forecasts for more than 20 million economic indicators. A single request returns the latest value for every country, with each feature carrying the value, date, unit, frequency, previous period, and source.

All Indicators — All Countries

Returns a snapshot of important indicators for many countries.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/indicators/items?c={your_api_key}'
data = requests.get(url).json()
print(data)

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/gis/collections/indicators/items?c=${your_api_key}`)
    console.log(response.data)
})()

Response

[
  {
    "type": "Feature",
    "id": "USA",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "USA",
      "country": "United States",
      "gdp": 25462700,
      "gdp_date": "2023-12-31",
      "gdp_unit": "USD Million",
      "gdp_frequency": "Yearly",
      "gdp_previous_value": 23315081,
      "gdp_previous_date": "2022-12-31",
      "gdp_source": "World Bank",
      "population": 331900000,
      "population_date": "2023-12-31",
      "population_unit": "Million",
      "population_frequency": "Yearly",
      "population_previous_value": 329500000,
      "population_previous_date": "2022-12-31",
      "population_source": "World Bank",
      "interest_rate": 5.5,
      "interest_rate_date": "2024-01-31",
      "interest_rate_unit": "percent",
      "interest_rate_frequency": "Daily",
      "interest_rate_previous_value": 5.25,
      "interest_rate_previous_date": "2023-12-31",
      "interest_rate_source": "Federal Reserve",
      "inflation_rate": 3.4,
      "inflation_rate_date": "2024-01-31",
      "inflation_rate_unit": "percent",
      "inflation_rate_frequency": "Monthly",
      "inflation_rate_previous_value": 3.1,
      "inflation_rate_previous_date": "2023-12-31",
      "inflation_rate_source": "Bureau of Labor Statistics",
      "unemployment_rate": 3.7,
      "unemployment_rate_date": "2024-01-31",
      "unemployment_rate_unit": "percent",
      "unemployment_rate_frequency": "Monthly",
      "unemployment_rate_previous_value": 3.8,
      "unemployment_rate_previous_date": "2023-12-31",
      "unemployment_rate_source": "Bureau of Labor Statistics",
      "gdp_growth_rate": 3.3,
      "gdp_growth_rate_date": "2023-12-31",
      "gdp_growth_rate_unit": "percent",
      "gdp_growth_rate_frequency": "Quarterly",
      "gdp_growth_rate_previous_value": 4.9,
      "gdp_growth_rate_previous_date": "2023-09-30",
      "gdp_growth_rate_source": "Bureau of Economic Analysis",
      "government_debt_to_gdp": 129.0,
      "government_debt_to_gdp_date": "2023-12-31",
      "government_debt_to_gdp_unit": "percent of GDP",
      "government_debt_to_gdp_frequency": "Yearly",
      "government_debt_to_gdp_previous_value": 121.7,
      "government_debt_to_gdp_previous_date": "2022-12-31",
      "government_debt_to_gdp_source": "World Bank"
    }
  }
]

Single Indicator

Returns data for a single indicator for all countries.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/indicators/gdp/items?c={your_api_key}'
data = requests.get(url).json()
print(data)

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/gis/collections/indicators/gdp/items?c=${your_api_key}`)
    console.log(response.data)
})()

Response

[
  {
    "type": "Feature",
    "id": "CHN",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "CHN",
      "country": "China",
      "gdp": 17963171,
      "gdp_date": "2023-12-31",
      "gdp_unit": "USD Million",
      "gdp_frequency": "Yearly",
      "gdp_previous_value": 17886334,
      "gdp_previous_date": "2022-12-31",
      "gdp_source": "World Bank"
    }
  },

  {
    "type": "Feature",
    "id": "USA",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "USA",
      "country": "United States of America",
      "gdp": 17963171,
      "gdp_date": "2023-12-31",
      "gdp_unit": "USD Million",
      "gdp_frequency": "Yearly",
      "gdp_previous_value": 17886334,
      "gdp_previous_date": "2022-12-31",
      "gdp_source": "World Bank"
    }
  }
]

Indicator Using Parameters

Returns data for one or more indicators across multiple countries.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/indicators/items?c={your_api_key}&countries=mexico,sweden&indicators=gdp,population'
data = requests.get(url).json()
print(data)

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/gis/collections/indicators/items?c=${your_api_key}&countries=mexico,sweden&indicators=gdp,population`)
    console.log(response.data)
})()

Response

[
  {
    "type": "Feature",
    "id": "CHN",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "CHN",
      "country": "China",
      "gdp": 17963171,
      "gdp_date": "2023-12-31",
      "gdp_unit": "USD Million",
      "gdp_frequency": "Yearly",
      "gdp_previous_value": 17886334,
      "gdp_previous_date": "2022-12-31",
      "gdp_source": "World Bank",
      "population": 1412175000,
      "population_date": "2023-12-31",
      "population_unit": "Million",
      "population_frequency": "Yearly",
      "population_previous_value": 1411750000,
      "population_previous_date": "2022-12-31",
      "population_source": "World Bank"
    }
  },

  {
    "type": "Feature",
    "id": "PRT",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "PRT",
      "country": "Portugal",
      "gdp": 17963171,
      "gdp_date": "2023-12-31",
      "gdp_unit": "USD Million",
      "gdp_frequency": "Yearly",
      "gdp_previous_value": 17886334,
      "gdp_previous_date": "2022-12-31",
      "gdp_source": "World Bank",
      "population": 1412175000,
      "population_date": "2023-12-31",
      "population_unit": "Million",
      "population_frequency": "Yearly",
      "population_previous_value": 1411750000,
      "population_previous_date": "2022-12-31",
      "population_source": "World Bank"
    }
  }
]

Historical Indicators

Append yearFrom and yearTo to get one feature per country per year — ideal for temporal animation in QGIS.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/indicators/population/items?yearFrom=2020&yearTo=2025&c={your_api_key}'
data = requests.get(url).json()
print(data)

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/gis/collections/indicators/population/items?yearFrom=2020&yearTo=2025&c=${your_api_key}`)
    console.log(response.data)
})()

Response

[
  {
    "type": "Feature",
    "id": "USA_2020",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "USA",
      "country": "United States",
      "date": "2020-12-31",
      "population": 331500000,
      "population_unit": "Million",
      "population_source": "World Bank"
    }
  },
  {
    "type": "Feature",
    "id": "USA_2021",
    "geometry": { "type": "Polygon", "coordinates": [ ... ] },
    "properties": {
      "iso3": "USA",
      "country": "United States",
      "date": "2021-12-31",
      "population": 331900000,
      "population_unit": "Million",
      "population_source": "World Bank"
    }
  }
]

Response Properties

Each indicator value on a feature follows this naming pattern:

Property	Description	Example
`{slug}`	Latest value	`gdp`: `25462700`
`{slug}_date`	Date of latest value	`gdp_date`: `"2023-12-31"`
`{slug}_unit`	Unit of measurement	`gdp_unit`: `"USD Million"`
`{slug}_frequency`	Data frequency	`gdp_frequency`: `"Yearly"`
`{slug}_previous_value`	Previous period value	`gdp_previous_value`: `23315081`
`{slug}_previous_date`	Previous period date	`gdp_previous_date`: `"2022-12-31"`
`{slug}_source`	Data source	`gdp_source`: `"World Bank"`

Slug is lowercase with hyphens converted to underscores (e.g. interest-rate → interest_rate).

Available Indicators

Indicator	API Path	Description
`gdp`	`gdp`	Gross domestic product
`population`	`population`	Total population
`interest-rate`	`interest rate`	Central bank benchmark interest rates
`inflation-rate`	`inflation rate`	Consumer price inflation rates
`unemployment-rate`	`unemployment rate`	Labor force unemployment rates
`gdp-growth-rate`	`gdp growth rate`	Gross domestic product annual growth rates
`government-debt-to-gdp`	`government debt to gdp`	Government debt as percentage of GDP

More indicators are being added continuously.