Federal Reserve Economic Data

Terms of Use

fred/related_tags



Description

Get the related FRED tags for one or more FRED tags. Optionally, filter results by tag group or search.

FRED tags are attributes assigned to series. Related FRED tags are the tags assigned to series that match all tags in the tag_names parameter and no tags in the exclude_tag_names parameter. See the related request fred/tags.

Examples

This request can return either XML or JSON by setting the file_type parameter to xml or json. Note that the default value of file_type is xml. The API key 'abcdefghijklmnopqrstuvwxyz123456' is for demonstration purposes only. Use a registered API key instead.

XML

Request (HTTPS GET)

https://api.stlouisfed.org/fred/related_tags?tag_names=monetary+aggregates;weekly&api_key=abcdefghijklmnopqrstuvwxyz123456

Response


<tags realtime_start="2013-08-14" realtime_end="2013-08-14" order_by="series_count" sort_order="desc" count="13" offset="0" limit="1000">
    <tag name="nation" group_id="geot" notes="Country Level" created="2012-02-27 10:18:19-06" popularity="100" series_count="12"/>
    <tag name="usa" group_id="geo" notes="United States of America" created="2012-02-27 10:18:19-06" popularity="100" series_count="12"/>
    <tag name="frb" group_id="src" notes="Board of Governors of the Federal Reserve System" created="2012-02-27 10:18:19-06" popularity="90" series_count="10"/>
    <tag name="nsa" group_id="seas" notes="Not seasonally adjusted" created="2012-02-27 10:18:19-06" popularity="96" series_count="6"/>
    <tag name="sa" group_id="seas" notes="Seasonally adjusted" created="2012-02-27 10:18:19-06" popularity="94" series_count="6"/>
    <tag name="m1" group_id="gen" notes="M1 Money Stock" created="2012-02-27 10:18:19-06" popularity="71" series_count="4"/>
    <tag name="m2" group_id="gen" notes="M2 Money Stock" created="2012-02-27 10:18:19-06" popularity="75" series_count="4"/>
    <tag name="currency" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="74" series_count="2"/>
    <tag name="discontinued" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="68" series_count="2"/>
    <tag name="frb stl" group_id="src" notes="Federal Reserve Bank of St. Louis (source)" created="2012-02-27 10:18:19-06" popularity="81" series_count="2"/>
    <tag name="h6" group_id="rls" notes="H.6 Money Stock Measures" created="2012-08-16 15:21:17-05" popularity="41" series_count="2"/>
    <tag name="m3" group_id="gen" notes="M3 Money Stock" created="2012-02-27 10:18:19-06" popularity="50" series_count="2"/>
    <tag name="mzm" group_id="gen" notes="MZM Money Stock" created="2012-02-27 10:18:19-06" popularity="61" series_count="2"/>
</tags>

JSON

Request (HTTPS GET)

https://api.stlouisfed.org/fred/related_tags?tag_names=monetary+aggregates;weekly&api_key=abcdefghijklmnopqrstuvwxyz123456&file_type=json

Response


{
    "realtime_start": "2013-08-14",
    "realtime_end": "2013-08-14",
    "order_by": "series_count",
    "sort_order": "desc",
    "count": 13,
    "offset": 0,
    "limit": 1000,
    "tags": [
        {
            "name": "nation",
            "group_id": "geot",
            "notes": "Country Level",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 100,
            "series_count": 12
        },
        {
            "name": "usa",
            "group_id": "geo",
            "notes": "United States of America",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 100,
            "series_count": 12
        },
        {
            "name": "frb",
            "group_id": "src",
            "notes": "Board of Governors of the Federal Reserve System",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 90,
            "series_count": 10
        },
        {
            "name": "nsa",
            "group_id": "seas",
            "notes": "Not seasonally adjusted",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 96,
            "series_count": 6
        },
        {
            "name": "sa",
            "group_id": "seas",
            "notes": "Seasonally adjusted",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 94,
            "series_count": 6
        },
        {
            "name": "m1",
            "group_id": "gen",
            "notes": "M1 Money Stock",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 71,
            "series_count": 4
        },
        {
            "name": "m2",
            "group_id": "gen",
            "notes": "M2 Money Stock",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 75,
            "series_count": 4
        },
        {
            "name": "currency",
            "group_id": "gen",
            "notes": "",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 74,
            "series_count": 2
        },
        {
            "name": "discontinued",
            "group_id": "gen",
            "notes": "",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 68,
            "series_count": 2
        },
        {
            "name": "frb stl",
            "group_id": "src",
            "notes": "Federal Reserve Bank of St. Louis (source)",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 81,
            "series_count": 2
        },
        {
            "name": "h6",
            "group_id": "rls",
            "notes": "H.6 Money Stock Measures",
            "created": "2012-08-16 15:21:17-05",
            "popularity": 41,
            "series_count": 2
        },
        {
            "name": "m3",
            "group_id": "gen",
            "notes": "M3 Money Stock",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 50,
            "series_count": 2
        },
        {
            "name": "mzm",
            "group_id": "gen",
            "notes": "MZM Money Stock",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 61,
            "series_count": 2
        }
    ]
}

Parameters

api_key

Read API Keys for more information.

file_type

A key or file extension that indicates the type of file to send.

realtime_start

The start of the real-time period. For more information, see Real-Time Periods.

realtime_end

The end of the real-time period. For more information, see Real-Time Periods.

tag_names

A semicolon delimited list of tag names that series match all of. See the related request fred/tags.

exclude_tag_names

A semicolon delimited list of tag names that series match none of.

tag_group_id

A tag group id to filter tags by type.

search_text

The words to find matching tags with.

limit

The maximum number of results to return.

offset

order_by

Order results by values of the specified attribute.

sort_order

Sort results is ascending or descending order for attribute values specified by order_by.


Back to Top