Skip to main content

fred_search

Search for FRED series or economic releases by ID or string.

This does not return the observation values, only the metadata. Use this function to find series IDs for fred_series().

Parameters

query: str

The search word(s).

Optional: True


Returns

results: list[FredSearch]

Serializable results.


provider: Optional[Literal['fred']]

Provider name.


warnings: Optional[list[Warning_]]

list of warnings.


chart: Optional[Chart]

Chart object.


extra: dict[str, Any]

Extra info.


Data

release_id: str

The release ID for queries.

series_id: str

The series ID for the item in the release.

series_group: str

The series group ID of the series. This value is used to query for regional data.

region_type: str

The region type of the series.

name: str

The name of the release.

title: str

The title of the series.

observation_start: date

The date of the first observation in the series.

observation_end: date

The date of the last observation in the series.

frequency: str

The frequency of the data.

frequency_short: str

Short form of the data frequency.

units: str

The units of the data.

units_short: str

Short form of the data units.

seasonal_adjustment: str

The seasonal adjustment of the data.

seasonal_adjustment_short: str

Short form of the data seasonal adjustment.

last_updated: datetime

The datetime of the last update to the data.

popularity: int

Popularity of the series

group_popularity: int

Group popularity of the release

realtime_start: date

The realtime start date of the series.

realtime_end: date

The realtime end date of the series.

notes: str

Description of the release.

press_release: bool

If the release is a press release.

url: str

URL to the release.