Skip to main content
GET
GDP (Snapshot)

Overview

The GDP Snapshot API returns the most recent print of every growth and income series we track: real GDP growth, the real and nominal level of GDP, the four contributions to growth, income-side growth (GDI), corporate profits, personal income, the saving rate, and real consumer spending. That is 12 rows, each with the change from the prior period and from a year earlier computed for you. Quarterly series show their latest quarter and monthly series their latest month. Pass series to get one row. We source the data directly from authoritative government sources. The snapshot refreshes within minutes of each release. To receive each release without polling, subscribe to the gdp.created webhook. To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

Coverage

Series

Quarterly: real_gdp_growth, real_gdp, nominal_gdp, consumer_spending_contribution, investment_contribution, net_exports_contribution, government_contribution, real_gdi_growth, corporate_profits. Monthly: personal_income, saving_rate, real_consumer_spending. Every series is seasonally adjusted. The full list is one free GET request away: https://api.financialdatasets.ai/macro/gdp/series/

Reading the fields

  • date is the reference period, not the release date: the first day of the quarter for quarterly series, the first day of the month for monthly series.
  • value is the published figure in the series’ units (percent, percentage points, billions of dollars at an annual rate).
  • change_prior and change_year are value minus the prior period’s value and minus the value one year earlier, in the same units.
  • change_year_pct is the year change as a percent, rounded to one decimal; null for series measured in percent or percentage points, whose change is stated in points.
  • A change is null when the comparison period was not published.
  • Each row carries its own date. real_gdi_growth and corporate_profits are published with a later estimate of a quarter than the other quarterly series, so their row can be one quarter behind.

Getting Started

There are only 2 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Execute the API request. Add series to get one series instead of all 12.

Example

GDP Snapshot

Example Response

The live response has one row per series, 12 in total.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Query Parameters

series
string

Optional series id to return one row instead of all 12, e.g. nominal_gdp.

Response

GDP snapshot response

gdp
object[]