curl --request GET \
--url https://gdeltcloud.com/api/v2/macro/series \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/macro/series"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/macro/series', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"series_id": "DGS10",
"title": "Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis",
"frequency": "Daily",
"frequency_short": "D",
"units": "Percent",
"units_short": "%",
"seasonal_adjustment": "Not Seasonally Adjusted",
"observation_start": "1962-01-02",
"observation_end": "2026-06-26",
"source_agency": "FRB",
"release_name": "H.15 Selected Interest Rates",
"geo_country_iso3": "USA",
"compliance_status": "ok",
"popularity": 91
},
{
"series_id": "UNRATE",
"title": "Unemployment Rate",
"frequency": "Monthly",
"frequency_short": "M",
"units": "Percent",
"units_short": "%",
"seasonal_adjustment": "Seasonally Adjusted",
"observation_start": "1948-01-01",
"observation_end": "2026-05-01",
"source_agency": "BLS",
"release_name": "Employment Situation",
"geo_country_iso3": "USA",
"compliance_status": "ok",
"popularity": 88
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"ignored": {}
},
"meta": {
"attribution": "This product uses data from the Federal Reserve Bank of St. Louis (FRED) but is not endorsed or certified by it.",
"source": "Federal Reserve Bank of St. Louis (FRED)"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}List FRED series
List the FRED economic time-series catalog by title/ID search, agency, frequency, and seasonal adjustment. Call with no filters to enumerate the full curated catalog (ordered by popularity) — this is the way to discover a valid series_id. Quarantined (third-party copyrighted) series are never returned. Requires a plan with Macro & economic data access (can_use_macro) — see Pricing for the plans that include it.
curl --request GET \
--url https://gdeltcloud.com/api/v2/macro/series \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/macro/series"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/macro/series', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"series_id": "DGS10",
"title": "Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis",
"frequency": "Daily",
"frequency_short": "D",
"units": "Percent",
"units_short": "%",
"seasonal_adjustment": "Not Seasonally Adjusted",
"observation_start": "1962-01-02",
"observation_end": "2026-06-26",
"source_agency": "FRB",
"release_name": "H.15 Selected Interest Rates",
"geo_country_iso3": "USA",
"compliance_status": "ok",
"popularity": 91
},
{
"series_id": "UNRATE",
"title": "Unemployment Rate",
"frequency": "Monthly",
"frequency_short": "M",
"units": "Percent",
"units_short": "%",
"seasonal_adjustment": "Seasonally Adjusted",
"observation_start": "1948-01-01",
"observation_end": "2026-05-01",
"source_agency": "BLS",
"release_name": "Employment Situation",
"geo_country_iso3": "USA",
"compliance_status": "ok",
"popularity": 88
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"ignored": {}
},
"meta": {
"attribution": "This product uses data from the Federal Reserve Bank of St. Louis (FRED) but is not endorsed or certified by it.",
"source": "Federal Reserve Bank of St. Louis (FRED)"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Case-insensitive match against series title or series_id.
Exact source agency (e.g. BLS, BEA, FRB, EIA). See Taxonomy & Codes — Macro Finance. Full value list: https://docs.gdeltcloud.com/reference/enums#macro_agency
BEA, BLS, CBOE, Census, DOL, EIA, FHFA, FRB, Freddie Mac, Treasury, U. Michigan FRED frequency_short (D=Daily, W=Weekly, M=Monthly, Q=Quarterly, A=Annual). Case-insensitive; the word forms (Daily/Weekly/Monthly/Quarterly/Annual) are also accepted. Full value list: https://docs.gdeltcloud.com/reference/enums#macro_frequency
D, W, M, Q, A, Daily, Weekly, Monthly, Quarterly, Annual FRED seasonal-adjustment classification. Case-insensitive; an unknown value returns 400 INVALID_ENUM. Full value list: https://docs.gdeltcloud.com/reference/enums#macro_seasonal_adjustment
Not Seasonally Adjusted, Seasonally Adjusted, Seasonally Adjusted Annual Rate Rows per page (1–100).
1 <= x <= 100Pagination cursor (offset) from a prior response's next_cursor.
Response
A page of series, ordered by popularity. Each row: series_id, title, frequency, frequency_short, units, units_short, seasonal_adjustment, observation_start, observation_end, source_agency, release_name, geo_country_iso3, compliance_status, popularity. Includes a meta object carrying the FRED non-endorsement attribution and source.

