FRED Search Series

Name: FRED Search Series
Price: 0.000015 USD
Availability: InStock
Author: FRED

https://api.sandbase.ai/v1/api/fred/series-search

Search Series from FRED. Returns the official FRED API response unchanged.

Try this API Get API key

Price: $0USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 1 required · 12 optional

Production route

Try the model

Playground

Open playground

Input

Exclude Tag Names(string)

A semicolon delimited list of tag names that series match none of. String, optional, no filtering by tags by default. Example value: 'discontinued;m1'. Filter results to series having neither tag 'discontinued' nor tag 'm1'. Parameter exclude_tag_names requires that parameter tag_names also be set t

File Type(string)

Response format. Only json is supported. Allowed values: json.

Filter Value(string)

The value of the filter_variable attribute to filter results by. String, optional, no filter by default

Filter Variable(string)

The attribute to filter results by. One of the following strings: 'frequency', 'units', 'seasonal_adjustment'. optional, no filter by default Allowed values: frequency, units, seasonal_adjustment.

Limit(integer)

11000

The maximum number of results to return. integer between 1 and 1000, optional, default: 1000 Range: 1 to 1000.

Offset(integer)

non-negative integer, optional, default: 0 Minimum: 0.

Order By(string)

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', 'group_popularity'. optional, de Allowed values: search_rank, series_id, title, units, frequency, seasonal_adjustment, realtime_start, realtime_end, last_updated, observation_start, observation_end, popularity, group_popularity.

Realtime End(string)

The end of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date

Realtime Start(string)

The start of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date

Search Text(string)

The words to match against economic data series.

Search Type(string)

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 tags by parsing words into stems. This makes it possible for searches like 'Industry' to match series containing related words such as Allowed values: full_text, series_id.

Sort Order(string)

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'. Allowed values: asc, desc.

Tag Names(string)

A semicolon delimited list of tag names that series match all of. String, optional, no filtering by tags by default Example value: 'usa;m2'. Filter results to series having both tags 'usa' and 'm2'. See the related request fred/tags .

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

search_text: string · required
exclude_tag_names: string · optional
file_type: string (json) · optional
filter_value: string · optional
filter_variable: string (frequency, units, seasonal_adjustment) · optional
limit: integer · optional
offset: integer · optional
order_by: string (search_rank, series_id, title, units, frequency, seasonal_adjustment, realtime_start, realtime_end, last_updated, observation_start, observation_end, popularity, group_popularity) · optional
realtime_end: string · optional
realtime_start: string · optional
search_type: string (full_text, series_id) · optional
sort_order: string (asc, desc) · optional
More: +1 optional parameters

Access

Provider: FRED
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/fred/series-search
Authentication: Bearer API key

API README

FRED Search Series API

Search Series from FRED. Returns the official FRED API response unchanged.

The response is the official FRED API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "fred/series-search", "search_text": "<search_text>"}'

Parameters

Name	Type	Required	Description
`exclude_tag_names`	string	No	A semicolon delimited list of tag names that series match none of. String, optional, no filtering by tags by default. Example value: 'discontinued;m1'. Filter r
`file_type`	string	No	Response format. Only json is supported.
`filter_value`	string	No	The value of the filter_variable attribute to filter results by. String, optional, no filter by default
`filter_variable`	string	No	The attribute to filter results by. One of the following strings: 'frequency', 'units', 'seasonal_adjustment'. optional, no filter by default
`limit`	integer	No	The maximum number of results to return. integer between 1 and 1000, optional, default: 1000
`offset`	integer	No	non-negative integer, optional, default: 0
`order_by`	string	No	Order results by values of the specified attribute. One of the following strings: 'search_rank', 'series_id', 'title', 'units', 'frequency', 'seasonal_adjustmen
`realtime_end`	string	No	The end of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
`realtime_start`	string	No	The start of the real-time period. For more information, see Real-Time Periods . YYYY-MM-DD formatted string, optional, default: today's date
`search_text`	string	Yes	The words to match against economic data series.
`search_type`	string	No	Determines the type of search to perform. One of the following strings: 'full_text', 'series_id'. 'full_text' searches series attributes title, units, frequency
`sort_order`	string	No	Sort results is ascending or descending order for attribute values specified by order_by. One of the following strings: 'asc', 'desc'. optional, default: If ord
`tag_names`	string	No	A semicolon delimited list of tag names that series match all of. String, optional, no filtering by tags by default Example value: 'usa;m2'. Filter results to s

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/fred/series-search

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/fred/series-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "limit": 1000,
  "offset": 0,
  "file_type": "json",
  "search_type": "full_text"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
FRED Search SeriesThis API `FRED`	$0 per call	JSON	Oct 30, 2026
FRED category `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Children `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Related `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Related Tags `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Series `FRED`	$0 per call	JSON	Oct 30, 2026

Questions

FAQ

How do I use the FRED Search Series API?

Send a POST request to https://api.sandbase.ai/v1/api/fred/series-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the FRED Search Series API cost?

$0 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the FRED Search Series API accept?

Required: search_text (string). Optional: exclude_tag_names (string), file_type (one of json), filter_value (string), filter_variable (one of frequency, units, seasonal_adjustment), limit (integer) and offset (integer) and 6 more. The Parameters table and the Playground on this page list every field.

What does the FRED Search Series API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a FRED developer account or API key?

No. FRED Search Series runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for FRED API access separately.