BEA Regional Economic Accounts (county personal income, employment, GDP) · Records list
apps-bea-gov/economic-statistics/records_listGet market and financial data with BEA Regional Economic Accounts (county personal income, employment, GDP) · Records list from Alexandria through one Spiral API key. To collect a whole table for a state: e.g. CAINC1 line 3 (per capita personal income) for every Montana county, all years; or CAINC5N earnings by industry for every county, latest year. Follow next_cursor until it is null. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
state required | text | — | State as a USPS code (MT), a 2-digit state FIPS (30) or BEA's 5-digit state key (30000); US for the United States total plus the eight BEA regions. The 50 states and DC are supported (BEA county tables carry no territories). |
table required | one of CAINC1, CAINC4, CAINC5N, CAINC6N, CAINC30, CAINC91, CAGDP1, CAGDP2, CAGDP8, CAGDP9, CAGDP11 | — | BEA Regional county table name (see source_status). |
years | text | — | ALL (default), LAST5 / LAST10 (newest n years the table serves), one year (2024) or a comma list (2022,2023,2024). Pattern: ^(ALL|all|LAST[1-9][0-9]?|last[1-9][0-9]?|[12][0-9]{3}(,[12][0-9]{3})*)$. |
cursor | text | — | next_cursor from the previous page. Opaque; pins table, state, line_code, years, the county list and the publication_id. |
line_code | text | — | One line code (statistic) of the table, e.g. 3 for CAINC1 per capita personal income. Omit for every line of the table. Pattern: ^[0-9]{1,4}$. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "apps-bea-gov/economic-statistics/records_list",
"input": {
"state": "<state>",
"table": "CAINC1"
}
}'Frequently asked questions
How much does BEA Regional Economic Accounts (county personal income, employment, GDP) · Records list cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use BEA Regional Economic Accounts (county personal income, employment, GDP) · Records list through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "apps-bea-gov/economic-statistics/records_list"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use BEA Regional Economic Accounts (county personal income, employment, GDP) · Records list?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use BEA Regional Economic Accounts (county personal income, employment, GDP) · Records list?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.