Get FRED tags. Optionally, filter results by tag name, tag group, or search text. FRED tags are attributes assigned to a series. By default, all tags are returned, unfiltered, up to the limit.

  tag_names = NULL,
  tag_group_id = NULL,
  search_text = NULL,
  limit = NULL,
  offset = NULL,
  order_by = NULL,
  sort_order = NULL,
  realtime_start = NULL,
  realtime_end = NULL



These dots only exist for future extensions and should be empty.


A semicolon delimited string of tag names to only include in the response. No filtering by tag names by default (i.e. all FRED tags returned).


A string tag group id to filter tags by type. No filtering by tag group by default. Possible values are:

  • "freq" = Frequency

  • "gen" = General or Concept

  • "geo" = Geography

  • "geot" = Geography Type

  • "rls" = Release

  • "seas" = Seasonal Adjustment

  • "src" = Source


A string indicating the words to find matching tags with. No filtering by search words by default.


An integer limit on the maximum number of results to return. Defaults to 1000, the maximum.


An integer used in conjunction with limit for long series. This mimics the idea of pagination to retrieve large amounts of data over multiple calls. Defaults to 0.


Order results by values of the specified attribute. Possible values are:

  • "series_count" (default)

  • "popularity"

  • "created"

  • "name"

  • "group_id"


A string representing the order of the resulting series, sorted by the attribute values specified by order_by. Possible values are: "asc" (default), and "desc".


A Date indicating the start of the real-time period. Defaults to today's date. For more information, see Real-Time Periods.


A Date indicating the end of the real-time period. Defaults to today's date. For more information, see Real-Time Periods.


A tibble containing tags and their descriptions. Data include tag name, group ID, popularity, series count, tag creation date, and additional notes.

API Documentation


See also


if (fredr_has_key() && interactive()) { # Information for all tags fredr_tags() # Information for just the "gdp" and "oecd" tags fredr_tags(tag_names = "gdp;oecd") # Information for all tags in the "geo" group fredr_tags(tag_group_id = "geo") # Information for tags matching the text "unemployment" fredr_tags(search_text = "unemployment") }