– Endpoints

Gis: TRADING ECONOMICS | GIS World Indicators

Mon, 01 Jan 0001 00:00:00 +0000

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.

Gis: TRADING ECONOMICS | GIS Markets

Mon, 01 Jan 0001 00:00:00 +0000

Live market quotes delivered as one feature per country — the most relevant instrument for each country in the collection. Covers three asset classes: currency exchange rates, stock market indexes, and government bond yields.

Currency Exchange Rates

FX exchange rates per country, anchored to a cross currency.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/market/currencies/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/market/currencies/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "USDJPY:JPN",
 "geometry": { "type": "Point", "coordinates": [138.25, 36.20] },
 "properties": {
 "iso3": "JPN",
 "country": "Japan",
 "fullName": "USDJPY",
 "group": "currency",
 "importance": 1,
 "lastValue": 154.32,
 "dailyChange": 0.45,
 "dailyChangePct": 0.29,
 "weeklyChange": 1.20,
 "weeklyChangePct": 0.78,
 "monthlyChange": 3.50,
 "monthlyChangePct": 2.32,
 "yearlyChange": 12.10,
 "yearlyChangePct": 8.51,
 "unit": "JPY",
 "lastUpdate": "2026-04-20T12:00:00Z"
 }
 }
]

Stock Market Indexes

Major stock market index per country.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/market/indexes/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/market/indexes/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "SPX:USA",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "iso3": "USA",
 "country": "United States",
 "fullName": "United States S&P 500",
 "group": "index",
 "importance": 1,
 "lastValue": 5218.19,
 "dailyChange": 23.45,
 "dailyChangePct": 0.45,
 "weeklyChange": 112.30,
 "weeklyChangePct": 2.20,
 "monthlyChange": -89.50,
 "monthlyChangePct": -1.69,
 "yearlyChange": 421.10,
 "yearlyChangePct": 8.78,
 "unit": "points",
 "lastUpdate": "2026-04-20T20:00:00Z"
 }
 }
]

Government Bond Yields

10-year government bond yields per country.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/market/bonds/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/market/bonds/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "USGG10YR:USA",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "iso3": "USA",
 "country": "United States",
 "fullName": "United States 10Y Bond Yield",
 "group": "bond",
 "importance": 1,
 "lastValue": 4.25,
 "dailyChange": -0.03,
 "dailyChangePct": -0.70,
 "weeklyChange": 0.12,
 "weeklyChangePct": 2.90,
 "monthlyChange": -0.15,
 "monthlyChangePct": -3.41,
 "yearlyChange": 0.75,
 "yearlyChangePct": 21.43,
 "unit": "percent",
 "lastUpdate": "2026-04-20T16:00:00Z"
 }
 }
]

Using Parameters

Filter currencies by cross currency and country.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/market/currencies/items?c={your_api_key}&cross=EUR&country=Japan'
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/market/currencies/items?c=${your_api_key}&cross=EUR&country=Japan`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "EURJPY:JPN",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "iso3": "JPN",
 "country": "Japan",
 "fullName": "EURJPY",
 "group": "currency",
 "importance": 1,
 "lastValue": 162.45,
 "dailyChange": 0.32,
 "dailyChangePct": 0.20,
 "weeklyChange": 1.10,
 "weeklyChangePct": 0.68,
 "monthlyChange": 2.85,
 "monthlyChangePct": 1.79,
 "yearlyChange": 9.20,
 "yearlyChangePct": 6.01,
 "unit": "JPY",
 "lastUpdate": "2026-04-20T12:00:00Z"
 }
 }
]

Response Properties

Property	Type	Description
`iso3`	string	ISO 3166-1 alpha-3 country code
`country`	string	Country name
`fullName`	string	Instrument full name
`group`	string	`currency`, `index`, or `bond`
`importance`	int	Importance ranking
`lastValue`	number	Latest price/yield
`dailyChange`	number	Absolute change today
`dailyChangePct`	number	Percentage change today
`weeklyChange`	number	Absolute change this week
`weeklyChangePct`	number	Percentage change this week
`monthlyChange`	number	Absolute change this month
`monthlyChangePct`	number	Percentage change this month
`yearlyChange`	number	Absolute change this year
`yearlyChangePct`	number	Percentage change this year
`unit`	string	Currency/unit label
`lastUpdate`	string	ISO 8601 timestamp of last update

Available Collections

Collection	Endpoint	Description
`currencies`	`market/currencies`	FX exchange rates anchored to each country, relative to a cross currency
`indexes`	`market/indexes`	Major stock market index per country
`bonds`	`market/bonds`	10-year government bond yields per country

More market collections are being added continuously.

Gis: TRADING ECONOMICS | GIS FRED

Mon, 01 Jan 0001 00:00:00 +0000

Federal Reserve Economic Data (FRED), maintained by the Federal Reserve Bank of St. Louis, aggregates hundreds of thousands of US economic time series from federal, state, and private agencies. Features are anchored to official US Census boundaries at both the state and county level.

All Indicators — All States

Returns all FRED indicators for all US states.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/states/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/fred/states/indicators/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-CA",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "state": "California",
 "fips": "06",
 "gdp": 3598103,
 "gdp_date": "2023-12-31",
 "gdp_unit": "USD Million",
 "population": 39538223,
 "population_date": "2023-12-31",
 "population_unit": "Persons",
 "homeownership_rate": 55.5,
 "homeownership_rate_date": "2023-12-31",
 "homeownership_rate_unit": "percent"
 }
 }
]

Single Indicator — All States

Returns a single indicator across all US states.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/states/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/fred/states/indicators/gdp/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-TX",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "state": "Texas",
 "fips": "48",
 "gdp": 2355960,
 "gdp_date": "2023-12-31",
 "gdp_unit": "USD Million"
 }
 },

 {
 "type": "Feature",
 "id": "US-AL",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "state": "Alabama",
 "fips": "48",
 "gdp": 2355960,
 "gdp_date": "2023-12-31",
 "gdp_unit": "USD Million"
 }
 }
]

All Indicators — Single State

Returns all indicators for a specific state.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/states/california/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/fred/states/california/indicators/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-CA",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "state": "California",
 "fips": "06",
 "gdp": 3598103,
 "gdp_date": "2023-12-31",
 "gdp_unit": "USD Million",
 "population": 39538223,
 "population_date": "2023-12-31",
 "population_unit": "Persons",
 "homeownership_rate": 55.5,
 "homeownership_rate_date": "2023-12-31",
 "homeownership_rate_unit": "percent",
 "poverty": 11.6,
 "poverty_date": "2023-12-31",
 "poverty_unit": "percent"
 }
 }
]

Using Parameters

Filter by specific states and indicator.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/states/indicators/items?c={your_api_key}&states=california,texas&indicator=gdp'
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/fred/states/indicators/items?c=${your_api_key}&states=california,texas&indicator=gdp`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-CA",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "state": "California",
 "fips": "06",
 "gdp": 3598103,
 "gdp_date": "2023-12-31",
 "gdp_unit": "USD Million"
 }
 },
 {
 "type": "Feature",
 "id": "US-TX",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "state": "Texas",
 "fips": "48",
 "gdp": 2355960,
 "gdp_date": "2023-12-31",
 "gdp_unit": "USD Million"
 }
 }
]

All Indicators — All Counties

Returns all FRED indicators for all US counties.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/counties/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/fred/counties/indicators/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-06037",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "county": "Los Angeles County",
 "state": "California",
 "fips": "06037",
 "population": 10014009,
 "population_date": "2023-12-31",
 "population_unit": "Persons",
 "unemployment_rate": 4.8,
 "unemployment_rate_date": "2024-01-31",
 "unemployment_rate_unit": "percent",
 "homeownership_rate": 47.2,
 "homeownership_rate_date": "2023-12-31",
 "homeownership_rate_unit": "percent",
 "private_establishments": 248731,
 "private_establishments_date": "2023-12-31",
 "private_establishments_unit": "establishments",
 "poverty_all_ages": 16.3,
 "poverty_all_ages_date": "2023-12-31",
 "poverty_all_ages_unit": "percent",
 "premature_death_rate": 312.4,
 "premature_death_rate_date": "2023-12-31",
 "premature_death_rate_unit": "per 100,000"
 }
 }
]

Single Indicator — All Counties

Returns a single indicator across all US counties.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/counties/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/fred/counties/indicators/gdp/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-06037",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "county": "Los Angeles County",
 "state": "California",
 "fips": "06037",
 "unemployment_rate": 4.8,
 "unemployment_rate_date": "2024-01-31",
 "unemployment_rate_unit": "percent"
 }
 }
]

All Indicators — Single State’s Counties

Returns all indicators for all counties within a specific state.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/counties/california/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/fred/counties/california/indicators/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-06037",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "county": "Los Angeles County",
 "state": "California",
 "fips": "06037",
 "population": 10014009,
 "population_date": "2023-12-31",
 "population_unit": "Persons",
 "unemployment_rate": 4.8,
 "unemployment_rate_date": "2024-01-31",
 "unemployment_rate_unit": "percent",
 "homeownership_rate": 47.2,
 "homeownership_rate_date": "2023-12-31",
 "homeownership_rate_unit": "percent",
 "private_establishments": 248731,
 "private_establishments_date": "2023-12-31",
 "private_establishments_unit": "establishments",
 "poverty_all_ages": 16.3,
 "poverty_all_ages_date": "2023-12-31",
 "poverty_all_ages_unit": "percent",
 "premature_death_rate": 312.4,
 "premature_death_rate_date": "2023-12-31",
 "premature_death_rate_unit": "per 100,000"
 }
 }
]

Using Parameters

Filter by state and indicator — returns a specific indicator for all counties in a single state.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/fred/counties/indicators/items?c={your_api_key}&indicator=unemployment-rate&states=florida'
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/fred/counties/indicators/items?c=${your_api_key}&indicator=unemployment-rate&states=florida`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "US-12086",
 "geometry": { "type": "Polygon", "coordinates": [ ... ] },
 "properties": {
 "county": "Miami-Dade County",
 "state": "Florida",
 "fips": "12086",
 "unemployment_rate": 3.9,
 "unemployment_rate_date": "2024-01-31",
 "unemployment_rate_unit": "percent"
 }
 }
]

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 FRED Indicators

Indicator	Symbol Pattern	Description
`population`	`POP`	Resident Population by US County
`unemployment-rate`	`URN`	Unemployment Rate by US County
`homeownership-rate`	`HOWNRATE`	Homeownership Rate (5-year estimate) by US County
`private-establishments`	`ENU`	Number of Private Establishments for All Industries by US County
`poverty-all-ages`	`PUAAA`	Poverty Universe, All Ages by US County
`premature-death-rate`	`CDC20N2U`	Premature Death Rate by US County

More county-level indicators are being added continuously.

Gis: TRADING ECONOMICS | GIS COMTRADE

Mon, 01 Jan 0001 00:00:00 +0000

UN Comtrade bilateral trade data returned as LineString geometry — each feature connects an origin country’s centroid to its trading partner, covering over 200 reporting countries since 1962. Line thickness can be scaled by trade value for visual impact.

Export Flows

Trade exports from a specific country to all trading partners.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/comtrade/exports/china/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/comtrade/exports/china/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "CHN_USA_2023_export",
 "geometry": {
 "type": "LineString",
 "coordinates": [ [116.40, 39.90], [-77.03, 38.89] ]
 },
 "properties": {
 "origin_country": "China",
 "origin_iso3": "CHN",
 "destination_country": "United States",
 "destination_iso3": "USA",
 "trade_value": 500000000000,
 "year": 2023,
 "trade_type": "export",
 "category": "Total",
 "last_update": "2024-03-15",
 "importance": 1
 }
 }
]

Import Flows

Trade imports into a specific country from all trading partners.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/comtrade/imports/germany/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/comtrade/imports/germany/items?c=${your_api_key}`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "DEU_CHN_2023_import",
 "geometry": {
 "type": "LineString",
 "coordinates": [ [10.45, 51.16], [116.40, 39.90] ]
 },
 "properties": {
 "origin_country": "China",
 "origin_iso3": "CHN",
 "destination_country": "Germany",
 "destination_iso3": "DEU",
 "trade_value": 109000000000,
 "year": 2023,
 "trade_type": "import",
 "category": "Total",
 "last_update": "2024-03-15",
 "importance": 1
 }
 }
]

Using Parameters

Filter by partner countries and year range.

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/gis/collections/comtrade/exports/china/items?c={your_api_key}&partners=France,Italy,United States&yearFrom=2020&yearTo=2025'
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/comtrade/exports/china/items?c=${your_api_key}&partners=France,Italy,United States&yearFrom=2020&yearTo=2025`)
 console.log(response.data)
})()

Response

[
 {
 "type": "Feature",
 "id": "CHN_FRA_2022_export",
 "geometry": {
 "type": "LineString",
 "coordinates": [ [116.40, 39.90], [2.35, 48.86] ]
 },
 "properties": {
 "origin_country": "China",
 "origin_iso3": "CHN",
 "destination_country": "France",
 "destination_iso3": "FRA",
 "trade_value": 72000000000,
 "year": 2022,
 "trade_type": "export",
 "category": "Total",
 "last_update": "2024-03-15",
 "importance": 3
 }
 }
]

Response Properties

Property	Type	Description
`origin_country`	string	Exporting country name
`origin_iso3`	string	Exporting country ISO3 code
`destination_country`	string	Importing country name
`destination_iso3`	string	Importing country ISO3 code
`trade_value`	number	Trade value in USD
`year`	int	Data year
`trade_type`	string	`export` or `import`
`category`	string	Trade category (e.g. `Total`)
`last_update`	string	Last data update date
`importance`	int	Trade partner ranking