series

Find and inspect FRED® data series.

A series is a named sequence of economic observations over time.

Examples:

  • GDP — Gross Domestic Product
  • CPIAUCSL — Consumer Price Index for All Urban Consumers
  • UNRATE — Unemployment Rate

USAGE

reserve series [subcommand]

Available Subcommands:

categoriesList categories a series belongs to
getFetch metadata for one or more series
searchSearch for series by keyword
tagsList tags associated with a series

reserve series [subcommand] –help (for more details about a specific subcommand)

CATEGORIES

List the categories a series belongs to. Categories organize series within FRED’s taxonomy.

Usage: reserve series categories [flags]

# Retrieve series categories for UNRATE
$ reserve series categories UNRATE

GET

Fetch metadata for one or more series.

Usage: reserve series get <SERIES_ID…> [flags]

# Get CPIAUCSL series
$ reserve series get CPIAUCSL

# Get multiple series
$ reserve series get CPIAUCSL UNRATE GDP

# Format as JSON
$ reserve series get CPIAUCSL --format json

SEARCH

Search for FRED series by keyword.

Usage: reserve series search “” [flags]

# General search
$ reserve series search "inflation"

# Limit results
$ reserve series search "inflation" --limit 10

# Format for spreadsheet import
$ reserve series search "inflation" --limit 20 --format csv

TAGS

List tags associated with a series. Tags describe attributes such as geography, frequency, seasonal adjustment, and topic.

Usage: reserve series tags <SERIES_ID>

# Basic usage
$ reserve series tags CPIAUCSL

WORKFLOW

# Search for a topic
$ reserve series search "unemployment"

# Inspect the series
$ reserve series get UNRATE

# Explore its classification
$ reserve series categories UNRATE

# Inspect its tags
$ reserve series tags UNRATE


See Global Flags for additional global options available for this command.