fred (version 0.3.1)

fred_search: Search for FRED series

Description

Searches the FRED database by keywords or series ID substring. Returns matching series with their metadata, ordered by relevance.

Usage

fred_search(
  query,
  type = "full_text",
  limit = 100L,
  order_by = "search_rank",
  filter_variable = NULL,
  filter_value = NULL,
  tag_names = NULL
)

Value

A data frame of matching series with columns including id, title, frequency, units, seasonal_adjustment, last_updated, popularity, and notes.

Arguments

query

Character. Search terms (e.g. "GDP", "unemployment rate").

type

Character. Either "full_text" (default) for keyword search or "series_id" for series ID substring matching (supports * wildcards).

limit

Integer. Maximum number of results to return. Default 100, maximum 1000.

order_by

Character. How to order results. One of "search_rank" (default), "series_id", "title", "units", "frequency", "seasonal_adjustment", "last_updated", "popularity", "group_popularity".

filter_variable

Character. Optional variable to filter by. One of "frequency", "units", or "seasonal_adjustment".

filter_value

Character. The value to filter on (e.g. "Monthly", "Quarterly"). Required if filter_variable is specified.

tag_names

Character. Optional comma-separated tag names to filter results (e.g. "gdp", "usa;quarterly").

See Also

Other series: fred_info(), fred_series(), fred_updates(), fred_vintages()

Examples

# \donttest{
op <- options(fred.cache_dir = tempdir())
try({
  # Keyword search
  fred_search("unemployment rate")

  # Filter to monthly series only
  fred_search("consumer price index", filter_variable = "frequency",
  filter_value = "Monthly")

  # Search by series ID pattern
  fred_search("GDP*", type = "series_id")
})
options(op)
# }