---
type: "firecrawl-provider"
description: "Discover Census datasets, variables and geography codes, then retrieve published estimates, margins of error and counts with source annotations; collect the Population Estimates Program county and sub-county files (Vintage 2020-YYYY) and the SAIPE state-and-county poverty and income files from www2.census.gov."
use_when: "Discover Census datasets, variables and geography codes, then retrieve published estimates, margins of error and counts with source annotations; collect the Population Estimates Program county and sub-county files (Vintage 2020-YYYY) and the SAIPE state-and-county poverty and income files from www2.census.gov."
categories: "Public records"
capabilities: 10
credits_per_call: 5
---
# US Census Bureau on Firecrawl Alexandria

Discover Census datasets, variables and geography codes, then retrieve published estimates, margins of error and counts with source annotations; collect the Population Estimates Program county and sub-county files (Vintage 2020-YYYY) and the SAIPE state-and-county poverty and income files from www2.census.gov.

- Categories: Public records
- Category index: [Public records category](https://alexandria.firecrawl.dev/agents/categories/public-records)
- Provider key: `census-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/census-gov)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/census-gov/openapi.json)

## Capabilities

- [Data](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/data): 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']). Returns one row per geography with values as published, sentinels turned into null plus annotation, FIPS parts, variable metadata with units, and the equivalent api.census.gov URL. Unknown variables are rejected with invalid_input naming them.
- [Datasets](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/datasets): Search the Census Data API catalog. Input: free-text query over dataset path, title and description plus an optional vintage (year). Returns one record per dataset/vintage with its API endpoint, metadata links, publication date and supported geography levels.
- [Geographies](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/geographies): Geography resolver. Input: a place, county, state, tract or other geography name (e.g. 'Travis County, Texas'). Returns matching Census geographies with summary level, GEO_ID, FIPS parts and the exact `for`/`in` predicates to pass to `data`.
- [Popest get](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/popest_get): One PEP geography by its own codes, as its estimate-year records (same shape as popest_list). counties: state + county (county omitted or 000 = the state row). subcounty: the per-state file; select by place (default SUMLEV 162, or 157 together with county), cousub + county (SUMLEV 061), concit, or an explicit sumlev; nothing but state = the state row. More than one matching row is invalid_input asking for sumlev; none is not_found.
- [Popest list](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/popest_list): List Vintage 2020-YYYY population estimates from one PEP file as one record per geography and estimate year: counties (SUMLEV 040 states and 050 counties; components of change, group quarters and per-1,000 rates) or subcounty (places, county subdivisions, consolidated cities; population only). The whole file is fetched per call (2.1 MB counties, 7.5 MB national subcounty, ~30 KB per state) and paged from memory; the cursor pins vintage, file, Last-Modified and size and a changed file fails with publication_changed. source_record_id = v<vintage>:<file>:<sumlev>:<geo_id>:<year>. Names are decoded from Latin-1.
- [Popest status](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/popest_status): Cheap version check of the Population Estimates Program (PEP) file tree on www2.census.gov: newest 2020-YYYY vintage directory, then HEAD of counties/totals/co-est<YYYY>-alldata.csv and cities/totals/sub-est<YYYY>.csv (size, Last-Modified, publication_id = v<YYYY>:<file>:<Last-Modified>), plus the per-state sub-county files from the cities/totals listing. No publisher hash exists; popest_list reports the SHA-256 of the file it reads.
- [Saipe get](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/saipe_get): One SAIPE record by state and county FIPS for a year: reads est<yy>-<st>.txt (county omitted or 000 = the state row) or, for state 00 / US, the national row of est<yy>us.txt. Same record shape as saipe_list.
- [Saipe list](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/saipe_list): List SAIPE state-and-county poverty and median household income estimates for one year: est<yy>all.txt (US, 51 states, every county; 3,196 lines for 2024) or, with state, est<yy>-<st>.txt (state row first, then its counties). Fixed-width positions per the layout README: state 1-2, county 4-6, poverty all ages 8-48, age 0-17 50-90, related children 5-17 92-132, median household income 134-153, under 5 155-192 (US and states only), name 194-238, postal 240-241, file tag 243-264. Blanks and '.' become null; FIPS stay zero-padded strings. The file is fetched per call and paged from memory; the cursor pins year, file, Last-Modified and size. source_record_id = saipe<year>:<state_fips><county_fips>.
- [Saipe status](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/saipe_status): Cheap version check of the Small Area Income and Poverty Estimates (SAIPE) state-and-county files on www2.census.gov: newest year directory, the file listing (est<yy>all.txt, est<yy>us.txt, est<yy>-<st>.txt and the .xls twins), and for the national files est<yy>all.txt and est<yy>us.txt the exact size, Last-Modified, SHA-256 and line count (they are fetched: the server sends them gzip-encoded without Content-Length). publication_id = saipe<year>:<file>:<Last-Modified>.
- [Variables](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/variables): List variables of one dataset vintage. Input: dataset path and vintage, plus a group (table id such as B01003 or DP05) and/or a free-text query matched against group descriptions and variable labels. Returns variable name, verbatim label, concept, predicate type, group and the unit phrase the label carries.

## 1. Choose this provider when

Discover Census datasets, variables and geography codes, then retrieve published estimates, margins of error and counts with source annotations; collect the Population Estimates Program county and sub-county files (Vintage 2020-YYYY) and the SAIPE state-and-county poverty and income files from www2.census.gov.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "census-gov",
  "capability": "census/data",
  "options": {
    "dataset": "acs/acs5",
    "geography": {
      "for": "county:*",
      "in": [
        "state:06"
      ]
    },
    "variables": [
      "B01003_001E"
    ],
    "vintage": 2023
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `cursor` (string): cursor Example: `<cursor>`
- `dataset` (string, required): dataset Example: `acs/acs5`
- `geography` (object, required): geography Example: `{}`
- `page_size` (number): page_size Example: `500`
- `predicates` (object): Exact-match filters on any returned column, e.g. {"NAICS2017": "00", "EMPSZES": "001"} for CBP or {"DATE_CODE": "12"} for PEP. Example: `{}`
- `variables` (string[], required): 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). Example: `[]`
- `vintage` (number, required): vintage Example: `2000`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "census-gov",
    capability: "census/data",
    options: {
      dataset: "acs/acs5",
      geography: {
        for: "county:*",
        in: [
          "state:06",
        ],
      },
      variables: [
        "B01003_001E",
      ],
      vintage: 2023,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "census-gov",
  "capability": "census/data",
  "options": {
    "dataset": "acs/acs5",
    "geography": {
      "for": "county:*",
      "in": [
        "state:06"
      ]
    },
    "variables": [
      "B01003_001E"
    ],
    "vintage": 2023
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "census-gov",
    "capability": "census/data",
    "options": {
      "dataset": "acs/acs5",
      "geography": {
        "for": "county:*",
        "in": [
          "state:06"
        ]
      },
      "variables": [
        "B01003_001E"
      ],
      "vintage": 2023
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'census-gov/census/data' \
  --options '{"dataset":"acs/acs5","geography":{"for":"county:*","in":["state:06"]},"variables":["B01003_001E"],"vintage":2023}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "census-gov",
  "capability": "census/data",
  "options": {
    "dataset": "acs/acs5",
    "geography": {
      "for": "county:*",
      "in": [
        "state:06"
      ]
    },
    "variables": [
      "B01003_001E"
    ],
    "vintage": 2023
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "census-gov",
  "capability": "census/data",
  "options": {
    "dataset": "acs/acs5",
    "geography": {
      "for": "county:*",
      "in": [
        "state:06"
      ]
    },
    "variables": [
      "B01003_001E"
    ],
    "vintage": 2023
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "complete": true,
  "count": 58,
  "dataset": "acs/acs5",
  "geography": {
    "for": "county:*",
    "geo_strings": [
      "0400000US06$0500000"
    ],
    "in": [
      "state:06"
    ],
    "level": "county"
  },
  "next_cursor": null,
  "observed_at_ms": 1789084800000,
  "records": [
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "001",
          "state": "06"
        },
        "geo_id": "0500000US06001",
        "level": "county",
        "name": "Alameda County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06001:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1651949"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "003",
          "state": "06"
        },
        "geo_id": "0500000US06003",
        "level": "county",
        "name": "Alpine County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06003:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1695"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "005",
          "state": "06"
        },
        "geo_id": "0500000US06005",
        "level": "county",
        "name": "Amador County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06005:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "41029"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "007",
          "state": "06"
        },
        "geo_id": "0500000US06007",
        "level": "county",
        "name": "Butte County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06007:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "209470"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "009",
          "state": "06"
        },
        "geo_id": "0500000US06009",
        "level": "county",
        "name": "Calaveras County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06009:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "45995"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "011",
          "state": "06"
        },
        "geo_id": "0500000US06011",
        "level": "county",
        "name": "Colusa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06011:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "21895"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "013",
          "state": "06"
        },
        "geo_id": "0500000US06013",
        "level": "county",
        "name": "Contra Costa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06013:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1161458"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "015",
          "state": "06"
        },
        "geo_id": "0500000US06015",
        "level": "county",
        "name": "Del Norte County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06015:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "27293"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "017",
          "state": "06"
        },
        "geo_id": "0500000US06017",
        "level": "county",
        "name": "El Dorado County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06017:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "192299"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "019",
          "state": "06"
        },
        "geo_id": "0500000US06019",
        "level": "county",
        "name": "Fresno County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06019:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1012152"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "021",
          "state": "06"
        },
        "geo_id": "0500000US06021",
        "level": "county",
        "name": "Glenn County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06021:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "28623"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "023",
          "state": "06"
        },
        "geo_id": "0500000US06023",
        "level": "county",
        "name": "Humboldt County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06023:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "135418"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "025",
          "state": "06"
        },
        "geo_id": "0500000US06025",
        "level": "county",
        "name": "Imperial County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06025:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "179319"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "027",
          "state": "06"
        },
        "geo_id": "0500000US06027",
        "level": "county",
        "name": "Inyo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06027:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "18803"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "029",
          "state": "06"
        },
        "geo_id": "0500000US06029",
        "level": "county",
        "name": "Kern County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06029:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "910433"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "031",
          "state": "06"
        },
        "geo_id": "0500000US06031",
        "level": "county",
        "name": "Kings County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06031:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "152830"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "033",
          "state": "06"
        },
        "geo_id": "0500000US06033",
        "level": "county",
        "name": "Lake County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06033:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "68139"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "035",
          "state": "06"
        },
        "geo_id": "0500000US06035",
        "level": "county",
        "name": "Lassen County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06035:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "31177"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "037",
          "state": "06"
        },
        "geo_id": "0500000US06037",
        "level": "county",
        "name": "Los Angeles County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06037:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "9848406"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "039",
          "state": "06"
        },
        "geo_id": "0500000US06039",
        "level": "county",
        "name": "Madera County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06039:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "158790"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "041",
          "state": "06"
        },
        "geo_id": "0500000US06041",
        "level": "county",
        "name": "Marin County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06041:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "258765"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "043",
          "state": "06"
        },
        "geo_id": "0500000US06043",
        "level": "county",
        "name": "Mariposa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06043:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "17060"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "045",
          "state": "06"
        },
        "geo_id": "0500000US06045",
        "level": "county",
        "name": "Mendocino County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06045:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "90709"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "047",
          "state": "06"
        },
        "geo_id": "0500000US06047",
        "level": "county",
        "name": "Merced County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06047:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "285597"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "049",
          "state": "06"
        },
        "geo_id": "0500000US06049",
        "level": "county",
        "name": "Modoc County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06049:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "8646"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "051",
          "state": "06"
        },
        "geo_id": "0500000US06051",
        "level": "county",
        "name": "Mono County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06051:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "13169"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "053",
          "state": "06"
        },
        "geo_id": "0500000US06053",
        "level": "county",
        "name": "Monterey County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06053:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "435834"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "055",
          "state": "06"
        },
        "geo_id": "0500000US06055",
        "level": "county",
        "name": "Napa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06055:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "136070"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "057",
          "state": "06"
        },
        "geo_id": "0500000US06057",
        "level": "county",
        "name": "Nevada County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06057:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "102452"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "059",
          "state": "06"
        },
        "geo_id": "0500000US06059",
        "level": "county",
        "name": "Orange County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06059:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "3164063"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "061",
          "state": "06"
        },
        "geo_id": "0500000US06061",
        "level": "county",
        "name": "Placer County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06061:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "412435"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "063",
          "state": "06"
        },
        "geo_id": "0500000US06063",
        "level": "county",
        "name": "Plumas County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06063:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "19607"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "065",
          "state": "06"
        },
        "geo_id": "0500000US06065",
        "level": "county",
        "name": "Riverside County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06065:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "2449909"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "067",
          "state": "06"
        },
        "geo_id": "0500000US06067",
        "level": "county",
        "name": "Sacramento County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06067:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1584047"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "069",
          "state": "06"
        },
        "geo_id": "0500000US06069",
        "level": "county",
        "name": "San Benito County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06069:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "66056"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "071",
          "state": "06"
        },
        "geo_id": "0500000US06071",
        "level": "county",
        "name": "San Bernardino County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06071:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "2187816"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "073",
          "state": "06"
        },
        "geo_id": "0500000US06073",
        "level": "county",
        "name": "San Diego County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06073:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "3282782"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "075",
          "state": "06"
        },
        "geo_id": "0500000US06075",
        "level": "county",
        "name": "San Francisco County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06075:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "836321"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "077",
          "state": "06"
        },
        "geo_id": "0500000US06077",
        "level": "county",
        "name": "San Joaquin County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06077:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "787416"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "079",
          "state": "06"
        },
        "geo_id": "0500000US06079",
        "level": "county",
        "name": "San Luis Obispo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06079:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "281486"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "081",
          "state": "06"
        },
        "geo_id": "0500000US06081",
        "level": "county",
        "name": "San Mateo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06081:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "745100"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "083",
          "state": "06"
        },
        "geo_id": "0500000US06083",
        "level": "county",
        "name": "Santa Barbara County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06083:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "443975"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "085",
          "state": "06"
        },
        "geo_id": "0500000US06085",
        "level": "county",
        "name": "Santa Clara County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06085:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1903297"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "087",
          "state": "06"
        },
        "geo_id": "0500000US06087",
        "level": "county",
        "name": "Santa Cruz County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06087:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "266021"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "089",
          "state": "06"
        },
        "geo_id": "0500000US06089",
        "level": "county",
        "name": "Shasta County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06089:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "181554"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "091",
          "state": "06"
        },
        "geo_id": "0500000US06091",
        "level": "county",
        "name": "Sierra County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06091:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "2731"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "093",
          "state": "06"
        },
        "geo_id": "0500000US06093",
        "level": "county",
        "name": "Siskiyou County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06093:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "43834"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "095",
          "state": "06"
        },
        "geo_id": "0500000US06095",
        "level": "county",
        "name": "Solano County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06095:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "450824"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "097",
          "state": "06"
        },
        "geo_id": "0500000US06097",
        "level": "county",
        "name": "Sonoma County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06097:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "485642"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "099",
          "state": "06"
        },
        "geo_id": "0500000US06099",
        "level": "county",
        "name": "Stanislaus County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06099:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "552250"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "101",
          "state": "06"
        },
        "geo_id": "0500000US06101",
        "level": "county",
        "name": "Sutter County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06101:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "98971"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "103",
          "state": "06"
        },
        "geo_id": "0500000US06103",
        "level": "county",
        "name": "Tehama County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06103:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "65520"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "105",
          "state": "06"
        },
        "geo_id": "0500000US06105",
        "level": "county",
        "name": "Trinity County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06105:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "15886"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "107",
          "state": "06"
        },
        "geo_id": "0500000US06107",
        "level": "county",
        "name": "Tulare County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06107:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "475774"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "109",
          "state": "06"
        },
        "geo_id": "0500000US06109",
        "level": "county",
        "name": "Tuolumne County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06109:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "54873"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "111",
          "state": "06"
        },
        "geo_id": "0500000US06111",
        "level": "county",
        "name": "Ventura County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06111:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "838259"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "113",
          "state": "06"
        },
        "geo_id": "0500000US06113",
        "level": "county",
        "name": "Yolo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06113:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "217782"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "115",
          "state": "06"
        },
        "geo_id": "0500000US06115",
        "level": "county",
        "name": "Yuba County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06115:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "83079"
      },
      "vintage": 2023
    }
  ],
  "retrieved_at": "2026-09-11T00:00:00Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.census.gov/api/access/data/table?id=ACSDT5Y2023.B01003&g=0400000US06$0500000",
  "source_urls": [
    "https://data.census.gov/api/access/data/table?id=ACSDT5Y2023.B01003&g=0400000US06$0500000"
  ],
  "tables": [
    "ACSDT5Y2023.B01003"
  ],
  "total": 58,
  "variables": [
    {
      "attributes": [],
      "concept": "Total Population",
      "group": "B01003",
      "label": "Estimate!!Total",
      "limit": 0,
      "name": "B01003_001E",
      "predicate_only": true,
      "predicate_type": "int",
      "scale": null,
      "source_url": "https://api.census.gov/data/2023/acs/acs5/groups/B01003.json",
      "unit": null
    }
  ],
  "vintage": 2023,
  "warnings": []
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Data

- Capability: `census/data`
- Description: 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']). Returns one row per geography with values as published, sentinels turned into null plus annotation, FIPS parts, variable metadata with units, and the equivalent api.census.gov URL. Unknown variables are rejected with invalid_input naming them.
- Instructions: 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']). Returns one row per geography with values as published, sentinels turned into null plus annotation, FIPS parts, variable metadata with units, and the equivalent api.census.gov URL. Unknown variables are rejected with invalid_input naming them.
- Cost: 5 credits per call
- Capability file: [Data](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/data)

Accepted options:
- `cursor` (string): cursor Example: `<cursor>`
- `dataset` (string, required): dataset Example: `acs/acs5`
- `geography` (object, required): geography Example: `{}`
- `page_size` (number): page_size Example: `500`
- `predicates` (object): Exact-match filters on any returned column, e.g. {"NAICS2017": "00", "EMPSZES": "001"} for CBP or {"DATE_CODE": "12"} for PEP. Example: `{}`
- `variables` (string[], required): 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). Example: `[]`
- `vintage` (number, required): vintage Example: `2000`

Response schema example:
```json
{
  "complete": true,
  "count": 58,
  "dataset": "acs/acs5",
  "geography": {
    "for": "county:*",
    "geo_strings": [
      "0400000US06$0500000"
    ],
    "in": [
      "state:06"
    ],
    "level": "county"
  },
  "next_cursor": null,
  "observed_at_ms": 1789084800000,
  "records": [
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "001",
          "state": "06"
        },
        "geo_id": "0500000US06001",
        "level": "county",
        "name": "Alameda County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06001:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1651949"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "003",
          "state": "06"
        },
        "geo_id": "0500000US06003",
        "level": "county",
        "name": "Alpine County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06003:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1695"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "005",
          "state": "06"
        },
        "geo_id": "0500000US06005",
        "level": "county",
        "name": "Amador County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06005:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "41029"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "007",
          "state": "06"
        },
        "geo_id": "0500000US06007",
        "level": "county",
        "name": "Butte County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06007:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "209470"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "009",
          "state": "06"
        },
        "geo_id": "0500000US06009",
        "level": "county",
        "name": "Calaveras County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06009:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "45995"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "011",
          "state": "06"
        },
        "geo_id": "0500000US06011",
        "level": "county",
        "name": "Colusa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06011:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "21895"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "013",
          "state": "06"
        },
        "geo_id": "0500000US06013",
        "level": "county",
        "name": "Contra Costa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06013:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1161458"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "015",
          "state": "06"
        },
        "geo_id": "0500000US06015",
        "level": "county",
        "name": "Del Norte County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06015:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "27293"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "017",
          "state": "06"
        },
        "geo_id": "0500000US06017",
        "level": "county",
        "name": "El Dorado County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06017:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "192299"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "019",
          "state": "06"
        },
        "geo_id": "0500000US06019",
        "level": "county",
        "name": "Fresno County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06019:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1012152"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "021",
          "state": "06"
        },
        "geo_id": "0500000US06021",
        "level": "county",
        "name": "Glenn County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06021:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "28623"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "023",
          "state": "06"
        },
        "geo_id": "0500000US06023",
        "level": "county",
        "name": "Humboldt County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06023:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "135418"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "025",
          "state": "06"
        },
        "geo_id": "0500000US06025",
        "level": "county",
        "name": "Imperial County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06025:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "179319"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "027",
          "state": "06"
        },
        "geo_id": "0500000US06027",
        "level": "county",
        "name": "Inyo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06027:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "18803"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "029",
          "state": "06"
        },
        "geo_id": "0500000US06029",
        "level": "county",
        "name": "Kern County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06029:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "910433"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "031",
          "state": "06"
        },
        "geo_id": "0500000US06031",
        "level": "county",
        "name": "Kings County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06031:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "152830"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "033",
          "state": "06"
        },
        "geo_id": "0500000US06033",
        "level": "county",
        "name": "Lake County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06033:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "68139"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "035",
          "state": "06"
        },
        "geo_id": "0500000US06035",
        "level": "county",
        "name": "Lassen County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06035:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "31177"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "037",
          "state": "06"
        },
        "geo_id": "0500000US06037",
        "level": "county",
        "name": "Los Angeles County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06037:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "9848406"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "039",
          "state": "06"
        },
        "geo_id": "0500000US06039",
        "level": "county",
        "name": "Madera County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06039:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "158790"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "041",
          "state": "06"
        },
        "geo_id": "0500000US06041",
        "level": "county",
        "name": "Marin County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06041:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "258765"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "043",
          "state": "06"
        },
        "geo_id": "0500000US06043",
        "level": "county",
        "name": "Mariposa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06043:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "17060"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "045",
          "state": "06"
        },
        "geo_id": "0500000US06045",
        "level": "county",
        "name": "Mendocino County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06045:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "90709"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "047",
          "state": "06"
        },
        "geo_id": "0500000US06047",
        "level": "county",
        "name": "Merced County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06047:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "285597"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "049",
          "state": "06"
        },
        "geo_id": "0500000US06049",
        "level": "county",
        "name": "Modoc County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06049:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "8646"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "051",
          "state": "06"
        },
        "geo_id": "0500000US06051",
        "level": "county",
        "name": "Mono County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06051:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "13169"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "053",
          "state": "06"
        },
        "geo_id": "0500000US06053",
        "level": "county",
        "name": "Monterey County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06053:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "435834"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "055",
          "state": "06"
        },
        "geo_id": "0500000US06055",
        "level": "county",
        "name": "Napa County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06055:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "136070"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "057",
          "state": "06"
        },
        "geo_id": "0500000US06057",
        "level": "county",
        "name": "Nevada County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06057:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "102452"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "059",
          "state": "06"
        },
        "geo_id": "0500000US06059",
        "level": "county",
        "name": "Orange County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06059:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "3164063"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "061",
          "state": "06"
        },
        "geo_id": "0500000US06061",
        "level": "county",
        "name": "Placer County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06061:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "412435"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "063",
          "state": "06"
        },
        "geo_id": "0500000US06063",
        "level": "county",
        "name": "Plumas County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06063:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "19607"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "065",
          "state": "06"
        },
        "geo_id": "0500000US06065",
        "level": "county",
        "name": "Riverside County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06065:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "2449909"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "067",
          "state": "06"
        },
        "geo_id": "0500000US06067",
        "level": "county",
        "name": "Sacramento County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06067:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1584047"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "069",
          "state": "06"
        },
        "geo_id": "0500000US06069",
        "level": "county",
        "name": "San Benito County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06069:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "66056"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "071",
          "state": "06"
        },
        "geo_id": "0500000US06071",
        "level": "county",
        "name": "San Bernardino County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06071:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "2187816"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "073",
          "state": "06"
        },
        "geo_id": "0500000US06073",
        "level": "county",
        "name": "San Diego County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06073:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "3282782"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "075",
          "state": "06"
        },
        "geo_id": "0500000US06075",
        "level": "county",
        "name": "San Francisco County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06075:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "836321"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "077",
          "state": "06"
        },
        "geo_id": "0500000US06077",
        "level": "county",
        "name": "San Joaquin County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06077:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "787416"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "079",
          "state": "06"
        },
        "geo_id": "0500000US06079",
        "level": "county",
        "name": "San Luis Obispo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06079:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "281486"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "081",
          "state": "06"
        },
        "geo_id": "0500000US06081",
        "level": "county",
        "name": "San Mateo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06081:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "745100"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "083",
          "state": "06"
        },
        "geo_id": "0500000US06083",
        "level": "county",
        "name": "Santa Barbara County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06083:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "443975"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "085",
          "state": "06"
        },
        "geo_id": "0500000US06085",
        "level": "county",
        "name": "Santa Clara County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06085:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "1903297"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "087",
          "state": "06"
        },
        "geo_id": "0500000US06087",
        "level": "county",
        "name": "Santa Cruz County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06087:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "266021"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "089",
          "state": "06"
        },
        "geo_id": "0500000US06089",
        "level": "county",
        "name": "Shasta County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06089:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "181554"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "091",
          "state": "06"
        },
        "geo_id": "0500000US06091",
        "level": "county",
        "name": "Sierra County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06091:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "2731"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "093",
          "state": "06"
        },
        "geo_id": "0500000US06093",
        "level": "county",
        "name": "Siskiyou County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06093:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "43834"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "095",
          "state": "06"
        },
        "geo_id": "0500000US06095",
        "level": "county",
        "name": "Solano County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06095:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "450824"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "097",
          "state": "06"
        },
        "geo_id": "0500000US06097",
        "level": "county",
        "name": "Sonoma County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06097:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "485642"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "099",
          "state": "06"
        },
        "geo_id": "0500000US06099",
        "level": "county",
        "name": "Stanislaus County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06099:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "552250"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "101",
          "state": "06"
        },
        "geo_id": "0500000US06101",
        "level": "county",
        "name": "Sutter County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06101:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "98971"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "103",
          "state": "06"
        },
        "geo_id": "0500000US06103",
        "level": "county",
        "name": "Tehama County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06103:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "65520"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "105",
          "state": "06"
        },
        "geo_id": "0500000US06105",
        "level": "county",
        "name": "Trinity County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06105:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "15886"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "107",
          "state": "06"
        },
        "geo_id": "0500000US06107",
        "level": "county",
        "name": "Tulare County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06107:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "475774"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "109",
          "state": "06"
        },
        "geo_id": "0500000US06109",
        "level": "county",
        "name": "Tuolumne County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06109:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "54873"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "111",
          "state": "06"
        },
        "geo_id": "0500000US06111",
        "level": "county",
        "name": "Ventura County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06111:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "838259"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "113",
          "state": "06"
        },
        "geo_id": "0500000US06113",
        "level": "county",
        "name": "Yolo County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06113:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "217782"
      },
      "vintage": 2023
    },
    {
      "annotations": {},
      "dataset": "acs/acs5",
      "geo": {
        "fips": {
          "county": "115",
          "state": "06"
        },
        "geo_id": "0500000US06115",
        "level": "county",
        "name": "Yuba County, California",
        "sumlevel": "050"
      },
      "record_id": "acs/acs5:2023:0500000US06115:1",
      "release": {
        "dataset": "acs/acs5",
        "tables": [
          "B01003"
        ],
        "vintage": 2023
      },
      "source_flags": {},
      "source_url": "https://api.census.gov/data/2023/acs/acs5?get=group(B01003)&ucgid=pseudo(0400000US06$0500000)",
      "values": {
        "B01003_001E": "83079"
      },
      "vintage": 2023
    }
  ],
  "retrieved_at": "2026-09-11T00:00:00Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.census.gov/api/access/data/table?id=ACSDT5Y2023.B01003&g=0400000US06$0500000",
  "source_urls": [
    "https://data.census.gov/api/access/data/table?id=ACSDT5Y2023.B01003&g=0400000US06$0500000"
  ],
  "tables": [
    "ACSDT5Y2023.B01003"
  ],
  "total": 58,
  "variables": [
    {
      "attributes": [],
      "concept": "Total Population",
      "group": "B01003",
      "label": "Estimate!!Total",
      "limit": 0,
      "name": "B01003_001E",
      "predicate_only": true,
      "predicate_type": "int",
      "scale": null,
      "source_url": "https://api.census.gov/data/2023/acs/acs5/groups/B01003.json",
      "unit": null
    }
  ],
  "vintage": 2023,
  "warnings": []
}
```

### Datasets

- Capability: `census/datasets`
- Description: Search the Census Data API catalog. Input: free-text query over dataset path, title and description plus an optional vintage (year). Returns one record per dataset/vintage with its API endpoint, metadata links, publication date and supported geography levels.
- Instructions: Search the Census Data API catalog. Input: free-text query over dataset path, title and description plus an optional vintage (year). Returns one record per dataset/vintage with its API endpoint, metadata links, publication date and supported geography levels.
- Cost: 5 credits per call
- Capability file: [Datasets](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/datasets)

Accepted options:
- `cursor` (string): next_cursor from the previous page. Example: `<cursor>`
- `page_size` (number): page_size Example: `20`
- `query` (string): Case-insensitive tokens all of which must appear in the dataset path, title or description. Required (>= 2 characters) when vintage is null. Example: `<query>`
- `vintage` (number): Restrict to one vintage year (reads api.census.gov/data/{vintage}.json, ~0.5 s). Null searches the whole catalog (~5 MB, 5-10 s). Example: `2000`

Response schema example:
```json
{
  "complete": true,
  "count": 1,
  "next_cursor": null,
  "observed_at_ms": 1789084800000,
  "query": "acs5",
  "records": [
    {
      "dataset": "acs/acs5",
      "description": "The American Community Survey (ACS) is an ongoing survey that provides data every year -- giving communities the current information they need to plan investments and services. The ACS covers a broad range of topics about social, economic, demographic, and housing characteristics of the U.S. population. Summary files include the following geographies: nation, all states (including DC and Puerto Rico), all metropolitan areas, all congressional districts, all counties, all places, and all tracts and block groups. Summary files contain the most detailed cross-tabulations, many of which are published down to block groups. The data are population and housing counts. There are over 64,000 variables in this dataset.",
      "examples_url": "https://api.census.gov/data/2023/acs/acs5/examples.json",
      "geography_levels": [
        "us",
        "region",
        "division",
        "state",
        "county",
        "county subdivision",
        "subminor civil division",
        "place/remainder (or part)",
        "tract",
        "block group",
        "county (or part)",
        "place",
        "consolidated city",
        "place (or part)",
        "alaska native regional corporation",
        "american indian area/alaska native area/hawaiian home land",
        "tribal subdivision/remainder",
        "american indian area/alaska native area (reservation or statistical entity only)",
        "american indian area (off-reservation trust land only)/hawaiian home land",
        "tribal census tract",
        "tribal block group",
        "state (or part)",
        "place/remainder (or part)",
        "county (or part)",
        "american indian area/alaska native area/hawaiian home land (or part)",
        "american indian area/alaska native area (reservation or statistical entity only) (or part)",
        "american indian area (off-reservation trust land only)/hawaiian home land (or part)",
        "state (or part)",
        "tribal census tract (or part)",
        "tribal census tract (or part)",
        "tribal block group (or part)",
        "tribal block group (or part)",
        "metropolitan statistical area/micropolitan statistical area",
        "state (or part)",
        "principal city (or part)",
        "county",
        "metropolitan division",
        "state (or part)",
        "county",
        "metropolitan statistical area/micropolitan statistical area (or part)",
        "principal city (or part)",
        "county",
        "metropolitan division (or part)",
        "county",
        "combined statistical area",
        "state (or part)",
        "metropolitan statistical area/micropolitan statistical area",
        "state (or part)",
        "combined statistical area (or part)",
        "metropolitan statistical area/micropolitan statistical area (or part)",
        "urban area",
        "state (or part)",
        "county (or part)",
        "congressional district",
        "county (or part)",
        "american indian area/alaska native area/hawaiian home land (or part)",
        "state legislative district (upper chamber)",
        "county (or part)",
        "state legislative district (lower chamber)",
        "county (or part)",
        "public use microdata area",
        "zip code tabulation area",
        "school district (elementary)",
        "school district (secondary)",
        "school district (unified)"
      ],
      "geography_url": "https://api.census.gov/data/2023/acs/acs5/geography.json",
      "groups_url": "https://api.census.gov/data/2023/acs/acs5/groups.json",
      "identifier": "https://api.census.gov/data/id/ACSDT5Y2023",
      "is_aggregate": true,
      "is_available": true,
      "is_microdata": false,
      "is_timeseries": false,
      "license": "https://creativecommons.org/publicdomain/zero/1.0/",
      "modified": "2024-09-06T17:27:47Z",
      "source_url": "https://api.census.gov/data/2023/acs/acs5",
      "supported_by_data": true,
      "title": "ACS 5-Year Detailed Tables",
      "variables_url": "https://api.census.gov/data/2023/acs/acs5/variables.json",
      "vintage": 2023
    }
  ],
  "retrieved_at": "2026-09-11T00:00:00Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://api.census.gov/data/2023.json",
  "total": 1,
  "vintage": 2023,
  "warnings": []
}
```

### Geographies

- Capability: `census/geographies`
- Description: Geography resolver. Input: a place, county, state, tract or other geography name (e.g. 'Travis County, Texas'). Returns matching Census geographies with summary level, GEO_ID, FIPS parts and the exact `for`/`in` predicates to pass to `data`.
- Instructions: Geography resolver. Input: a place, county, state, tract or other geography name (e.g. 'Travis County, Texas'). Returns matching Census geographies with summary level, GEO_ID, FIPS parts and the exact `for`/`in` predicates to pass to `data`.
- Cost: 5 credits per call
- Capability file: [Geographies](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/geographies)

Accepted options:
- `level` (string): Keep only this summary level: us, region, division, state, county, county subdivision, tract, block group, place, metropolitan statistical area/micropolitan statistical area, combined statistical area, urban area, public use microdata area, zip code tabulation area, school district (unified), american indian area/alaska native area/hawaiian home land. Example: `<level>`
- `limit` (number): limit Example: `10`
- `query` (string, required): query Example: `<query>`

Response schema example:
```json
{
  "complete": false,
  "count": 4,
  "level": null,
  "next_cursor": null,
  "observed_at_ms": 1789084800000,
  "query": "San Francisco",
  "records": [
    {
      "fips": {
        "county": "075",
        "state": "06"
      },
      "for": "county:075",
      "geo_id": "0500000US06075",
      "in": [
        "state:06"
      ],
      "level": "county",
      "record_id": "0500000US06075",
      "selected": true,
      "source_url": "https://data.census.gov/api/search?q=San%20Francisco&services=geos&size=10",
      "sumlevel": "050",
      "title": "San Francisco County, California",
      "ucgid": "050XX00US06075"
    },
    {
      "fips": {
        "county": "075",
        "county_subdivision": "92790",
        "state": "06"
      },
      "for": "county subdivision:92790",
      "geo_id": "0600000US0607592790",
      "in": [
        "state:06",
        "county:075"
      ],
      "level": "county subdivision",
      "record_id": "0600000US0607592790",
      "selected": false,
      "source_url": "https://data.census.gov/api/search?q=San%20Francisco&services=geos&size=10",
      "sumlevel": "060",
      "title": "San Francisco CCD, San Francisco County, California",
      "ucgid": "060XX00US0607592790"
    },
    {
      "fips": {
        "county": "019",
        "county_subdivision": "58486",
        "state": "27"
      },
      "for": "county subdivision:58486",
      "geo_id": "0600000US2701958486",
      "in": [
        "state:27",
        "county:019"
      ],
      "level": "county subdivision",
      "record_id": "0600000US2701958486",
      "selected": false,
      "source_url": "https://data.census.gov/api/search?q=San%20Francisco&services=geos&size=10",
      "sumlevel": "060",
      "title": "San Francisco township, Carver County, Minnesota",
      "ucgid": "060XX00US2701958486"
    },
    {
      "fips": {
        "place": "67000",
        "state": "06"
      },
      "for": "place:67000",
      "geo_id": "1600000US0667000",
      "in": [
        "state:06"
      ],
      "level": "place",
      "record_id": "1600000US0667000",
      "selected": false,
      "source_url": "https://data.census.gov/api/search?q=San%20Francisco&services=geos&size=10",
      "sumlevel": "160",
      "title": "San Francisco city, California",
      "ucgid": "160XX00US0667000"
    }
  ],
  "retrieved_at": "2026-09-11T00:00:00Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://data.census.gov/api/search?q=San%20Francisco&services=geos&size=10",
  "warnings": [
    "skipped `San Francisco city, California` (E600000US0607567000): summary level not supported by `data`"
  ]
}
```

### Popest get

- Capability: `census/popest_get`
- Description: One PEP geography by its own codes, as its estimate-year records (same shape as popest_list). counties: state + county (county omitted or 000 = the state row). subcounty: the per-state file; select by place (default SUMLEV 162, or 157 together with county), cousub + county (SUMLEV 061), concit, or an explicit sumlev; nothing but state = the state row. More than one matching row is invalid_input asking for sumlev; none is not_found.
- Instructions: Fetch one county (Gallatin County 30 031) or one place (Billings city, place 06550) with every estimate year.
- Cost: 5 credits per call
- Capability file: [Popest get](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/popest_get)

Accepted options:
- `concit` (string): 5-digit consolidated city FIPS (subcounty). Pattern: ^[0-9]{5}$. Example: `<concit>`
- `county` (string): 3-digit county FIPS. Pattern: ^[0-9]{3}$. Example: `<county>`
- `cousub` (string): 5-digit county subdivision FIPS (subcounty; needs county). Pattern: ^[0-9]{5}$. Example: `<cousub>`
- `file` (string, required): counties: counties/totals/co-est<YYYY>-alldata.csv (states and counties). subcounty: cities/totals/sub-est<YYYY>.csv (national, ~7.5 MB) or, with state, sub-est<YYYY>_<state>.csv. Example: `counties`
- `place` (string): 5-digit place FIPS (subcounty). Pattern: ^[0-9]{5}$. Example: `<place>`
- `state` (string, required): 2-digit state FIPS (30 = Montana). Pattern: ^[0-9]{2}$. Example: `<state>`
- `sumlev` (string): Summary level when the codes alone are ambiguous (e.g. 157 vs 162). Pattern: ^[0-9]{3}$. Example: `<sumlev>`
- `vintage` (number): Vintage year YYYY of the 2020-YYYY directory. Default: the newest directory listed under popest/datasets/. Example: `2021`

Response schema example:
```json
{
  "content_hash": "4f5a499d851e2cb48fd7a5405e5a9235453a8a66933657aacd10df0e264f35d5",
  "count": 6,
  "file": "counties",
  "file_name": "co-est2025-alldata.csv",
  "file_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
  "geography": {
    "concit": null,
    "county": "031",
    "cousub": null,
    "geo_id": "30031",
    "name": "Gallatin County",
    "place": null,
    "state": "30",
    "sumlev": "050"
  },
  "hash_source": "sha256:raw_file_bytes",
  "last_modified": "2026-03-26T12:15:28Z",
  "observed_at_ms": 1792345644519,
  "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
  "records": [
    {
      "births": 290,
      "county": "031",
      "ctyname": "Gallatin County",
      "deaths": 133,
      "division": "8",
      "domesticmig": 489,
      "estimates_base_2020": 118957,
      "file": "counties",
      "geo_id": "30031",
      "gqestimates": 4148,
      "gqestimates_base_2020": 4158,
      "internationalmig": 7,
      "naturalchg": 157,
      "netmig": 496,
      "npopchg": 636,
      "popestimate": 119593,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": null,
      "rdeath": null,
      "rdomesticmig": null,
      "region": "4",
      "residual": -17,
      "retrieved_at": "2026-10-18T17:47:24Z",
      "rinternationalmig": null,
      "rnaturalchg": null,
      "rnetmig": null,
      "source_record_id": "v2025:counties:050:30031:2020",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "050",
      "vintage": 2025,
      "year": 2020
    },
    {
      "births": 1196,
      "county": "031",
      "ctyname": "Gallatin County",
      "deaths": 649,
      "division": "8",
      "domesticmig": 2944,
      "estimates_base_2020": 118957,
      "file": "counties",
      "geo_id": "30031",
      "gqestimates": 4138,
      "gqestimates_base_2020": 4158,
      "internationalmig": 131,
      "naturalchg": 547,
      "netmig": 3075,
      "npopchg": 3510,
      "popestimate": 123103,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.855951478,
      "rdeath": 5.348254607,
      "rdomesticmig": 24.26080364,
      "region": "4",
      "residual": -112,
      "retrieved_at": "2026-10-18T17:47:24Z",
      "rinternationalmig": 1.079539836,
      "rnaturalchg": 4.507696872,
      "rnetmig": 25.34034348,
      "source_record_id": "v2025:counties:050:30031:2021",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "050",
      "vintage": 2025,
      "year": 2021
    },
    {
      "births": 1224,
      "county": "031",
      "ctyname": "Gallatin County",
      "deaths": 709,
      "division": "8",
      "domesticmig": 883,
      "estimates_base_2020": 118957,
      "file": "counties",
      "geo_id": "30031",
      "gqestimates": 4162,
      "gqestimates_base_2020": 4158,
      "internationalmig": 189,
      "naturalchg": 515,
      "netmig": 1072,
      "npopchg": 1610,
      "popestimate": 124713,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.878296801,
      "rdeath": 5.721987281,
      "rdomesticmig": 7.126254963,
      "region": "4",
      "residual": 23,
      "retrieved_at": "2026-10-18T17:47:24Z",
      "rinternationalmig": 1.525325241,
      "rnaturalchg": 4.15630952,
      "rnetmig": 8.651580205,
      "source_record_id": "v2025:counties:050:30031:2022",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "050",
      "vintage": 2025,
      "year": 2022
    },
    {
      "births": 1122,
      "county": "031",
      "ctyname": "Gallatin County",
      "deaths": 710,
      "division": "8",
      "domesticmig": 639,
      "estimates_base_2020": 118957,
      "file": "counties",
      "geo_id": "30031",
      "gqestimates": 4164,
      "gqestimates_base_2020": 4158,
      "internationalmig": 175,
      "naturalchg": 412,
      "netmig": 814,
      "npopchg": 1239,
      "popestimate": 125952,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 8.952187182,
      "rdeath": 5.664931283,
      "rdomesticmig": 5.098438155,
      "region": "4",
      "residual": 13,
      "retrieved_at": "2026-10-18T17:47:24Z",
      "rinternationalmig": 1.39628588,
      "rnaturalchg": 3.287255899,
      "rnetmig": 6.494724034,
      "source_record_id": "v2025:counties:050:30031:2023",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "050",
      "vintage": 2025,
      "year": 2023
    },
    {
      "births": 1217,
      "county": "031",
      "ctyname": "Gallatin County",
      "deaths": 707,
      "division": "8",
      "domesticmig": 424,
      "estimates_base_2020": 118957,
      "file": "counties",
      "geo_id": "30031",
      "gqestimates": 4163,
      "gqestimates_base_2020": 4158,
      "internationalmig": 605,
      "naturalchg": 510,
      "netmig": 1029,
      "npopchg": 1546,
      "popestimate": 127498,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.603472085,
      "rdeath": 5.579009667,
      "rdomesticmig": 3.345827579,
      "region": "4",
      "residual": 7,
      "retrieved_at": "2026-10-18T17:47:24Z",
      "rinternationalmig": 4.774117183,
      "rnaturalchg": 4.024462419,
      "rnetmig": 8.119944762,
      "source_record_id": "v2025:counties:050:30031:2024",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "050",
      "vintage": 2025,
      "year": 2024
    },
    {
      "births": 1137,
      "county": "031",
      "ctyname": "Gallatin County",
      "deaths": 700,
      "division": "8",
      "domesticmig": 545,
      "estimates_base_2020": 118957,
      "file": "counties",
      "geo_id": "30031",
      "gqestimates": 4162,
      "gqestimates_base_2020": 4158,
      "internationalmig": 254,
      "naturalchg": 437,
      "netmig": 799,
      "npopchg": 1242,
      "popestimate": 128740,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 8.874561931,
      "rdeath": 5.463670494,
      "rdomesticmig": 4.253857742,
      "region": "4",
      "residual": 6,
      "retrieved_at": "2026-10-18T17:47:24Z",
      "rinternationalmig": 1.982531865,
      "rnaturalchg": 3.410891437,
      "rnetmig": 6.236389607,
      "source_record_id": "v2025:counties:050:30031:2025",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "050",
      "vintage": 2025,
      "year": 2025
    }
  ],
  "retrieved_at": "2026-10-18T17:47:24Z",
  "size_bytes": 2071735,
  "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
  "vintage": 2025,
  "vintage_directory": "2020-2025",
  "years": [
    2020,
    2021,
    2022,
    2023,
    2024,
    2025
  ]
}
```

### Popest list

- Capability: `census/popest_list`
- Description: List Vintage 2020-YYYY population estimates from one PEP file as one record per geography and estimate year: counties (SUMLEV 040 states and 050 counties; components of change, group quarters and per-1,000 rates) or subcounty (places, county subdivisions, consolidated cities; population only). The whole file is fetched per call (2.1 MB counties, 7.5 MB national subcounty, ~30 KB per state) and paged from memory; the cursor pins vintage, file, Last-Modified and size and a changed file fails with publication_changed. source_record_id = v<vintage>:<file>:<sumlev>:<geo_id>:<year>. Names are decoded from Latin-1.
- Instructions: Full collection of county or sub-county population estimates (annual population, births, deaths, migration) for a vintage, optionally for one state.
- Cost: 5 credits per call
- Capability file: [Popest list](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/popest_list)

Accepted options:
- `continuation` (string): Opaque cursor from the previous page's next_cursor. It pins the vintage, file, Last-Modified and size; when the source has moved on the call fails with invalid_input at /continuation (issue code publication_changed) instead of mixing versions. Example: `<continuation>`
- `file` (string, required): counties: counties/totals/co-est<YYYY>-alldata.csv (states and counties). subcounty: cities/totals/sub-est<YYYY>.csv (national, ~7.5 MB) or, with state, sub-est<YYYY>_<state>.csv. Example: `counties`
- `page_size` (number): Records (geography-years) per page; default 500. Example: `10`
- `state` (string): Optional 2-digit state FIPS. counties: keeps that state's rows (state row included). subcounty: reads the per-state file sub-est<YYYY>_<n>.csv instead of the national file. Pattern: ^[0-9]{2}$. Example: `<state>`
- `sumlev` (string): Optional summary level filter (050 counties only, 162 incorporated places, 061 county subdivisions ...). Pattern: ^[0-9]{3}$. Example: `<sumlev>`
- `vintage` (number): Vintage year YYYY of the 2020-YYYY directory. Default: the newest directory listed under popest/datasets/. Example: `2021`

Response schema example:
```json
{
  "content_hash": "4f5a499d851e2cb48fd7a5405e5a9235453a8a66933657aacd10df0e264f35d5",
  "count": 6,
  "file": "counties",
  "file_name": "co-est2025-alldata.csv",
  "file_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
  "has_more": true,
  "hash_source": "sha256:raw_file_bytes",
  "last_modified": "2026-03-26T12:15:28Z",
  "next_cursor": "pep1|2025|counties|30|-|2026-03-26T12:15:28Z|2071735|6",
  "observed_at_ms": 1792345660693,
  "offset": 0,
  "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
  "records": [
    {
      "births": 2824,
      "county": "000",
      "ctyname": "Montana",
      "deaths": 2535,
      "division": "8",
      "domesticmig": 2715,
      "estimates_base_2020": 1084221,
      "file": "counties",
      "geo_id": "30000",
      "gqestimates": 29261,
      "gqestimates_base_2020": 29285,
      "internationalmig": 42,
      "naturalchg": 289,
      "netmig": 2757,
      "npopchg": 2935,
      "popestimate": 1087156,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": null,
      "rdeath": null,
      "rdomesticmig": null,
      "region": "4",
      "residual": -111,
      "retrieved_at": "2026-10-18T17:47:40Z",
      "rinternationalmig": null,
      "rnaturalchg": null,
      "rnetmig": null,
      "source_record_id": "v2025:counties:040:30000:2020",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "040",
      "vintage": 2025,
      "year": 2020
    },
    {
      "births": 10851,
      "county": "000",
      "ctyname": "Montana",
      "deaths": 12271,
      "division": "8",
      "domesticmig": 20693,
      "estimates_base_2020": 1084221,
      "file": "counties",
      "geo_id": "30000",
      "gqestimates": 29271,
      "gqestimates_base_2020": 29285,
      "internationalmig": 712,
      "naturalchg": -1420,
      "netmig": 21405,
      "npopchg": 19260,
      "popestimate": 1106416,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.893452323,
      "rdeath": 11.18814427,
      "rdomesticmig": 18.86694396,
      "region": "4",
      "residual": -725,
      "retrieved_at": "2026-10-18T17:47:40Z",
      "rinternationalmig": 0.649169483,
      "rnaturalchg": -1.294691945,
      "rnetmig": 19.51611344,
      "source_record_id": "v2025:counties:040:30000:2021",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "040",
      "vintage": 2025,
      "year": 2021
    },
    {
      "births": 11210,
      "county": "000",
      "ctyname": "Montana",
      "deaths": 12991,
      "division": "8",
      "domesticmig": 15474,
      "estimates_base_2020": 1084221,
      "file": "counties",
      "geo_id": "30000",
      "gqestimates": 29239,
      "gqestimates_base_2020": 29285,
      "internationalmig": 798,
      "naturalchg": -1781,
      "netmig": 16272,
      "npopchg": 15117,
      "popestimate": 1121533,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 10.06306697,
      "rdeath": 11.66184684,
      "rdomesticmig": 13.89080271,
      "region": "4",
      "residual": 626,
      "retrieved_at": "2026-10-18T17:47:40Z",
      "rinternationalmig": 0.71635392,
      "rnaturalchg": -1.598779864,
      "rnetmig": 14.60715663,
      "source_record_id": "v2025:counties:040:30000:2022",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "040",
      "vintage": 2025,
      "year": 2022
    },
    {
      "births": 11027,
      "county": "000",
      "ctyname": "Montana",
      "deaths": 11433,
      "division": "8",
      "domesticmig": 9017,
      "estimates_base_2020": 1084221,
      "file": "counties",
      "geo_id": "30000",
      "gqestimates": 29265,
      "gqestimates_base_2020": 29285,
      "internationalmig": 412,
      "naturalchg": -406,
      "netmig": 9429,
      "npopchg": 9079,
      "popestimate": 1130612,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.792442316,
      "rdeath": 10.15298749,
      "rdomesticmig": 8.007477316,
      "region": "4",
      "residual": 56,
      "retrieved_at": "2026-10-18T17:47:40Z",
      "rinternationalmig": 0.365873423,
      "rnaturalchg": -0.360545169,
      "rnetmig": 8.373350739,
      "source_record_id": "v2025:counties:040:30000:2023",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "040",
      "vintage": 2025,
      "year": 2023
    },
    {
      "births": 11294,
      "county": "000",
      "ctyname": "Montana",
      "deaths": 11517,
      "division": "8",
      "domesticmig": 5263,
      "estimates_base_2020": 1084221,
      "file": "counties",
      "geo_id": "30000",
      "gqestimates": 29332,
      "gqestimates_base_2020": 29285,
      "internationalmig": 1929,
      "naturalchg": -223,
      "netmig": 7192,
      "npopchg": 6945,
      "popestimate": 1137557,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.958693554,
      "rdeath": 10.15532793,
      "rdomesticmig": 4.640747669,
      "region": "4",
      "residual": -24,
      "retrieved_at": "2026-10-18T17:47:40Z",
      "rinternationalmig": 1.700931456,
      "rnaturalchg": -0.196634378,
      "rnetmig": 6.341679125,
      "source_record_id": "v2025:counties:040:30000:2024",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "040",
      "vintage": 2025,
      "year": 2024
    },
    {
      "births": 11348,
      "county": "000",
      "ctyname": "Montana",
      "deaths": 11438,
      "division": "8",
      "domesticmig": 6348,
      "estimates_base_2020": 1084221,
      "file": "counties",
      "geo_id": "30000",
      "gqestimates": 29282,
      "gqestimates_base_2020": 29285,
      "internationalmig": 899,
      "naturalchg": -90,
      "netmig": 7247,
      "npopchg": 7137,
      "popestimate": 1144694,
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "rbirth": 9.944567885,
      "rdeath": 10.02343739,
      "rdomesticmig": 5.56292888,
      "region": "4",
      "residual": -20,
      "retrieved_at": "2026-10-18T17:47:40Z",
      "rinternationalmig": 0.787818693,
      "rnaturalchg": -0.078869502,
      "rnetmig": 6.350747573,
      "source_record_id": "v2025:counties:040:30000:2025",
      "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
      "state": "30",
      "stname": "Montana",
      "sumlev": "040",
      "vintage": 2025,
      "year": 2025
    }
  ],
  "retrieved_at": "2026-10-18T17:47:40Z",
  "size_bytes": 2071735,
  "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv",
  "state": "30",
  "sumlev": null,
  "total_geographies": 57,
  "total_records": 342,
  "vintage": 2025,
  "vintage_directory": "2020-2025",
  "years": [
    2020,
    2021,
    2022,
    2023,
    2024,
    2025
  ]
}
```

### Popest status

- Capability: `census/popest_status`
- Description: Cheap version check of the Population Estimates Program (PEP) file tree on www2.census.gov: newest 2020-YYYY vintage directory, then HEAD of counties/totals/co-est<YYYY>-alldata.csv and cities/totals/sub-est<YYYY>.csv (size, Last-Modified, publication_id = v<YYYY>:<file>:<Last-Modified>), plus the per-state sub-county files from the cities/totals listing. No publisher hash exists; popest_list reports the SHA-256 of the file it reads.
- Instructions: Before a collection run, to learn the current vintage and whether a PEP file changed since the last run.
- Cost: 5 credits per call
- Capability file: [Popest status](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/popest_status)

Accepted options:
- `state` (string): Optional 2-digit state FIPS: also HEAD that state's sub-est<YYYY>_<state>.csv and report it under files. Pattern: ^[0-9]{2}$. Example: `<state>`

Response schema example:
```json
{
  "files": [
    {
      "content_hash": null,
      "file": "counties",
      "file_name": "co-est2025-alldata.csv",
      "last_modified": "2026-03-26T12:15:28Z",
      "publication_id": "v2025:co-est2025-alldata.csv:2026-03-26T12:15:28Z",
      "published_at": "2026-03-26T12:15:28Z",
      "size_bytes": 2071735,
      "state": null,
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/counties/totals/co-est2025-alldata.csv"
    },
    {
      "content_hash": null,
      "file": "subcounty",
      "file_name": "sub-est2025.csv",
      "last_modified": "2026-05-14T12:45:32Z",
      "publication_id": "v2025:sub-est2025.csv:2026-05-14T12:45:32Z",
      "published_at": "2026-05-14T12:45:32Z",
      "size_bytes": 7464556,
      "state": null,
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025.csv"
    },
    {
      "content_hash": null,
      "file": "subcounty",
      "file_name": "sub-est2025_30.csv",
      "last_modified": "2026-05-14T12:45:32Z",
      "publication_id": "v2025:sub-est2025_30.csv:2026-05-14T12:45:32Z",
      "published_at": "2026-05-14T12:45:32Z",
      "size_bytes": 33352,
      "state": "30",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_30.csv"
    }
  ],
  "observed_at_ms": 1792345676966,
  "retrieved_at": "2026-10-18T17:47:56Z",
  "source_url": "https://www2.census.gov/programs-surveys/popest/datasets/",
  "subcounty_state_files": [
    {
      "file_name": "sub-est2025_1.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "98K",
      "state": "01",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_1.csv"
    },
    {
      "file_name": "sub-est2025_2.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "29K",
      "state": "02",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_2.csv"
    },
    {
      "file_name": "sub-est2025_4.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "21K",
      "state": "04",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_4.csv"
    },
    {
      "file_name": "sub-est2025_5.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "102K",
      "state": "05",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_5.csv"
    },
    {
      "file_name": "sub-est2025_6.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "107K",
      "state": "06",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_6.csv"
    },
    {
      "file_name": "sub-est2025_8.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "62K",
      "state": "08",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_8.csv"
    },
    {
      "file_name": "sub-est2025_9.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "29K",
      "state": "09",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_9.csv"
    },
    {
      "file_name": "sub-est2025_10.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "11K",
      "state": "10",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_10.csv"
    },
    {
      "file_name": "sub-est2025_11.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "674",
      "state": "11",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_11.csv"
    },
    {
      "file_name": "sub-est2025_12.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "90K",
      "state": "12",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_12.csv"
    },
    {
      "file_name": "sub-est2025_13.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "131K",
      "state": "13",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_13.csv"
    },
    {
      "file_name": "sub-est2025_15.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "1.1K",
      "state": "15",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_15.csv"
    },
    {
      "file_name": "sub-est2025_16.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "42K",
      "state": "16",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_16.csv"
    },
    {
      "file_name": "sub-est2025_17.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "672K",
      "state": "17",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_17.csv"
    },
    {
      "file_name": "sub-est2025_18.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "343K",
      "state": "18",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_18.csv"
    },
    {
      "file_name": "sub-est2025_19.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "174K",
      "state": "19",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_19.csv"
    },
    {
      "file_name": "sub-est2025_20.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "345K",
      "state": "20",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_20.csv"
    },
    {
      "file_name": "sub-est2025_21.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "107K",
      "state": "21",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_21.csv"
    },
    {
      "file_name": "sub-est2025_22.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "68K",
      "state": "22",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_22.csv"
    },
    {
      "file_name": "sub-est2025_23.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "53K",
      "state": "23",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_23.csv"
    },
    {
      "file_name": "sub-est2025_24.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "34K",
      "state": "24",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_24.csv"
    },
    {
      "file_name": "sub-est2025_25.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "55K",
      "state": "25",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_25.csv"
    },
    {
      "file_name": "sub-est2025_26.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "340K",
      "state": "26",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_26.csv"
    },
    {
      "file_name": "sub-est2025_27.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "474K",
      "state": "27",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_27.csv"
    },
    {
      "file_name": "sub-est2025_28.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "72K",
      "state": "28",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_28.csv"
    },
    {
      "file_name": "sub-est2025_29.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "243K",
      "state": "29",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_29.csv"
    },
    {
      "file_name": "sub-est2025_30.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "33K",
      "state": "30",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_30.csv"
    },
    {
      "file_name": "sub-est2025_31.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "167K",
      "state": "31",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_31.csv"
    },
    {
      "file_name": "sub-est2025_32.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "6.3K",
      "state": "32",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_32.csv"
    },
    {
      "file_name": "sub-est2025_33.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "30K",
      "state": "33",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_33.csv"
    },
    {
      "file_name": "sub-est2025_34.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "154K",
      "state": "34",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_34.csv"
    },
    {
      "file_name": "sub-est2025_35.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "26K",
      "state": "35",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_35.csv"
    },
    {
      "file_name": "sub-est2025_36.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "315K",
      "state": "36",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_36.csv"
    },
    {
      "file_name": "sub-est2025_37.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "131K",
      "state": "37",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_37.csv"
    },
    {
      "file_name": "sub-est2025_38.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "244K",
      "state": "38",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_38.csv"
    },
    {
      "file_name": "sub-est2025_39.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "494K",
      "state": "39",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_39.csv"
    },
    {
      "file_name": "sub-est2025_40.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "119K",
      "state": "40",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_40.csv"
    },
    {
      "file_name": "sub-est2025_41.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "50K",
      "state": "41",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_41.csv"
    },
    {
      "file_name": "sub-est2025_42.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "550K",
      "state": "42",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_42.csv"
    },
    {
      "file_name": "sub-est2025_44.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "7.5K",
      "state": "44",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_44.csv"
    },
    {
      "file_name": "sub-est2025_45.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "64K",
      "state": "45",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_45.csv"
    },
    {
      "file_name": "sub-est2025_46.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "198K",
      "state": "46",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_46.csv"
    },
    {
      "file_name": "sub-est2025_47.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "86K",
      "state": "47",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_47.csv"
    },
    {
      "file_name": "sub-est2025_48.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "274K",
      "state": "48",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_48.csv"
    },
    {
      "file_name": "sub-est2025_49.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "49K",
      "state": "49",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_49.csv"
    },
    {
      "file_name": "sub-est2025_50.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "38K",
      "state": "50",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_50.csv"
    },
    {
      "file_name": "sub-est2025_51.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "63K",
      "state": "51",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_51.csv"
    },
    {
      "file_name": "sub-est2025_53.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "61K",
      "state": "53",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_53.csv"
    },
    {
      "file_name": "sub-est2025_54.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "55K",
      "state": "54",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_54.csv"
    },
    {
      "file_name": "sub-est2025_55.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "358K",
      "state": "55",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_55.csv"
    },
    {
      "file_name": "sub-est2025_56.csv",
      "listing_modified": "2026-05-14 08:45",
      "listing_size": "21K",
      "state": "56",
      "url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/cities/totals/sub-est2025_56.csv"
    }
  ],
  "vintage": 2025,
  "vintage_directory": "2020-2025",
  "vintage_url": "https://www2.census.gov/programs-surveys/popest/datasets/2020-2025/",
  "vintages_available": [
    "2020-2021",
    "2020-2022",
    "2020-2023",
    "2020-2024",
    "2020-2025"
  ]
}
```

### Saipe get

- Capability: `census/saipe_get`
- Description: One SAIPE record by state and county FIPS for a year: reads est<yy>-<st>.txt (county omitted or 000 = the state row) or, for state 00 / US, the national row of est<yy>us.txt. Same record shape as saipe_list.
- Instructions: Fetch one county's poverty and median household income estimates (Gallatin County: state 30, county 031).
- Cost: 5 credits per call
- Capability file: [Saipe get](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/saipe_get)

Accepted options:
- `county` (string): 3-digit county FIPS; omitted or 000 = the state row. Pattern: ^[0-9]{3}$. Example: `<county>`
- `state` (string, required): State as 2-digit FIPS (30) or postal code (MT); 00 or US for the national row. Pattern: ^([0-9]{2}|[A-Za-z]{2})$. Example: `<state>`
- `year` (number): SAIPE estimate year (directory saipe/datasets/<year>/<year>-state-and-county/). Default: the newest year directory. Positions verified against the 2019 and 2024 layout READMEs; lines that do not fit the layout are rejected. Example: `2010`

Response schema example:
```json
{
  "content_hash": "4860700c04e5b081bccdf8447b3239da65fbf3574404d3421f701ccd5021aff6",
  "file_name": "est24-mt.txt",
  "file_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
  "hash_source": "sha256:file_bytes",
  "last_modified": "2026-01-27T15:47:47Z",
  "observed_at_ms": 1792345612128,
  "publication_id": "saipe2024:est24-mt.txt:2026-01-27T15:47:47Z",
  "record": {
    "county_fips": "031",
    "file_tag": "est24-mt.txt 07JAN2026",
    "geo_id": "30031",
    "level": "county",
    "median_household_income": {
      "ci_lower": 93786,
      "ci_upper": 108120,
      "estimate": 100953
    },
    "name": "Gallatin County",
    "postal": "MT",
    "poverty_age_0_17": {
      "ci_lower": 767,
      "ci_upper": 1725,
      "estimate": 1246,
      "percent": 5.5,
      "percent_ci_lower": 3.4,
      "percent_ci_upper": 7.6
    },
    "poverty_age_0_4": null,
    "poverty_all_ages": {
      "ci_lower": 6981,
      "ci_upper": 10459,
      "estimate": 8720,
      "percent": 7.1,
      "percent_ci_lower": 5.7,
      "percent_ci_upper": 8.5
    },
    "poverty_related_children_5_17": {
      "ci_lower": 486,
      "ci_upper": 1218,
      "estimate": 852,
      "percent": 5,
      "percent_ci_lower": 2.9,
      "percent_ci_upper": 7.1
    },
    "publication_id": "saipe2024:est24-mt.txt:2026-01-27T15:47:47Z",
    "retrieved_at": "2026-10-18T17:46:52Z",
    "source_record_id": "saipe2024:30031",
    "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
    "state_fips": "30",
    "year": 2024
  },
  "retrieved_at": "2026-10-18T17:46:52Z",
  "size_bytes": 15105,
  "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
  "year": 2024
}
```

### Saipe list

- Capability: `census/saipe_list`
- Description: List SAIPE state-and-county poverty and median household income estimates for one year: est<yy>all.txt (US, 51 states, every county; 3,196 lines for 2024) or, with state, est<yy>-<st>.txt (state row first, then its counties). Fixed-width positions per the layout README: state 1-2, county 4-6, poverty all ages 8-48, age 0-17 50-90, related children 5-17 92-132, median household income 134-153, under 5 155-192 (US and states only), name 194-238, postal 240-241, file tag 243-264. Blanks and '.' become null; FIPS stay zero-padded strings. The file is fetched per call and paged from memory; the cursor pins year, file, Last-Modified and size. source_record_id = saipe<year>:<state_fips><county_fips>.
- Instructions: Full collection of county poverty counts/rates and median household income for a year, optionally for one state.
- Cost: 5 credits per call
- Capability file: [Saipe list](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/saipe_list)

Accepted options:
- `continuation` (string): Opaque cursor from the previous page's next_cursor. It pins the vintage, file, Last-Modified and size; when the source has moved on the call fails with invalid_input at /continuation (issue code publication_changed) instead of mixing versions. Example: `<continuation>`
- `page_size` (number): Records per page; default 500. Example: `10`
- `state` (string): State as 2-digit FIPS (30) or postal code (MT, mt). Pattern: ^([0-9]{2}|[A-Za-z]{2})$. Example: `<state>`
- `year` (number): SAIPE estimate year (directory saipe/datasets/<year>/<year>-state-and-county/). Default: the newest year directory. Positions verified against the 2019 and 2024 layout READMEs; lines that do not fit the layout are rejected. Example: `2010`

Response schema example:
```json
{
  "content_hash": "4860700c04e5b081bccdf8447b3239da65fbf3574404d3421f701ccd5021aff6",
  "count": 3,
  "file_name": "est24-mt.txt",
  "file_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
  "has_more": true,
  "hash_source": "sha256:file_bytes",
  "last_modified": "2026-01-27T15:47:47Z",
  "next_cursor": "saipe1|2024|MT|2026-01-27T15:47:47Z|15105|3",
  "observed_at_ms": 1792345628577,
  "offset": 0,
  "publication_id": "saipe2024:est24-mt.txt:2026-01-27T15:47:47Z",
  "records": [
    {
      "county_fips": "000",
      "file_tag": "est24-mt.txt 07JAN2026",
      "geo_id": "30000",
      "level": "state",
      "median_household_income": {
        "ci_lower": 73980,
        "ci_upper": 77060,
        "estimate": 75520
      },
      "name": "Montana",
      "postal": "MT",
      "poverty_age_0_17": {
        "ci_lower": 24048,
        "ci_upper": 29208,
        "estimate": 26628,
        "percent": 11.7,
        "percent_ci_lower": 10.6,
        "percent_ci_upper": 12.8
      },
      "poverty_age_0_4": {
        "ci_lower": 5998,
        "ci_upper": 7842,
        "estimate": 6920,
        "percent": 12.5,
        "percent_ci_lower": 10.8,
        "percent_ci_upper": 14.2
      },
      "poverty_all_ages": {
        "ci_lower": 110419,
        "ci_upper": 121789,
        "estimate": 116104,
        "percent": 10.4,
        "percent_ci_lower": 9.9,
        "percent_ci_upper": 10.9
      },
      "poverty_related_children_5_17": {
        "ci_lower": 16265,
        "ci_upper": 21001,
        "estimate": 18633,
        "percent": 10.9,
        "percent_ci_lower": 9.5,
        "percent_ci_upper": 12.3
      },
      "publication_id": "saipe2024:est24-mt.txt:2026-01-27T15:47:47Z",
      "retrieved_at": "2026-10-18T17:47:08Z",
      "source_record_id": "saipe2024:30000",
      "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
      "state_fips": "30",
      "year": 2024
    },
    {
      "county_fips": "001",
      "file_tag": "est24-mt.txt 07JAN2026",
      "geo_id": "30001",
      "level": "county",
      "median_household_income": {
        "ci_lower": 58939,
        "ci_upper": 73059,
        "estimate": 65999
      },
      "name": "Beaverhead County",
      "postal": "MT",
      "poverty_age_0_17": {
        "ci_lower": 116,
        "ci_upper": 294,
        "estimate": 205,
        "percent": 12.9,
        "percent_ci_lower": 7.3,
        "percent_ci_upper": 18.5
      },
      "poverty_age_0_4": null,
      "poverty_all_ages": {
        "ci_lower": 848,
        "ci_upper": 1454,
        "estimate": 1151,
        "percent": 12,
        "percent_ci_lower": 8.9,
        "percent_ci_upper": 15.1
      },
      "poverty_related_children_5_17": {
        "ci_lower": 72,
        "ci_upper": 216,
        "estimate": 144,
        "percent": 12.2,
        "percent_ci_lower": 6.1,
        "percent_ci_upper": 18.3
      },
      "publication_id": "saipe2024:est24-mt.txt:2026-01-27T15:47:47Z",
      "retrieved_at": "2026-10-18T17:47:08Z",
      "source_record_id": "saipe2024:30001",
      "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
      "state_fips": "30",
      "year": 2024
    },
    {
      "county_fips": "003",
      "file_tag": "est24-mt.txt 07JAN2026",
      "geo_id": "30003",
      "level": "county",
      "median_household_income": {
        "ci_lower": 55730,
        "ci_upper": 62494,
        "estimate": 59112
      },
      "name": "Big Horn County",
      "postal": "MT",
      "poverty_age_0_17": {
        "ci_lower": 689,
        "ci_upper": 1435,
        "estimate": 1062,
        "percent": 27.4,
        "percent_ci_lower": 17.8,
        "percent_ci_upper": 37
      },
      "poverty_age_0_4": null,
      "poverty_all_ages": {
        "ci_lower": 2102,
        "ci_upper": 3472,
        "estimate": 2787,
        "percent": 22.2,
        "percent_ci_lower": 16.7,
        "percent_ci_upper": 27.7
      },
      "poverty_related_children_5_17": {
        "ci_lower": 435,
        "ci_upper": 1029,
        "estimate": 732,
        "percent": 24.8,
        "percent_ci_lower": 14.7,
        "percent_ci_upper": 34.9
      },
      "publication_id": "saipe2024:est24-mt.txt:2026-01-27T15:47:47Z",
      "retrieved_at": "2026-10-18T17:47:08Z",
      "source_record_id": "saipe2024:30003",
      "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
      "state_fips": "30",
      "year": 2024
    }
  ],
  "retrieved_at": "2026-10-18T17:47:08Z",
  "size_bytes": 15105,
  "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt",
  "state": "MT",
  "total_records": 57,
  "year": 2024
}
```

### Saipe status

- Capability: `census/saipe_status`
- Description: Cheap version check of the Small Area Income and Poverty Estimates (SAIPE) state-and-county files on www2.census.gov: newest year directory, the file listing (est<yy>all.txt, est<yy>us.txt, est<yy>-<st>.txt and the .xls twins), and for the national files est<yy>all.txt and est<yy>us.txt the exact size, Last-Modified, SHA-256 and line count (they are fetched: the server sends them gzip-encoded without Content-Length). publication_id = saipe<year>:<file>:<Last-Modified>.
- Instructions: Before a collection run, to learn the current SAIPE year and whether the files changed.
- Cost: 5 credits per call
- Capability file: [Saipe status](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/saipe_status)

Accepted options:

Response schema example:
```json
{
  "directory_url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/",
  "files": [
    {
      "content_hash": null,
      "file_name": "est24-ak.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "8.0K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "AK",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ak.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-al.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "18K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "AL",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-al.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ar.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "20K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "AR",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ar.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-az.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "4.1K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "AZ",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-az.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ca.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "15K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "CA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ca.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-co.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "17K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "CO",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-co.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ct.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "2.6K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "CT",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ct.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-dc.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "265",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "DC",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-dc.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-de.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "1.0K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "DE",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-de.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-fl.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "18K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "FL",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-fl.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ga.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "41K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "GA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ga.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-hi.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "1.6K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "HI",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-hi.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ia.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "26K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "IA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ia.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-id.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "12K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "ID",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-id.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-il.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "27K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "IL",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-il.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-in.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "24K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "IN",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-in.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ks.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "27K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "KS",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ks.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ky.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "31K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "KY",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ky.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-la.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "17K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "LA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-la.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ma.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "3.9K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ma.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-md.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "6.5K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MD",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-md.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-me.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "4.4K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "ME",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-me.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-mi.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "22K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MI",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mi.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-mn.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "23K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MN",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mn.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-mo.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "30K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MO",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mo.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ms.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "21K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MS",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ms.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-mt.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "15K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "MT",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-mt.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-nc.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "26K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NC",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-nc.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-nd.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "14K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "ND",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-nd.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ne.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "24K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NE",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ne.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-nh.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "2.8K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NH",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-nh.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-nj.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "5.7K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NJ",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-nj.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-nm.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "8.8K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NM",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-nm.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-nv.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "4.7K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NV",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-nv.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ny.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "16K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "NY",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ny.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-oh.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "23K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "OH",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-oh.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ok.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "20K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "OK",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ok.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-or.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "9.6K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "OR",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-or.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-pa.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "18K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "PA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-pa.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ri.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "1.6K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "RI",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ri.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-sc.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "12K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "SC",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-sc.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-sd.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "17K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "SD",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-sd.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-tn.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "25K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "TN",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-tn.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-tx.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "66K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "TX",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-tx.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-ut.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "7.8K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "UT",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-ut.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-va.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "35K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "VA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-va.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-vt.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "3.9K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "VT",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-vt.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-wa.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "10K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "WA",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-wa.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-wi.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "19K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "WI",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-wi.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-wv.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "14K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "WV",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-wv.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24-wy.txt",
      "kind": "state",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "6.2K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": "WY",
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24-wy.txt"
    },
    {
      "content_hash": "f49df1828732ae06c2700d939fd77ced0d1a15ccc23621c67cc9c48680d344dc",
      "file_name": "est24all.txt",
      "kind": "all",
      "last_modified": "2026-01-27T15:47:47Z",
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "827K",
      "publication_id": "saipe2024:est24all.txt:2026-01-27T15:47:47Z",
      "record_count": 3196,
      "size_bytes": 846940,
      "state": null,
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24all.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24all.xls",
      "kind": "all_xls",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "1.1M",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": null,
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24all.xls"
    },
    {
      "content_hash": "a304db36a4c707f4916aadccb99f977f3c53a81144cbdd94ea72673a8bb2aec5",
      "file_name": "est24us.txt",
      "kind": "us",
      "last_modified": "2026-01-27T15:47:47Z",
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "13K",
      "publication_id": "saipe2024:est24us.txt:2026-01-27T15:47:47Z",
      "record_count": 52,
      "size_bytes": 13780,
      "state": null,
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24us.txt"
    },
    {
      "content_hash": null,
      "file_name": "est24us.xls",
      "kind": "us_xls",
      "last_modified": null,
      "listing_modified": "2026-01-27 10:47",
      "listing_size": "45K",
      "publication_id": null,
      "record_count": null,
      "size_bytes": null,
      "state": null,
      "url": "https://www2.census.gov/programs-surveys/saipe/datasets/2024/2024-state-and-county/est24us.xls"
    }
  ],
  "layout_url": "https://www2.census.gov/programs-surveys/saipe/technical-documentation/file-layouts/state-county/2024-estimate-layout.txt",
  "observed_at_ms": 1792345692964,
  "publication_id": "saipe2024:est24all.txt:2026-01-27T15:47:47Z",
  "published_at": "2026-01-27T15:47:47Z",
  "retrieved_at": "2026-10-18T17:48:12Z",
  "source_url": "https://www2.census.gov/programs-surveys/saipe/datasets/",
  "year": 2024,
  "years_available": [
    1989,
    1993,
    1995,
    1996,
    1997,
    1998,
    1999,
    2000,
    2001,
    2002,
    2003,
    2004,
    2005,
    2006,
    2007,
    2008,
    2009,
    2010,
    2011,
    2012,
    2013,
    2014,
    2015,
    2016,
    2017,
    2018,
    2019,
    2020,
    2021,
    2022,
    2023,
    2024
  ]
}
```

### Variables

- Capability: `census/variables`
- Description: List variables of one dataset vintage. Input: dataset path and vintage, plus a group (table id such as B01003 or DP05) and/or a free-text query matched against group descriptions and variable labels. Returns variable name, verbatim label, concept, predicate type, group and the unit phrase the label carries.
- Instructions: List variables of one dataset vintage. Input: dataset path and vintage, plus a group (table id such as B01003 or DP05) and/or a free-text query matched against group descriptions and variable labels. Returns variable name, verbatim label, concept, predicate type, group and the unit phrase the label carries.
- Cost: 5 credits per call
- Capability file: [Variables](https://alexandria.firecrawl.dev/agents/providers/census-gov/census/variables)

Accepted options:
- `cursor` (string): cursor Example: `<cursor>`
- `dataset` (string, required): Data API dataset path, e.g. acs/acs5, acs/acs5/profile, dec/pl, cbp. Pattern: ^[A-Za-z0-9_/]+$. Example: `<dataset>`
- `group` (string): Table id, e.g. B01003, S0101, DP05, P1. Pattern: ^[A-Za-z0-9_]{1,40}$. Example: `<group>`
- `page_size` (number): page_size Example: `20`
- `query` (string): Tokens matched against group name/description (when no group is given; the first 5 matching groups are listed) or variable name/label/concept (within a group). Datasets with at most 5 tables (cbp, pep/population) whose descriptions do not match are searched by variable label instead. Example: `<query>`
- `vintage` (number, required): vintage Example: `2000`

Response schema example:
```json
{
  "complete": true,
  "count": 1,
  "dataset": "acs/acs5",
  "group": "B01003",
  "next_cursor": null,
  "observed_at_ms": 1789084800000,
  "records": [
    {
      "attributes": [],
      "concept": "Total Population",
      "dataset": "acs/acs5",
      "group": "B01003",
      "label": "Estimate!!Total",
      "limit": 0,
      "name": "B01003_001E",
      "predicate_only": true,
      "predicate_type": "int",
      "scale": null,
      "source_url": "https://api.census.gov/data/2023/acs/acs5/groups/B01003.json",
      "unit": null,
      "vintage": 2023
    }
  ],
  "retrieved_at": "2026-09-11T00:00:00Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://api.census.gov/data/2023/acs/acs5/groups/B01003.json",
  "total": 6,
  "vintage": 2023,
  "warnings": []
}
```
