curl --request GET \
--url https://gdeltcloud.com/api/v2/macro/releases \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/macro/releases"
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/releases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"source_agency": "BLS",
"display_agency": "BLS",
"release_name": "Employment Situation",
"series": 9,
"top_popularity": 88
},
{
"source_agency": "FRB",
"display_agency": "FRB",
"release_name": "H.15 Selected Interest Rates",
"series": 7,
"top_popularity": 91
}
],
"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 releases
Rollup of the catalog by source agency and release, with series counts. 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/releases \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/macro/releases"
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/releases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"source_agency": "BLS",
"display_agency": "BLS",
"release_name": "Employment Situation",
"series": 9,
"top_popularity": 88
},
{
"source_agency": "FRB",
"display_agency": "FRB",
"release_name": "H.15 Selected Interest Rates",
"series": 7,
"top_popularity": 91
}
],
"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 substring match against the release name OR its (read-time-filled) source agency.
Source agency filter, matched case-insensitively against the read-time-filled agency (so blank-agency releases are still reachable). Validated against the same allowlist as /api/v2/macro/series — an unknown value returns 400 INVALID_ENUM with details.accepted_values. 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 Rows per page (1–200). Defaults to 50.
1 <= x <= 200Pagination cursor (opaque offset) from a prior response's pagination.next_cursor. offset is accepted as an alias.

