TRADING ECONOMICS | GIS FRED

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.