BEA Regional Economic Accounts Scraper

Extract U.S. Bureau of Economic Analysis (BEA) regional data — state and county GDP, personal income, per-capita income, and industry employment — directly from the official BEA API. Perfect for economic research, market sizing, real-estate analysis, public policy, and macro investment models.

The BEA is the authoritative source for U.S. regional economic statistics, used by federal agencies, Wall Street analysts, and academic researchers. This Actor wraps the BEA Regional dataset and returns clean, structured records ready for dashboards or RAG pipelines.

What you get

Field	Description
tableName	BEA table code (e.g., CAINC1, CAGDP1, CAEMP25N)
lineCode / lineDescription	Specific metric within the table
geoFips	5-digit FIPS code identifying the geography
geoName	Plain-English geography name
year	Reporting year
dataValue	Numeric value (BEA's native unit)
unitOfMeasure / unitMult	Units and scaling multiplier
noteRef	Footnote reference for caveats

How to scrape BEA regional data

1. Register a free API key at https://apps.bea.gov/API/signup/ (instant email delivery).
2. Open the Actor and paste your key into BEA API Key.
3. Choose a Table Name — CAINC1 (Personal income summary), CAGDP1 (State GDP), CAEMP25N (Employment), CAINC30 (Per-capita income), and many more.
4. Set Line Code for the specific metric inside the table.
5. Set Geographic FIPS — STATE, COUNTY, or a comma-separated list of FIPS codes.
6. Set Year to ALL or specific years.
7. Click Start.

Why a free API key?

BEA enforces per-key rate limits. Using your own key avoids shared throttling and keeps your runs fast. The key is free, requires only an email, and never expires.

Use cases

• Site selection — Compare county-level income and employment growth.
• Real-estate analysis — Pair per-capita income with housing data.
• Public-sector forecasting — Build state revenue and tax-base models.
• AI/LLM pipelines — Inject authoritative macro context into RAG systems.

Pricing

Priced at $0.003 per result. A statewide CAINC1 for one year returns ~50 rows; a county-level pull across 10 years can exceed 30,000 rows.

Input example

{
  "apiKey": "YOUR-BEA-KEY",
  "tableName": "CAINC1",
  "lineCode": 1,
  "geoFips": "STATE",
  "year": "2023",
  "maxResults": 5000
}

Output example

{
  "tableName": "CAINC1",
  "lineDescription": "Personal income (thousands of dollars)",
  "geoFips": "06000",
  "geoName": "California",
  "year": "2023",
  "dataValue": 3193784000,
  "unitOfMeasure": "USD"
}

Related Actors

• FRED Federal Reserve Economic Data Scraper — national-level macro series.
• Treasury Fiscal Data Scraper — federal debt and revenue.
• Census Business Patterns Scraper — employment by NAICS by county.

FAQ

Is an API key required? Yes — but registration is free and instant. The Actor emits a notice record explaining how to get one if no key is supplied.

Can I download all U.S. counties? Yes — set geoFips=COUNTY and a Year.

Legal

This Actor uses the public BEA Data API. Users must comply with BEA's terms of service. The Actor does not bypass any access controls.

Support: bciccarelli6@gmail.com