US Census Bureau · Data
census-gov/census/dataSearch public records with US Census Bureau · Data from Alexandria through one Spiral API key. Retrieve estimates. Input: dataset path (acs/acs5, acs/acs1, acs/acs5/subject, acs/acs5/profile, dec/pl, dec/dhc, pep/population, cbp ...), vintage, 1-200 variable names or group(TABLE) tokens, and a geography as Data API for/in predicates (for: 'county:*', in: ['state:06']). 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 |
|---|---|---|---|
dataset required | one of acs/acs5, acs/acs1, acs/acs5/subject, acs/acs1/subject, acs/acs5/profile, acs/acs1/profile, acs/acs5/cprofile, acs/acs1/cprofile, dec/pl, dec/dhc, dec/sf1, pep/population, cbp | — | dataset |
vintage required | number 2000 to 2035 | — | vintage |
geography required | JSON | — | geography |
variables required | list | — | Variable names (B01003_001E, B19013_001M, P1_001N, ESTAB) or group(TABLE). NAME and GEO_ID may be added to any request. Variables may span up to 8 tables; more than 50 variables are split into per-table fetches and merged by GEO_ID (reported in warnings). |
cursor | text | — | cursor |
page_size | number 1 to 5000 | 500 | page_size |
predicates | JSON | — | Exact-match filters on any returned column, e.g. {"NAICS2017": "00", "EMPSZES": "001"} for CBP or {"DATE_CODE": "12"} for PEP. |
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": "census-gov/census/data",
"input": {
"dataset": "acs/acs5",
"vintage": 2000,
"geography": {},
"variables": [
"<variables>"
]
}
}'Frequently asked questions
How much does US Census Bureau · Data 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 US Census Bureau · Data through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "census-gov/census/data"` 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 US Census Bureau · Data?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use US Census Bureau · Data?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.