Get the related FRED tags for one or more FRED tags matching a series search. Optionally, filter results by tag group or tag search.
FRED tags are attributes assigned to series. For this request, related FRED tags are the tags assigned to series that match all tags in the tag_names parameter, no tags in the exclude_tag_names parameter, and the search words set by the series_search_text parameter. See the related request fred/series/search/tags.
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.
https://api.stlouisfed.org/fred/series/search/related_tags?series_search_text=mortgage+rate&tag_names=30-year;frb&api_key=abcdefghijklmnopqrstuvwxyz123456
<tags realtime_start="2013-08-14" realtime_end="2013-08-14" order_by="series_count" sort_order="desc" count="10" offset="0" limit="1000">
<tag name="conventional" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="63" series_count="3"/>
<tag name="h15" group_id="rls" notes="H.15 Selected Interest Rates" created="2012-08-16 15:21:17-05" popularity="84" series_count="3"/>
<tag name="interest rate" group_id="gen" notes="" created="2012-05-29 10:14:19-05" popularity="87" series_count="3"/>
<tag name="mortgage" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="68" series_count="3"/>
<tag name="nation" group_id="geot" notes="Country Level" created="2012-02-27 10:18:19-06" popularity="100" series_count="3"/>
<tag name="nsa" group_id="seas" notes="Not seasonally adjusted" created="2012-02-27 10:18:19-06" popularity="96" series_count="3"/>
<tag name="usa" group_id="geo" notes="United States of America" created="2012-02-27 10:18:19-06" popularity="100" series_count="3"/>
<tag name="weekly" group_id="freq" notes="" created="2012-02-27 10:18:19-06" popularity="82" series_count="2"/>
<tag name="discontinued" group_id="gen" notes="" created="2012-02-27 10:18:19-06" popularity="68" series_count="1"/>
<tag name="monthly" group_id="freq" notes="" created="2012-02-27 10:18:19-06" popularity="95" series_count="1"/>
</tags>
https://api.stlouisfed.org/fred/series/search/related_tags?series_search_text=mortgage+rate&tag_names=30-year;frb&api_key=abcdefghijklmnopqrstuvwxyz123456&file_type=json
{
"realtime_start": "2013-08-14",
"realtime_end": "2013-08-14",
"order_by": "series_count",
"sort_order": "desc",
"count": 10,
"offset": 0,
"limit": 1000,
"tags": [
{
"name": "conventional",
"group_id": "gen",
"notes": "",
"created": "2012-02-27 10:18:19-06",
"popularity": 63,
"series_count": 3
},
{
"name": "h15",
"group_id": "rls",
"notes": "H.15 Selected Interest Rates",
"created": "2012-08-16 15:21:17-05",
"popularity": 84,
"series_count": 3
},
{
"name": "interest rate",
"group_id": "gen",
"notes": "",
"created": "2012-05-29 10:14:19-05",
"popularity": 87,
"series_count": 3
},
{
"name": "mortgage",
"group_id": "gen",
"notes": "",
"created": "2012-02-27 10:18:19-06",
"popularity": 68,
"series_count": 3
},
{
"name": "nation",
"group_id": "geot",
"notes": "Country Level",
"created": "2012-02-27 10:18:19-06",
"popularity": 100,
"series_count": 3
},
{
"name": "nsa",
"group_id": "seas",
"notes": "Not seasonally adjusted",
"created": "2012-02-27 10:18:19-06",
"popularity": 96,
"series_count": 3
},
{
"name": "usa",
"group_id": "geo",
"notes": "United States of America",
"created": "2012-02-27 10:18:19-06",
"popularity": 100,
"series_count": 3
},
{
"name": "weekly",
"group_id": "freq",
"notes": "",
"created": "2012-02-27 10:18:19-06",
"popularity": 82,
"series_count": 2
},
{
"name": "discontinued",
"group_id": "gen",
"notes": "",
"created": "2012-02-27 10:18:19-06",
"popularity": 68,
"series_count": 1
},
{
"name": "monthly",
"group_id": "freq",
"notes": "",
"created": "2012-02-27 10:18:19-06",
"popularity": 95,
"series_count": 1
}
]
}
Read API Keys for more information.
A key or file extension that indicates the type of file to send.
xml = Extensible Markup Language. The HTTP Content-Type is text/xml.
json = JavaScript Object Notation. The HTTP Content-Type is application/json.
The words to match against economic data series.
The start of the real-time period. For more information, see Real-Time Periods.
The end of the real-time period. For more information, see Real-Time Periods.
A semicolon delimited list of tag names that series match all of. See the related request fred/series/search/tags.
A semicolon delimited list of tag names that series match none of.
A tag group id to filter tags by type.
freq = Frequency
gen = General or Concept
geo = Geography
geot = Geography Type
rls = Release
seas = Seasonal Adjustment
src = Source
The words to find matching tags with.
The maximum number of results to return.
Order results by values of the specified attribute.
Sort results is ascending or descending order for attribute values specified by order_by.