fred/series/search

Description
Example
- Request
- Response
Parameters
- api_key
- search_text
- search_type
- realtime_start
- realtime_end
- limit
- offset
- order_by
- sort_order
- filter_variable
- filter_value

Description

Get economic data series that match keywords.

Example

Request (HTTP GET)

http://api.stlouisfed.org/fred/series/search?search_text=money%20stock&api_key=abcdefghijklmnopqrstuvwxyz123456

Note that API key 'abcdefghijklmnopqrstuvwxyz123456' is for demonstration purposes only. Use a registered API key instead.

Response

<?xml version="1.0" encoding="utf-8" ?>
<seriess realtime_start="2008-07-29" realtime_end="2008-07-29" order_by="search_rank" sort_order="desc" count="16" offset="0" limit="1000">
  <series id="M1" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M1 Money Stock" observation_start="1975-01-06" observation_end="2008-04-14" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-25 11:54:00-05" observation_description="Ending Monday" notes="Further information and definitions are available at http://research.stlouisfed.org/publications/usfd/ and http://research.stlouisfed.org/publications/mt/." popularity="22" />
  <series id="M1NS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M1 Money Stock" observation_start="1959-01-01" observation_end="2008-03-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-25 11:50:20-05" notes="Further information and definitions are available at: http://research.stlouisfed.org/publications/mt/." popularity="32" />
  <series id="M1SL" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M1 Money Stock" observation_start="1959-01-01" observation_end="2008-03-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-25 11:50:13-05" notes="Further information and definitions are available at: http://research.stlouisfed.org/publications/mt/." popularity="54" />
  <series id="M2" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M2 Money Stock" observation_start="1980-11-03" observation_end="2008-04-14" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-25 11:51:25-05" observation_description="Ending Monday" notes="Further information and definitions are available at http://research.stlouisfed.org/publications/usfd/ and http://research.stlouisfed.org/publications/mt/." popularity="87" />
  <series id="M2NS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M2 Money Stock" observation_start="1959-01-01" observation_end="2008-03-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-25 11:50:19-05" notes="Further information and definitions are available at: http://research.stlouisfed.org/publications/mt/." popularity="88" />
  <series id="M2SL" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M2 Money Stock" observation_start="1959-01-01" observation_end="2008-03-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-25 11:50:41-05" notes="Further information and definitions are available at: http://research.stlouisfed.org/publications/mt/." popularity="97" />
  <series id="WM1NS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M1 Money Stock" observation_start="1975-01-06" observation_end="2008-04-14" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-25 11:56:55-05" observation_description="Ending Monday" popularity="34" />
  <series id="WM2NS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M2 Money Stock" observation_start="1980-11-03" observation_end="2008-04-14" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-25 11:53:42-05" observation_description="Ending Monday" popularity="45" />
  <series id="MZM" realtime_start="2008-07-29" realtime_end="2008-07-29" title="MZM Money Stock" observation_start="1980-11-03" observation_end="2008-04-14" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-25 11:53:26-05" observation_description="Ending Monday" notes="M2 less small-denomination time deposits plus institutional money funds.
Money Zero Maturity is calculated by the Federal Reserve Bank of St. Louis." popularity="13" />
  <series id="MZMNS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="MZM Money Stock" observation_start="1959-01-01" observation_end="2008-03-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-25 11:50:37-05" notes="M2 less small-denomination time deposits plus institutional money funds.
Money Zero Maturity is calculated by the Federal Reserve Bank of St. Louis." popularity="77" />
  <series id="MZMSL" realtime_start="2008-07-29" realtime_end="2008-07-29" title="MZM Money Stock" observation_start="1959-01-01" observation_end="2008-03-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-25 11:50:30-05" notes="M2 less small-denomination time deposits plus institutional money funds.
Money Zero Maturity is calculated by the Federal Reserve Bank of St. Louis." popularity="98" />
  <series id="WMZMNS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="MZM Money Stock" observation_start="1980-11-03" observation_end="2008-04-14" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-25 11:57:02-05" observation_description="Ending Monday" notes="M2 less small-denomination time deposits plus institutional money funds.
Money Zero Maturity is calculated by the Federal Reserve Bank of St. Louis." popularity="56" />
  <series id="M3" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M3 Money Stock (DISCONTINUED SERIES)" observation_start="1981-01-05" observation_end="2006-03-13" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2006-09-18 20:15:11-05" observation_description="Ending Monday" notes="For details, please see http://www.federalreserve.gov/releases/h6/hist/
On March 23, 2006, the Board of Governors of the Federal Reserve System ceased publication of the M3 monetary aggregate and its components. For more information, please, refer to http://www.federalreserve.gov/releases/h6/discm3.htm.
** DISCONTINUED **" popularity="75" />
  <series id="M3NS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M3 Money Stock (DISCONTINUED SERIES)" observation_start="1959-01-01" observation_end="2006-02-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2006-10-24 14:37:41-05" notes="For details, please see http://www.federalreserve.gov/releases/h6/hist/.
On March 23, 2006, the Board of Governors of the Federal Reserve System ceased publication of the M3 monetary aggregate and its components. For more information, please refer to http://www.federalreserve.gov/releases/h6/discm3.htm.
** DISCONTINUED **" popularity="66" />
  <series id="M3SL" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M3 Money Stock (DISCONTINUED SERIES)" observation_start="1959-01-01" observation_end="2006-02-01" frequency="Monthly" frequency_short="M" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-01-15 12:36:22-06" notes="For details, please see http://www.federalreserve.gov/releases/h6/hist/.
On March 23, 2006, the Board of Governors of the Federal Reserve System ceased publication of the M3 monetary aggregate and its components. For more information, please refer to http://www.federalreserve.gov/releases/h6/discm3.htm.
** DISCONTINUED **" popularity="34" />
  <series id="WM3NS" realtime_start="2008-07-29" realtime_end="2008-07-29" title="M3 Money Stock (DISCONTINUED SERIES)" observation_start="1981-01-05" observation_end="2006-03-13" frequency="Weekly" frequency_short="W" units="Billions of Dollars" units_short="Bil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2006-09-18 20:15:51-05" observation_description="Ending Monday" notes="For details, please see http://www.federalreserve.gov/releases/h6/hist/
On March 23, 2006, the Board of Governors of the Federal Reserve System ceased publication of the M3 monetary aggregate and its components. For more information, please, refer to http://www.federalreserve.gov/releases/h6/discm3.htm.
** DISCONTINUED **" popularity="89" />
</seriess>

The series tag's notes attribute is optional.

Parameters

api_key

Read API Keys for more information.

32 character alpha-numeric lowercase string, required

search_text

The words to match against economic data series.

search_type

Determines the type of search to perform.

One of the following strings: 'full_text', 'series_id'.
'full_text' searches series attributes title, units, frequency, and notes by parsing words into stems. This makes it possible for searches like 'Industry' to match series containing related words such as 'Industries'. Of course, you can search for multiple words like 'money' and 'stock'. Remember to url encode spaces (e.g. 'money%20stock').
'series_id' performs a substring search on series IDs. Searching for 'ex' will find series containing 'ex' anywhere in a series ID. '*' can be used to anchor searches and match 0 or more of any character. Searching for 'ex*' will find series containing 'ex' at the beginning of a series ID. Searching for '*ex' will find series containing 'ex' at the end of a series ID. It's also possible to put an '*' in the middle of a string. 'm*sl' finds any series starting with 'm' and ending with 'sl'.
optional, default: full_text.

realtime_start

The start of the real-time period. For more information, see Real-Time Periods.

YYYY-MM-DD formatted string, optional, default: today's date

realtime_end

The end of the real-time period. For more information, see Real-Time Periods.

YYYY-MM-DD formatted string, optional, default: today's date

limit

The maximum number of results to return.

integer between 1 and 1000, optional, default: 1000

offset

non-negative integer, optional, default: 0

order_by

Order results by values of the specified attribute.

One of the following strings: 'search_rank', 'series_id', 'title', 'units', 'frequency', 'seasonal_adjustment', 'realtime_start', 'realtime_end', 'last_updated', 'observation_start', 'observation_end', 'popularity'.
optional, default: If the value of search_type is 'full_text' then the default value of order_by is 'search_rank'. If the value of search_type is 'series_id' then the default value of order_by is 'series_id'.

sort_order

Sort results is ascending or descending order for attribute values specified by order_by.

One of the following strings: 'asc', 'desc'.
optional, default: If order_by is equal to 'search_rank' or 'popularity', then the default value of sort_order is 'desc'. Otherwise, the default sort order is 'asc'.

filter_variable

The attribute to filter results by.

On of the following strings: 'frequency', 'units', 'seasonal_adjustment'.
optional, no filter by default

filter_value

The value of the filter_variable attribute to filter results by.

String, optional, no filter by default