zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Finance/Bea
Logo Bea

Bea

BEA regional income — state and county personal income, from the bulk zips.

Endpoints
6
Requests
418
Updated
5 hours ago
For LLMs
llms.txt
Endpoint healthnot yet measured
  • regionalnot measured
  • seriesnot measured
  • gdpnot measured
  • nipanot measured
  • tablesnot measured
+ 1 more endpointShow less
  • pcenot measured
no measurements yetdaily 01:00 WIB

Playground

6 endpoints
GET/v1/finance:bea/regional1d cache8 paramschecking key…
Parameters
archivestring

Regional dataset archive — CAINC1 (annual county and state personal income), sqinc (quarterly state income), CAINC4, CAINC30 and the rest of the CA/SA/SQ family. Default CAINC1.

tablestring

Table inside the archive, when it holds more than one. Default the first.

geostring

Two-letter state code for the per-state file, or ALL_AREAS for every area in one. Default ALL_AREAS.

areastring

Case-insensitive filter over the area name and FIPS code.

linenumber

Only the rows carrying this LineCode — 1 is total personal income in most tables.

fromstring

Earliest period — a year for annual archives, 2020Q1 for quarterly ones.

tostring

Latest period, same format as from.

lengthnumber

Rows to return. Default 100, max 2000.

·
Response
EXAMPLE
{
  "to": null,
  "geo": "ALL_AREAS",
  "area": null,
  "from": null,
  "line": null,
  "count": 100,
  "entry": "CAINC1__ALL_AREAS_1969_2024.csv",
  "items": [
    {
      "unit": "Thousands of dollars",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 24897613000,
          "period": "2024"
        },
        {
          "value": 23577208000,
          "period": "2023"
        },
        {
          "value": 22144814000,
          "period": "2022"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 1,
      "description": "Personal income (thousands of dollars)",
      "latestValue": 24897613000,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Number of persons",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 340110988,
          "period": "2024"
        },
        {
          "value": 336806231,
          "period": "2023"
        },
        {
          "value": 334017321,
          "period": "2022"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 2,
      "description": "Population (persons) 1/",
      "latestValue": 340110988,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Dollars",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 73204,
          "period": "2024"
        },
        {
          "value": 70002,
          "period": "2023"
        },
        {
          "value": 66298,
          "period": "2022"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 3,
      "description": "Per capita personal income (dollars) 2/",
      "latestValue": 73204,
      "latestPeriod": "2024",
      "industryClassification": "..."
    }
  ],
  "table": "CAINC1",
  "total": 9627,
  "tables": [
    "CAINC1"
  ],
  "archive": "CAINC1",
  "dataset": "regional",
  "periods": [
    "1969",
    "1970",
    "1971"
  ],
  "provider": "bea"
}

Code examples

Regional
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("finance:bea", "regional", {
  "archive": "CAINC1",
  "table": "SQINC1",
  "geo": "WA",
  "area": "Seattle",
  "line": 1,
  "from": "2020",
  "to": "2024",
  "length": 50
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/finance:bea/regional?archive=CAINC1&table=SQINC1&geo=WA&area=Seattle&line=1&from=2020&to=2024&length=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

6 endpoints · plain text
GETRegional/v1/finance:bea/regionalBEA regional income — state and county personal income, from the bulk zips.

Parameters

archivestringoptional
Regional dataset archive — CAINC1 (annual county and state personal income), sqinc (quarterly state income), CAINC4, CAINC30 and the rest of the CA/SA/SQ family. Default CAINC1.
tablestringoptional
Table inside the archive, when it holds more than one. Default the first.
geostringoptional
Two-letter state code for the per-state file, or ALL_AREAS for every area in one. Default ALL_AREAS.
areastringoptional
Case-insensitive filter over the area name and FIPS code.
linenumberoptional
Only the rows carrying this LineCode — 1 is total personal income in most tables.
fromstringoptional
Earliest period — a year for annual archives, 2020Q1 for quarterly ones.
tostringoptional
Latest period, same format as from.
lengthnumberoptional
Rows to return. Default 100, max 2000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bea/regional?archive=CAINC1&table=SQINC1&geo=WA&area=Seattle&line=1&from=2020&to=2024&length=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": null,
  "geo": "ALL_AREAS",
  "area": null,
  "from": null,
  "line": null,
  "count": 100,
  "entry": "CAINC1__ALL_AREAS_1969_2024.csv",
  "items": [
    {
      "unit": "Thousands of dollars",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 24897613000,
          "period": "2024"
        },
        {
          "value": 23577208000,
          "period": "2023"
        },
        {
          "value": 22144814000,
          "period": "2022"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 1,
      "description": "Personal income (thousands of dollars)",
      "latestValue": 24897613000,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Number of persons",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 340110988,
          "period": "2024"
        },
        {
          "value": 336806231,
          "period": "2023"
        },
        {
          "value": 334017321,
          "period": "2022"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 2,
      "description": "Population (persons) 1/",
      "latestValue": 340110988,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Dollars",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 73204,
          "period": "2024"
        },
        {
          "value": 70002,
          "period": "2023"
        },
        {
          "value": 66298,
          "period": "2022"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 3,
      "description": "Per capita personal income (dollars) 2/",
      "latestValue": 73204,
      "latestPeriod": "2024",
      "industryClassification": "..."
    }
  ],
  "table": "CAINC1",
  "total": 9627,
  "tables": [
    "CAINC1"
  ],
  "archive": "CAINC1",
  "dataset": "regional",
  "periods": [
    "1969",
    "1970",
    "1971"
  ],
  "provider": "bea"
}
GETSeries/v1/finance:bea/seriesThe BEA's NIPA series register — 10,781 series with their labels, metrics and

Parameters

querystringoptional
Case-insensitive filter over the series code, label and metric.
seriesstringoptional
Exact series codes, comma-separated. Overrides query.
tablestringoptional
Only series that appear on this table.
metricstringoptional
Only series whose metric matches, case-insensitive substring.
lengthnumberoptional
Series to return. Default 100, max 2000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bea/series?query=gross+domestic+product&series=A191RL%2CA191RC&table=T10101&metric=Current+Dollars&length=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 46,
  "items": [
    {
      "label": "Gross domestic product",
      "metric": "Fisher Quantity Index",
      "series": "A191RA",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10103"
        },
        {
          "line": 1,
          "table": "T10203"
        },
        {
          "line": 1,
          "table": "T10303"
        }
      ],
      "calculation": "Level",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product",
      "metric": "Current Dollars",
      "series": "A191RC",
      "parents": [
        "A001RC",
        "A712RC",
        "A962RC"
      ],
      "appearsOn": [
        {
          "line": 1,
          "table": "OECD10205"
        },
        {
          "line": 1,
          "table": "T10105"
        },
        {
          "line": 1,
          "table": "T10205"
        }
      ],
      "calculation": "Level",
      "defaultScale": -6
    },
    {
      "label": "Gross domestic product",
      "metric": "Chained Dollar IPDs",
      "series": "A191RD",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10109"
        }
      ],
      "calculation": "Level",
      "defaultScale": 0
    }
  ],
  "query": "gross domestic product",
  "table": null,
  "total": 46,
  "metric": null,
  "series": null,
  "dataset": "series",
  "provider": "bea",
  "registered": 10781
}
GETGdp/v1/finance:bea/gdpUS gross domestic product — the GDP cut of the NIPA flat files.

Parameters

measureenumoptional
Which cut: level, change, contribution. Default change. Values: level, change, contribution.
frequencyenumoptional
A annual, Q quarterly, M monthly. Default Q. Contributions and chained dollars are quarterly and annual only. Values: A, Q, M.
fromstringoptional
Earliest period in the file's own format — 2020 for annual, 2020Q1 for quarterly, 2020M01 for monthly.
tostringoptional
Latest period, same format as from.
lengthnumberoptional
Observations per series, newest first. Default 40, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bea/gdp?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": null,
  "from": null,
  "count": 3,
  "items": [
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 317,
      "metric": "Fisher Quantity Index",
      "series": "A191RL",
      "values": [
        {
          "value": 1.5,
          "period": "2026Q2"
        },
        {
          "value": 2.1,
          "period": "2026Q1"
        },
        {
          "value": 0.5,
          "period": "2025Q4"
        },
        {
          "value": 4.4,
          "period": "2025Q3"
        },
        {
          "value": 3.8,
          "period": "2025Q2"
        },
        {
          "value": -0.6,
          "period": "2025Q1"
        },
        {
          "value": 1.9,
          "period": "2024Q4"
        },
        {
          "value": 3.3,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 1.5,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Gross domestic product, current dollars",
      "total": 317,
      "metric": "Current Dollars",
      "series": "A191RP",
      "values": [
        {
          "value": 7.9,
          "period": "2026Q2"
        },
        {
          "value": 5.8,
          "period": "2026Q1"
        },
        {
          "value": 4.2,
          "period": "2025Q4"
        },
        {
          "value": 8.3,
          "period": "2025Q3"
        },
        {
          "value": 6,
          "period": "2025Q2"
        },
        {
          "value": 2.9,
          "period": "2025Q1"
        },
        {
          "value": 4.3,
          "period": "2024Q4"
        },
        {
          "value": 5.1,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 7.9,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 317,
      "metric": "Fisher Price Index",
      "series": "A191RV",
      "values": [
        {
          "value": 6.2,
          "period": "2026Q2"
        },
        {
          "value": 3.6,
          "period": "2026Q1"
        },
        {
          "value": 3.7,
          "period": "2025Q4"
        },
        {
          "value": 3.8,
          "period": "2025Q3"
        },
        {
          "value": 2.1,
          "period": "2025Q2"
        },
        {
          "value": 3.6,
          "period": "2025Q1"
        },
        {
          "value": 2.4,
          "period": "2024Q4"
        },
        {
          "value": 1.8,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 6.2,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    }
  ],
  "total": 951,
  "series": [
    "A191RL",
    "A191RP",
    "A191RV"
  ],
  "dataset": "gdp",
  "measure": "change",
  "missing": [],
  "provider": "bea",
  "resolved": [
    "A191RL",
    "A191RP",
    "A191RV"
  ],
  "frequency": "Q",
  "truncated": false
}
GETNipa/v1/finance:bea/nipaDated observations for any NIPA series, from the BEA's flat files.

Parameters

seriesstringoptional
NIPA series codes, comma-separated, up to 25. series and tables find them. Default A191RL (real GDP, percent change, annual rate).
frequencyenumoptional
A annual, Q quarterly, M monthly. Default Q. Not every series exists at every frequency. Values: A, Q, M.
fromstringoptional
Earliest period in the file's own format — 2020 for annual, 2020Q1 for quarterly, 2020M01 for monthly.
tostringoptional
Latest period, same format as from.
lengthnumberoptional
Observations per series, newest first. Default 40, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bea/nipa?series=A191RL%2CA191RC&frequency=Q&from=2020Q1&to=2026Q2&length=20" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": null,
  "from": null,
  "count": 2,
  "items": [
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 317,
      "metric": "Fisher Quantity Index",
      "series": "A191RL",
      "values": [
        {
          "value": 1.5,
          "period": "2026Q2"
        },
        {
          "value": 2.1,
          "period": "2026Q1"
        },
        {
          "value": 0.5,
          "period": "2025Q4"
        },
        {
          "value": 4.4,
          "period": "2025Q3"
        },
        {
          "value": 3.8,
          "period": "2025Q2"
        },
        {
          "value": -0.6,
          "period": "2025Q1"
        },
        {
          "value": 1.9,
          "period": "2024Q4"
        },
        {
          "value": 3.3,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 1.5,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 318,
      "metric": "Current Dollars",
      "series": "A191RC",
      "values": [
        {
          "value": 32475210,
          "period": "2026Q2"
        },
        {
          "value": 31865721,
          "period": "2026Q1"
        },
        {
          "value": 31422526,
          "period": "2025Q4"
        },
        {
          "value": 31098027,
          "period": "2025Q3"
        },
        {
          "value": 30485729,
          "period": "2025Q2"
        },
        {
          "value": 30042113,
          "period": "2025Q1"
        },
        {
          "value": 29825182,
          "period": "2024Q4"
        },
        {
          "value": 29511664,
          "period": "2024Q3"
        }
      ],
      "calculation": "Level",
      "latestValue": 32475210,
      "defaultScale": -6,
      "latestPeriod": "2026Q2"
    }
  ],
  "total": 635,
  "series": [
    "A191RL",
    "A191RC"
  ],
  "dataset": "nipa",
  "missing": [],
  "provider": "bea",
  "resolved": [
    "A191RL",
    "A191RC"
  ],
  "frequency": "Q",
  "truncated": false
}
GETTables/v1/finance:bea/tablesThe BEA's NIPA table register — the table ids `series` joins against.

Parameters

querystringoptional
Case-insensitive filter over the table id and title.
lengthnumberoptional
Tables to return. Default 200, max 1000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bea/tables?query=gross+domestic+product&length=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 45,
  "items": [
    {
      "table": "T10101",
      "title": "Table 1.1.1. Percent Change From Preceding Period in Real Gross Domestic Product"
    },
    {
      "table": "T10102",
      "title": "Table 1.1.2. Contributions to Percent Change in Real Gross Domestic Product"
    },
    {
      "table": "T10103",
      "title": "Table 1.1.3. Real Gross Domestic Product, Quantity Indexes"
    },
    {
      "table": "T10104",
      "title": "Table 1.1.4. Price Indexes for Gross Domestic Product"
    },
    {
      "table": "T10105",
      "title": "Table 1.1.5. Gross Domestic Product"
    },
    {
      "table": "T10106",
      "title": "Table 1.1.6. Real Gross Domestic Product, Chained Dollars"
    },
    {
      "table": "T10107",
      "title": "Table 1.1.7. Percent Change From Preceding Period in Prices for Gross Domestic Product"
    },
    {
      "table": "T10108",
      "title": "Table 1.1.8. Contributions to Percent Change in the Gross Domestic Product Price Index"
    }
  ],
  "query": "gross domestic product",
  "total": 45,
  "dataset": "tables",
  "provider": "bea"
}
GETPce/v1/finance:bea/pceUS personal consumption expenditures — the PCE cut of the NIPA flat files.

Parameters

measureenumoptional
Which cut: level, change, contribution. Default change. Values: level, change, contribution.
frequencyenumoptional
A annual, Q quarterly, M monthly. Default Q. Every PCE measure here is published at all three. Values: A, Q, M.
fromstringoptional
Earliest period in the file's own format — 2020 for annual, 2020Q1 for quarterly, 2020M01 for monthly.
tostringoptional
Latest period, same format as from.
lengthnumberoptional
Observations per series, newest first. Default 40, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bea/pce?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "to": null,
  "from": null,
  "count": 3,
  "items": [
    {
      "count": 40,
      "label": "Personal consumption expenditures",
      "total": 317,
      "metric": "Fisher Quantity Index",
      "series": "DPCERL",
      "values": [
        {
          "value": 3.2,
          "period": "2026Q2"
        },
        {
          "value": 0.5,
          "period": "2026Q1"
        },
        {
          "value": 1.9,
          "period": "2025Q4"
        },
        {
          "value": 3.5,
          "period": "2025Q3"
        },
        {
          "value": 2.5,
          "period": "2025Q2"
        },
        {
          "value": 0.6,
          "period": "2025Q1"
        },
        {
          "value": 3.9,
          "period": "2024Q4"
        },
        {
          "value": 4,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 3.2,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Personal consumption expenditures",
      "total": 317,
      "metric": "Fisher Price Index",
      "series": "DPCERV",
      "values": [
        {
          "value": 5.1,
          "period": "2026Q2"
        },
        {
          "value": 4.6,
          "period": "2026Q1"
        },
        {
          "value": 2.9,
          "period": "2025Q4"
        },
        {
          "value": 2.8,
          "period": "2025Q3"
        },
        {
          "value": 2.1,
          "period": "2025Q2"
        },
        {
          "value": 3.4,
          "period": "2025Q1"
        },
        {
          "value": 2.5,
          "period": "2024Q4"
        },
        {
          "value": 1.7,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 5.1,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Personal consumption expenditures (PCE)",
      "total": 314,
      "metric": "Fisher Quantity Index",
      "series": "DPCERO",
      "values": [
        {
          "value": 2.3,
          "period": "2026Q2"
        },
        {
          "value": 2.1,
          "period": "2026Q1"
        },
        {
          "value": 2.1,
          "period": "2025Q4"
        },
        {
          "value": 2.6,
          "period": "2025Q3"
        },
        {
          "value": 2.7,
          "period": "2025Q2"
        },
        {
          "value": 3.1,
          "period": "2025Q1"
        },
        {
          "value": 3.4,
          "period": "2024Q4"
        },
        {
          "value": 3.2,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, year ago",
      "latestValue": 2.3,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    }
  ],
  "total": 948,
  "series": [
    "DPCERL",
    "DPCERV",
    "DPCERO"
  ],
  "dataset": "pce",
  "measure": "change",
  "missing": [],
  "provider": "bea",
  "resolved": [
    "DPCERL",
    "DPCERV",
    "DPCERO"
  ],
  "frequency": "Q",
  "truncated": false
}

Related APIs

More in finance

Pluang

finance/pluang

Data pasar Pluang lintas aset: order book, running trade, tradebook dan ringkasan broker per saham IDX, plus saham Amerika, emas, kripto, sinyal analis dan berita.

27.9K calls·1d cache

Binance Vision

finance/binance-vision

Binance's public bulk archive: klines, 5-minute open-interest and long/short metrics, funding, book depth and liquidations, back to 2017.

7.9K calls·1d cache

TradingView

finance/tradingview

Screener, charts, technical indicators, fundamentals, news and the macro calendar across 16 markets — Indonesian equities, US equities, crypto, forex and futures.

57K calls·1d cache

Stockbit

finance/stockbit

Data saham IDX dari Stockbit: harga, chart intraday, profil emiten, diskusi komunitas, dan kamus investasi.

17.7K calls·1d cache

Mempool Space

finance/mempool-space

Recommended fee tiers in sat/vB, as mempool.space's own estimator sees them.

1.1K calls·2m cache

Etherscan

finance/etherscan

Current gas price tiers and base fee, from Etherscan's V2 multichain API.

683 calls·30s cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026