Fetch a FRED category by its id (0 is the root of the category tree): its name and parent category id.

List the child categories of a FRED category (use id 0 for the top-level categories). The primary way to walk the category tree downward.

List the categories related to a FRED category — cross-links to sibling topics elsewhere in the tree, distinct from its parent/child hierarchy. Often empty.

Given seed tags, list the tags that co-occur with all of them within a FRED category — refine a category browse by discovering adjacent tags. Optionally filter by search text; supports sort direction and a result limit.

List the FRED series that belong to a category, with pagination metadata (total count, offset, limit). Supports ordering, sort direction, and a result limit.

List the tags used by the series in a FRED category (the tag facets for browsing a category), with pagination metadata. Optionally filter by search text; supports sort direction and a result limit.

Fetch a FRED series' observations (date/value pairs, each with its ALFRED real-time period). Supports an optional date range, a units transform, aggregation to a lower frequency, sort order, and a result limit. For point-in-time/vintage (ALFRED) data, set realtime_start/realtime_end (both together; same date = the series as known on that day) and/or vintage_dates.

GeoFRED / Maps: fetch a region cross-section for a series group — the value in every region (state, county, MSA, country, or BEA region) on a given date. All arguments are required: series_group id, region_type, date, units (a free-text measurement label FRED echoes into the title, e.g. Dollars), frequency, and season. The result nests everything under a top-level meta object (FRED's own envelope, mirrored faithfully): the dated per-region values live under meta.data, which maps each observation date to a list of {region, code, value, series_id}; alongside them sit the display labels meta.title, meta.units, meta.region, meta.seasonality, and meta.frequency (see the output schema for the full shape). Size caveat: FRED returns the full cross-section with no limit or paging, so region_type county or msa yields thousands of regions (a county cross-section can exceed 250,000 characters) — prefer state, bea, or country unless you need that granularity.

Given a set of seed tags, list the tags that co-occur with all of them — use it to discover adjacent tags and refine a faceted search. Optionally filter by search text. Returns tags with pagination metadata.

Fetch a FRED data release by its id (e.g. 53 = Gross Domestic Product): its name, press-release flag, and link.

List the publication dates of ONE FRED release (its calendar), with pagination metadata. Oldest first by default; supports sort direction, a result limit, and including dates that have no data yet (e.g. scheduled future releases).

Given seed tags, list the tags that co-occur with all of them within a FRED release. Optionally filter by search text; supports sort direction and a result limit.

List the FRED series published in a release, with pagination metadata (total count, offset, limit). Supports ordering, sort direction, and a result limit.

List the FRED data sources a release draws from (the reverse of get_source_releases). Returns the full unpaginated list wrapped as {count, sources}.

Fetch a FRED release's table tree — the nested layout (sections, tables, and the series rows beneath them) it uses to present its series. Optionally scope to the subtree rooted at one element id, and optionally fold each series row's observation value (at observation_date, or FRED's latest) into the tree via include_observation_values. Returns the tree as structured JSON, with each element's children nested under it. Note: element_id takes precedence over release_id — FRED resolves the element by its own id, so an element from another release yields that release's subtree. Note: each returned row's observation_date is FRED's display label (e.g. "Jun 2026"), not an ISO YYYY-MM-DD date like the inputs — it is not round-trippable back into any date parameter.

List the tags used by the series in a FRED release (the tag facets for browsing a release), with pagination metadata. Optionally filter by search text; supports sort direction and a result limit.

List FRED data releases (publications such as "Gross Domestic Product"), with pagination metadata. A browse axis parallel to categories. Supports sort direction and a result limit.

List the publication dates of ALL FRED releases — a release calendar across FRED — with pagination metadata. Each entry names its release. Newest first by default; supports sort direction, a result limit, and including dates that have no data yet.

Fetch metadata for a FRED series by its id (e.g. GNPCA, UNRATE): title, frequency, seasonal adjustment, units, observation date range, and popularity.

List the categories a FRED series belongs to (the reverse of get_category_series): given a series id, where it sits in the category tree.

GeoFRED / Maps: fetch one regional series' values across regions, optionally over time. Give a regional series_id; with no date, FRED returns the most recent. Set date for a single date, or start_date for every date from then on. The result nests everything under a top-level meta object (FRED's own envelope, mirrored faithfully): the dated per-region values live under meta.data, which maps each observation date to a list of {region, code, value, series_id}; alongside them sit the display labels meta.title, meta.units, meta.region, meta.seasonality, and meta.frequency (see the output schema for the full shape).

GeoFRED / Maps: fetch the series-group metadata for a regional series — pass a regional series_id and get the group it belongs to (title, region type, units, frequency, and the span of dates it covers).

Fetch the release a FRED series belongs to (the reverse of get_release_series): given a series id, its publishing release.

Given seed tags, list the tags that co-occur with all of them among the series matching a full-text search. Optionally filter the tags by text; supports sort direction and a result limit.

List the tags on the series matching a full-text search (its tag facets, for narrowing the search down), with pagination metadata. Optionally filter the tags by text; supports sort direction and a result limit.

List the tags attached to a FRED series (the reverse of get_tags_series): given a series id, what keywords classify it.

List the FRED series updated most recently (a "what changed" feed, ordered by last-updated time), with pagination metadata. Optionally narrow to macro or regional series, or to a start_time/end_time update window (both required together, YYYY-MM-DDTHH:MM in FRED's timezone).

List a FRED series' vintage dates — the dates on which it was revised or newly released, i.e. how the series looked at each point in time. Supports sort direction and a result limit.

Fetch a FRED data source by its id (e.g. 18 = U.S. Bureau of Economic Analysis): its name and link.

List the releases produced by a FRED data source, with pagination metadata. Supports sort direction and a result limit.

List FRED data sources (the organizations that produce releases, e.g. the Bureau of Economic Analysis), with pagination metadata. Supports sort direction and a result limit.

Browse or search FRED's tag vocabulary (keywords such as "gdp", "quarterly", "nsa" used to classify series). Optionally filter by search text. Returns tags with their group, popularity, and series count.

List the FRED series carrying ALL of the given tags (faceted discovery), with pagination metadata. Supports ordering, sort direction, and a result limit.

Search FRED for series matching text. Returns the matching series along with pagination metadata (total match count, offset, limit).