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.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Facet values with series counts, grouped by facet.

Bodyapplication/json

Example

{
    "data": {
        "facets": {
            "property1": [
                {
                    "tag": "string",
                    "series_count": 0,
                    "property1": "string",
                    "property2": "string"
                }
            ],
            "property2": [
                {
                    "tag": "string",
                    "series_count": 0,
                    "property1": "string",
                    "property2": "string"
                }
            ]
        },
        "selected": [
            "string"
        ],
        "q": "string",
        "series_count": 0,
        "facet_values_truncated": true,
        "source": "string",
        "fetched_at": "string",
        "property1": "string",
        "property2": "string"
    },
    "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",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable