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().
Examples
from openbb import obb
obb.economy.fred_search(provider='fred')
Parameters
- standard
- fred
query: str
The search word(s).
query: str
The search word(s).
search_type: Literal['full_text', 'series_id', 'release']
Default: full_text
The type of search to perform. Automatically set to 'release' when a 'release_id' is provided.
release_id: Annotated[int, Ge(ge=0)]
A specific release ID to target.
limit: Annotated[int, Ge(ge=0)]
The number of data entries to return. (1-1000)
offset: Annotated[int, Ge(ge=0)]
Default: 0
Offset the results in conjunction with limit. This parameter is ignored When search_type is 'release'.
order_by: Literal['search_rank', 'series_id', 'title', 'units', 'frequency', 'seasonal_adjustment', 'realtime_start', 'realtime_end', 'last_updated', 'observation_start', 'observation_end', 'popularity', 'group_popularity']
Default: observation_end
Order the results by a specific attribute. The default is 'observation_end'.
sort_order: Literal['asc', 'desc']
Default: desc
Sort the 'order_by' item in ascending or descending order. The default is 'desc'.
filter_variable: Literal['frequency', 'units', 'seasonal_adjustment']
Filter by an attribute.
filter_value: str
String value to filter the variable by. Used in conjunction with filter_variable. This parameter is ignored when search_type is 'release'.
tag_names: str | list[str]
A semicolon delimited list of tag names that series match all of. Example: 'japan;imports' This parameter is ignored when search_type is 'release'. Multiple items allowed for provider(s): fred.
exclude_tag_names: str | list[str]
A semicolon delimited list of tag names that series match none of. Example: 'imports;services'. Requires that variable tag_names also be set to limit the number of matching series. This parameter is ignored when search_type is 'release'. Multiple items allowed for provider(s): fred.
series_id: str
A FRED Series ID to return series group information for. This returns the required information to query for regional data. Not all series that are in FRED have geographical data. Entering a value for series_id will override all other parameters. Multiple series_ids can be separated by commas.
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
- standard
- fred
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.
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.