Facet navigation over every FRED series
Narrow the ~800,000-series FRED catalogue by facets instead of guessing words. Eight facets: geo, source, frequency, seasonality, geo_type, concept, license, release. Call with no arguments for the top values of every facet; pass tags= (semicolon-joined, e.g. tags=bis;france) to see what remains after that selection; pass q= to facet a free-text search; pass BOTH to drill down inside the search - they compose. Every value carries the exact tag token - paste it straight into tags= here or on /api/v1/macro/series (carry the same q= there too), which returns the matching series themselves.
Query parameters
Current selection, semicolon- or comma-joined exact tag tokens (e.g. bis;france). Composes with q: together they drill down inside the search.
Current selection, semicolon- or comma-joined exact tag tokens (e.g. bis;france). Composes with q: together they drill down inside the search.
Free-text seed: facets of the series matching this search. Composes with tags.
Free-text seed: facets of the series matching this search. Composes with tags.
Return one facet only: geo, source, frequency, seasonality, geo_type, concept, license or release.
Return one facet only: geo, source, frequency, seasonality, geo_type, concept, license or release.
Values per facet.
Values per facet.
Response
Facet values with series counts, grouped by facet.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}