Federal Reserve Economic Data: Your trusted data source since 1991

API Keys | Terms of Use



Get the FRED tags for a series.


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.


Request (HTTPS GET)



<tags realtime_start="2013-08-14" realtime_end="2013-08-14" order_by="series_count" sort_order="desc" count="8" 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="105200"/>
<tag name="nsa" group_id="seas" notes="Not seasonally adjusted" created="2012-02-27 10:18:19-06" popularity="96" series_count="100468"/>
<tag name="usa" group_id="geo" notes="United States of America" created="2012-02-27 10:18:19-06" popularity="100" series_count="59469"/>
<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="4329"/>
<tag name="financial" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="70" series_count="2134"/>
<tag name="weekly" group_id="freq" notes="" created="2012-02-27 10:18:19-06" popularity="82" series_count="2013"/>
<tag name="indexes" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="79" series_count="1567"/>
<tag name="stlfsi" group_id="rls" notes="St. Louis Financial Stress Index" created="2012-08-16 15:21:17-05" popularity="66" series_count="1"/>


Request (HTTPS GET)



    "realtime_start": "2013-08-14",
    "realtime_end": "2013-08-14",
    "order_by": "series_count",
    "sort_order": "desc",
    "count": 8,
    "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": 105200
            "name": "nsa",
            "group_id": "seas",
            "notes": "Not seasonally adjusted",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 96,
            "series_count": 100468
            "name": "usa",
            "group_id": "geo",
            "notes": "United States of America",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 100,
            "series_count": 59469
            "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": 4329
            "name": "financial",
            "group_id": "gen",
            "notes": "",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 70,
            "series_count": 2134
            "name": "weekly",
            "group_id": "freq",
            "notes": "",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 82,
            "series_count": 2013
            "name": "indexes",
            "group_id": "gen",
            "notes": "",
            "created": "2012-02-27 10:18:19-06",
            "popularity": 79,
            "series_count": 1567
            "name": "stlfsi",
            "group_id": "rls",
            "notes": "St. Louis Financial Stress Index",
            "created": "2012-08-16 15:21:17-05",
            "popularity": 66,
            "series_count": 1



Read API Keys for more information.

  • 32 character alpha-numeric lowercase string, required


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

  • string, optional, default: xml
  • One of the following values: 'xml', 'json'

    xml = Extensible Markup Language. The HTTP Content-Type is text/xml.
    json = JavaScript Object Notation. The HTTP Content-Type is application/json.


The id for a series.

  • string, required


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

  • YYYY-MM-DD formatted string, optional, default: today's date


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

  • YYYY-MM-DD formatted string, optional, default: today's date


Order results by values of the specified attribute.

  • One of the following strings: 'series_count', 'popularity', 'created', 'name', 'group_id'.
  • optional, default: series_count


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

  • One of the following strings: 'asc', 'desc'.
  • optional, default: asc

Subscribe to the FRED newsletter

Follow us

Back to Top