Search FRED series

Full-text search across 800,000+ FRED economic series. Returns series metadata including series_id, title, frequency, units and popularity.

Fetch a result with GET /api/v1/fred/series/{series_id}, which accepts any series_id in the FRED catalogue. The /macro/{country}/{section} route is a different thing: it serves about 450 curated series and takes a section name, not a series_id, so it cannot fetch an arbitrary search result.

TITLES ARE NOT UNIQUE - read units before choosing. 'Real Residential Property Prices for France' is the title of BOTH QFRR628BIS (Index 2010=100, the price level) and QFRR368BIS (Percent per Annum, the growth rate). Picking by title alone returns the wrong one about half the time, and the response looks entirely valid either way. popularity is a reasonable tiebreak, not a guarantee.

Responses

🟢200OK

application/json

FRED economic series matching the query, each with series_id, title, frequency, units, popularity and whether it is in the curated catalog. Fetch any of them by series_id from /api/v1/fred/series/{series_id}.

Bodyapplication/json

Example

{
    "data": {
        "query": "string",
        "total": 0,
        "returned": 0,
        "offset": 0,
        "series": [
            {
                "series_id": "string",
                "title": "string",
                "frequency": "string",
                "units": "string",
                "seasonal_adjustment": "string",
                "popularity": 0,
                "observation_start": "string",
                "observation_end": "string",
                "last_updated": "string",
                "in_catalog": true
            }
        ],
        "source": "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",
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable

Search FRED series

Request

Request Code Samples

Responses