---
type: "firecrawl-provider"
description: "The US Census Bureau Geocoder at geocoding.geo.census.gov: matches US addresses against the Census Bureau's MAF/TIGER address ranges and returns the standardized matched address, interpolated coordinates and the census geography that contains it (state, county, tract and block codes, places, county subdivisions, urban and statistical areas, congressional and state legislative districts), for one address, a batch of up to 1,000, or a latitude and longitude. This is not USPS address validation: a match means the house number falls inside a TIGER address range, not that USPS delivers mail there, and the geocoder drops apartment and suite numbers and returns no ZIP+4. Uses the Census Bureau Geocoder but is not endorsed or certified by the Census Bureau."
use_when: "The US Census Bureau Geocoder at geocoding.geo.census.gov: matches US addresses against the Census Bureau's MAF/TIGER address ranges and returns the standardized matched address, interpolated coordinates and the census geography that contains it (state, county, tract and block codes, places, county subdivisions, urban and statistical areas, congressional and state legislative districts), for one address, a batch of up to 1,000, or a latitude and longitude. This is not USPS address validation: a match means the house number falls inside a TIGER address range, not that USPS delivers mail there, and the geocoder drops apartment and suite numbers and returns no ZIP+4. Uses the Census Bureau Geocoder but is not endorsed or certified by the Census Bureau."
categories: "Real estate"
capabilities: 3
credits_per_call: 5
---
# US Census Bureau Geocoder on Firecrawl Alexandria

The US Census Bureau Geocoder at geocoding.geo.census.gov: matches US addresses against the Census Bureau's MAF/TIGER address ranges and returns the standardized matched address, interpolated coordinates and the census geography that contains it (state, county, tract and block codes, places, county subdivisions, urban and statistical areas, congressional and state legislative districts), for one address, a batch of up to 1,000, or a latitude and longitude. This is not USPS address validation: a match means the house number falls inside a TIGER address range, not that USPS delivers mail there, and the geocoder drops apartment and suite numbers and returns no ZIP+4. Uses the Census Bureau Geocoder but is not endorsed or certified by the Census Bureau.

- Categories: Real estate
- Category index: [Real estate category](https://alexandria.firecrawl.dev/agents/categories/real-estate)
- Provider key: `geocoding-geo-census-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

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

## Capabilities

- [Batch geocode](https://alexandria.firecrawl.dev/agents/providers/geocoding-geo-census-gov/addresses/batch_geocode): Match up to 1,000 US addresses in one call through the geocoder's batch service. Each row comes back in input order as match, no_match or tie, with whether the match was exact, the standardized address, interpolated coordinates, the TIGER line and side, and with geographies (the default) its state, county, tract and block codes and block GEOID, plus counts of matched, unmatched and tied rows.
- [Geocode](https://alexandria.firecrawl.dev/agents/providers/geocoding-geo-census-gov/addresses/geocode): Match one US address against the Census Bureau's TIGER address ranges, given as one line (address) or as street with city and state and/or zip. Each match carries the standardized address with its house number, street, postal city, state and 5-digit ZIP, interpolated latitude and longitude, the parsed street components, the TIGER address range and side it fell in, and, with geographies (the default), the state, county, tract and block codes plus every census layer containing the point. No match returns an empty list with a no_match warning; several matches come with an ambiguous warning.
- [Geographies at](https://alexandria.firecrawl.dev/agents/providers/geocoding-geo-census-gov/addresses/geographies_at): Every census geography that contains a latitude and longitude: the state, county, tract and block codes, plus each layer (places, county subdivisions, urban and statistical areas, congressional and state legislative districts) with its GEOID, name, MAF/TIGER feature class, land and water area and internal point. A point outside the United States, Puerto Rico and the Island Areas returns no geographies with an outside_coverage warning.

## 1. Choose this provider when

The US Census Bureau Geocoder at geocoding.geo.census.gov: matches US addresses against the Census Bureau's MAF/TIGER address ranges and returns the standardized matched address, interpolated coordinates and the census geography that contains it (state, county, tract and block codes, places, county subdivisions, urban and statistical areas, congressional and state legislative districts), for one address, a batch of up to 1,000, or a latitude and longitude. This is not USPS address validation: a match means the house number falls inside a TIGER address range, not that USPS delivers mail there, and the geocoder drops apartment and suite numbers and returns no ZIP+4. Uses the Census Bureau Geocoder but is not endorsed or certified by the Census Bureau.

## 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": "geocoding-geo-census-gov",
  "capability": "addresses/batch_geocode",
  "options": {
    "addresses": [
      {
        "city": "Washington",
        "id": "1",
        "state": "DC",
        "street": "1600 Pennsylvania Ave NW",
        "zip": "20500"
      },
      {
        "id": "2",
        "street": "4600 Silver Hill Rd",
        "zip": "20233"
      },
      {
        "city": "New York",
        "id": "3",
        "state": "NY",
        "street": "350 Fifth Avenue"
      },
      {
        "city": "Faketown",
        "id": "4",
        "state": "ZZ",
        "street": "99999 Nowhere Blvd",
        "zip": "00000"
      },
      {
        "city": "Springfield",
        "id": "5",
        "street": "100 Main St"
      }
    ]
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `addresses` (object[], required): 1 to 1,000 addresses. Example: `[]`
- `benchmark` (string): Address-range release: Public_AR_Current (default), Public_AR_ACS2026, Public_AR_LUCA or Public_AR_Census2020. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<benchmark>`
- `geographies` (boolean): Also return state, county, tract and block codes for each match. Example: `false`
- `vintage` (string): Geography release for the benchmark, such as Current_Current (the default for Public_AR_Current), ACS2025_Current, Census2020_Current, or Census2020_Census2020 and Census2010_Census2020 with Public_AR_Census2020. Defaults to the benchmark's default vintage. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<vintage>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "geocoding-geo-census-gov",
    capability: "addresses/batch_geocode",
    options: {
      addresses: [
        {
          city: "Washington",
          id: "1",
          state: "DC",
          street: "1600 Pennsylvania Ave NW",
          zip: "20500",
        },
        {
          id: "2",
          street: "4600 Silver Hill Rd",
          zip: "20233",
        },
        {
          city: "New York",
          id: "3",
          state: "NY",
          street: "350 Fifth Avenue",
        },
        {
          city: "Faketown",
          id: "4",
          state: "ZZ",
          street: "99999 Nowhere Blvd",
          zip: "00000",
        },
        {
          city: "Springfield",
          id: "5",
          street: "100 Main St",
        },
      ],
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "geocoding-geo-census-gov",
  "capability": "addresses/batch_geocode",
  "options": {
    "addresses": [
      {
        "city": "Washington",
        "id": "1",
        "state": "DC",
        "street": "1600 Pennsylvania Ave NW",
        "zip": "20500"
      },
      {
        "id": "2",
        "street": "4600 Silver Hill Rd",
        "zip": "20233"
      },
      {
        "city": "New York",
        "id": "3",
        "state": "NY",
        "street": "350 Fifth Avenue"
      },
      {
        "city": "Faketown",
        "id": "4",
        "state": "ZZ",
        "street": "99999 Nowhere Blvd",
        "zip": "00000"
      },
      {
        "city": "Springfield",
        "id": "5",
        "street": "100 Main St"
      }
    ]
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "geocoding-geo-census-gov",
    "capability": "addresses/batch_geocode",
    "options": {
      "addresses": [
        {
          "city": "Washington",
          "id": "1",
          "state": "DC",
          "street": "1600 Pennsylvania Ave NW",
          "zip": "20500"
        },
        {
          "id": "2",
          "street": "4600 Silver Hill Rd",
          "zip": "20233"
        },
        {
          "city": "New York",
          "id": "3",
          "state": "NY",
          "street": "350 Fifth Avenue"
        },
        {
          "city": "Faketown",
          "id": "4",
          "state": "ZZ",
          "street": "99999 Nowhere Blvd",
          "zip": "00000"
        },
        {
          "city": "Springfield",
          "id": "5",
          "street": "100 Main St"
        }
      ]
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'geocoding-geo-census-gov/addresses/batch_geocode' \
  --options '{"addresses":[{"city":"Washington","id":"1","state":"DC","street":"1600 Pennsylvania Ave NW","zip":"20500"},{"id":"2","street":"4600 Silver Hill Rd","zip":"20233"},{"city":"New York","id":"3","state":"NY","street":"350 Fifth Avenue"},{"city":"Faketown","id":"4","state":"ZZ","street":"99999 Nowhere Blvd","zip":"00000"},{"city":"Springfield","id":"5","street":"100 Main St"}]}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "geocoding-geo-census-gov",
  "capability": "addresses/batch_geocode",
  "options": {
    "addresses": [
      {
        "city": "Washington",
        "id": "1",
        "state": "DC",
        "street": "1600 Pennsylvania Ave NW",
        "zip": "20500"
      },
      {
        "id": "2",
        "street": "4600 Silver Hill Rd",
        "zip": "20233"
      },
      {
        "city": "New York",
        "id": "3",
        "state": "NY",
        "street": "350 Fifth Avenue"
      },
      {
        "city": "Faketown",
        "id": "4",
        "state": "ZZ",
        "street": "99999 Nowhere Blvd",
        "zip": "00000"
      },
      {
        "city": "Springfield",
        "id": "5",
        "street": "100 Main St"
      }
    ]
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "geocoding-geo-census-gov",
  "capability": "addresses/batch_geocode",
  "options": {
    "addresses": [
      {
        "city": "Washington",
        "id": "1",
        "state": "DC",
        "street": "1600 Pennsylvania Ave NW",
        "zip": "20500"
      },
      {
        "id": "2",
        "street": "4600 Silver Hill Rd",
        "zip": "20233"
      },
      {
        "city": "New York",
        "id": "3",
        "state": "NY",
        "street": "350 Fifth Avenue"
      },
      {
        "city": "Faketown",
        "id": "4",
        "state": "ZZ",
        "street": "99999 Nowhere Blvd",
        "zip": "00000"
      },
      {
        "city": "Springfield",
        "id": "5",
        "street": "100 Main St"
      }
    ]
  }
}
```

## 6. Response data

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

```json
{
  "benchmark": "Public_AR_Current",
  "matched": 3,
  "no_match": 1,
  "observed_at_ms": 1795205419259,
  "results": [
    {
      "block": "1034",
      "block_geoid": "110019800001034",
      "county_fips": "001",
      "exact": true,
      "id": "1",
      "input_address": "1600 Pennsylvania Ave NW, Washington, DC, 20500",
      "latitude": 38.898702605246,
      "longitude": -77.035189204737,
      "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
      "side": "L",
      "state_fips": "11",
      "status": "match",
      "tiger_line_id": "76225813",
      "tract": "980000"
    },
    {
      "block": "2004",
      "block_geoid": "240338024052004",
      "county_fips": "033",
      "exact": true,
      "id": "2",
      "input_address": "4600 Silver Hill Rd, , , 20233",
      "latitude": 38.84505589808,
      "longitude": -76.92836638093,
      "matched_address": "4600 SILVER HILL RD, WASHINGTON, DC, 20233",
      "side": "L",
      "state_fips": "24",
      "status": "match",
      "tiger_line_id": "657091557",
      "tract": "802405"
    },
    {
      "block": "1001",
      "block_geoid": "360610076001001",
      "county_fips": "061",
      "exact": true,
      "id": "3",
      "input_address": "350 Fifth Avenue, New York, NY,",
      "latitude": 40.747850846857,
      "longitude": -73.985075577551,
      "matched_address": "350 5TH AVE, NEW YORK, NY, 10118",
      "side": "L",
      "state_fips": "36",
      "status": "match",
      "tiger_line_id": "59653473",
      "tract": "007600"
    },
    {
      "block": null,
      "block_geoid": null,
      "county_fips": null,
      "exact": null,
      "id": "4",
      "input_address": "99999 Nowhere Blvd, Faketown, ZZ, 00000",
      "latitude": null,
      "longitude": null,
      "matched_address": null,
      "side": null,
      "state_fips": null,
      "status": "no_match",
      "tiger_line_id": null,
      "tract": null
    },
    {
      "block": null,
      "block_geoid": null,
      "county_fips": null,
      "exact": null,
      "id": "5",
      "input_address": "100 Main St, Springfield, ,",
      "latitude": null,
      "longitude": null,
      "matched_address": null,
      "side": null,
      "state_fips": null,
      "status": "tie",
      "tiger_line_id": null,
      "tract": null
    }
  ],
  "source_url": "https://geocoding.geo.census.gov/geocoder/geographies/addressbatch",
  "submitted": 5,
  "tie": 1,
  "vintage": "Current_Current"
}
```

## API reference-derived contract

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

### Batch geocode

- Capability: `addresses/batch_geocode`
- Description: Match up to 1,000 US addresses in one call through the geocoder's batch service. Each row comes back in input order as match, no_match or tie, with whether the match was exact, the standardized address, interpolated coordinates, the TIGER line and side, and with geographies (the default) its state, county, tract and block codes and block GEOID, plus counts of matched, unmatched and tied rows.
- Instructions: Use to standardize, geocode or tract-code a list of addresses and flag the ones that do not match. A tie means several address ranges matched equally; retry that row with geocode and a fuller address. Same limits as geocode: not USPS validation, no apartment or suite, no ZIP+4. Give each row a street plus zip, or city and state; ids default to row numbers and must be unique.
- Cost: 5 credits per call
- Capability file: [Batch geocode](https://alexandria.firecrawl.dev/agents/providers/geocoding-geo-census-gov/addresses/batch_geocode)

Accepted options:
- `addresses` (object[], required): 1 to 1,000 addresses. Example: `[]`
- `benchmark` (string): Address-range release: Public_AR_Current (default), Public_AR_ACS2026, Public_AR_LUCA or Public_AR_Census2020. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<benchmark>`
- `geographies` (boolean): Also return state, county, tract and block codes for each match. Example: `false`
- `vintage` (string): Geography release for the benchmark, such as Current_Current (the default for Public_AR_Current), ACS2025_Current, Census2020_Current, or Census2020_Census2020 and Census2010_Census2020 with Public_AR_Census2020. Defaults to the benchmark's default vintage. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<vintage>`

Response schema example:
```json
{
  "benchmark": "Public_AR_Current",
  "matched": 3,
  "no_match": 1,
  "observed_at_ms": 1795205419259,
  "results": [
    {
      "block": "1034",
      "block_geoid": "110019800001034",
      "county_fips": "001",
      "exact": true,
      "id": "1",
      "input_address": "1600 Pennsylvania Ave NW, Washington, DC, 20500",
      "latitude": 38.898702605246,
      "longitude": -77.035189204737,
      "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
      "side": "L",
      "state_fips": "11",
      "status": "match",
      "tiger_line_id": "76225813",
      "tract": "980000"
    },
    {
      "block": "2004",
      "block_geoid": "240338024052004",
      "county_fips": "033",
      "exact": true,
      "id": "2",
      "input_address": "4600 Silver Hill Rd, , , 20233",
      "latitude": 38.84505589808,
      "longitude": -76.92836638093,
      "matched_address": "4600 SILVER HILL RD, WASHINGTON, DC, 20233",
      "side": "L",
      "state_fips": "24",
      "status": "match",
      "tiger_line_id": "657091557",
      "tract": "802405"
    },
    {
      "block": "1001",
      "block_geoid": "360610076001001",
      "county_fips": "061",
      "exact": true,
      "id": "3",
      "input_address": "350 Fifth Avenue, New York, NY,",
      "latitude": 40.747850846857,
      "longitude": -73.985075577551,
      "matched_address": "350 5TH AVE, NEW YORK, NY, 10118",
      "side": "L",
      "state_fips": "36",
      "status": "match",
      "tiger_line_id": "59653473",
      "tract": "007600"
    },
    {
      "block": null,
      "block_geoid": null,
      "county_fips": null,
      "exact": null,
      "id": "4",
      "input_address": "99999 Nowhere Blvd, Faketown, ZZ, 00000",
      "latitude": null,
      "longitude": null,
      "matched_address": null,
      "side": null,
      "state_fips": null,
      "status": "no_match",
      "tiger_line_id": null,
      "tract": null
    },
    {
      "block": null,
      "block_geoid": null,
      "county_fips": null,
      "exact": null,
      "id": "5",
      "input_address": "100 Main St, Springfield, ,",
      "latitude": null,
      "longitude": null,
      "matched_address": null,
      "side": null,
      "state_fips": null,
      "status": "tie",
      "tiger_line_id": null,
      "tract": null
    }
  ],
  "source_url": "https://geocoding.geo.census.gov/geocoder/geographies/addressbatch",
  "submitted": 5,
  "tie": 1,
  "vintage": "Current_Current"
}
```

### Geocode

- Capability: `addresses/geocode`
- Description: Match one US address against the Census Bureau's TIGER address ranges, given as one line (address) or as street with city and state and/or zip. Each match carries the standardized address with its house number, street, postal city, state and 5-digit ZIP, interpolated latitude and longitude, the parsed street components, the TIGER address range and side it fell in, and, with geographies (the default), the state, county, tract and block codes plus every census layer containing the point. No match returns an empty list with a no_match warning; several matches come with an ambiguous warning.
- Instructions: Use to check that a US address exists in the Census address ranges, to get coordinates for it, or to find the census tract, county or districts it is in (for example the 11-digit tract_geoid before pulling ACS statistics for that tract from census-gov). It is not USPS validation: it does not confirm deliverability, keeps no apartment or suite, and returns no ZIP+4; PO boxes, rural routes and very new streets usually do not match. Coordinates are interpolated along the street segment, not rooftop. geographies false gives a locations-only match. benchmark and vintage pick older or decennial releases. For many addresses use batch_geocode.
- Cost: 5 credits per call
- Capability file: [Geocode](https://alexandria.firecrawl.dev/agents/providers/geocoding-geo-census-gov/addresses/geocode)

Accepted options:
- `address` (string): The whole address on one line, such as 1600 Pennsylvania Ave NW, Washington, DC 20500. Do not combine with street, city, state or zip. Pattern: ^[^\r\n]+$. Example: `<address>`
- `benchmark` (string): Address-range release: Public_AR_Current (default), Public_AR_ACS2026, Public_AR_LUCA or Public_AR_Census2020. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<benchmark>`
- `city` (string): City, such as New York. Pattern: ^[^\r\n]+$. Example: `<city>`
- `geographies` (boolean): Also return the census codes and layers containing each match. false is a locations-only match. Example: `false`
- `layers` (string): Geocoder layer ids or names, comma-separated, or all (19 layers, adding school districts, ZCTAs, metro and micro areas and more). Omit for the default 10 or so layers. The geocoder ignores an unknown layer. Pattern: ^[^\r\n]+$. Example: `<layers>`
- `state` (string): State abbreviation or name, such as NY or New York. Pattern: ^[^\r\n]+$. Example: `<state>`
- `street` (string): House number and street, such as 350 Fifth Avenue; needs zip, or city and state. Pattern: ^[^\r\n]+$. Example: `<street>`
- `vintage` (string): Geography release for the benchmark, such as Current_Current (the default for Public_AR_Current), ACS2025_Current, Census2020_Current, or Census2020_Census2020 and Census2010_Census2020 with Public_AR_Census2020. Defaults to the benchmark's default vintage. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<vintage>`
- `zip` (string): 5-digit ZIP or ZIP+4; the geocoder matches on the first five digits. Pattern: ^[0-9]{5}(-[0-9]{4})?$. Example: `<zip>`

Response schema example:
```json
{
  "benchmark": {
    "description": "Public Address Ranges - Current Benchmark",
    "name": "Public_AR_Current"
  },
  "match_count": 1,
  "matches": [
    {
      "address_range": {
        "from": "1600",
        "side": "L",
        "to": "1648"
      },
      "census": {
        "block": "1034",
        "block_geoid": "110019800001034",
        "block_group": "1",
        "county_fips": "001",
        "county_name": "District of Columbia",
        "state": "DC",
        "state_fips": "11",
        "state_name": "District of Columbia",
        "tract": "980000",
        "tract_geoid": "11001980000"
      },
      "components": {
        "city": "WASHINGTON",
        "pre_direction": null,
        "pre_qualifier": null,
        "pre_type": null,
        "state": "DC",
        "street_name": "PENNSYLVANIA",
        "suffix_direction": "NW",
        "suffix_qualifier": null,
        "suffix_type": "AVE",
        "urbanization": null,
        "zip": "20500"
      },
      "geographies": [
        {
          "area_land_m2": 158318974,
          "area_water_m2": 18707004,
          "attributes": {
            "BASENAME": "Delegate District (at Large)",
            "CD120": "98",
            "CDSESSN": "120",
            "CENTLAT": "+38.9047586",
            "CENTLON": "-077.0162860",
            "FUNCSTAT": "N",
            "LSADC": "C4",
            "STATE": "11",
            "STGEOMETRY_Area": 292742530.9541352,
            "STGEOMETRY_Length": 86300.89857680116
          },
          "geoid": "1198",
          "internal_point": {
            "latitude": 38.9042429,
            "longitude": -77.0165243
          },
          "layer": "120th Congressional Districts",
          "mtfcc": "G5200",
          "name": "Delegate District (at Large)"
        },
        {
          "area_land_m2": 144893,
          "area_water_m2": 0,
          "attributes": {
            "BASENAME": "1034",
            "BLKGRP": "1",
            "BLOCK": "1034",
            "CENTLAT": "+38.8970383",
            "CENTLON": "-077.0372535",
            "COUNTY": "001",
            "FUNCSTAT": "S",
            "LSADC": "BK",
            "LWBLKTYP": "L",
            "STATE": "11",
            "SUFFIX": "",
            "TRACT": "980000",
            "UR": "U"
          },
          "geoid": "110019800001034",
          "internal_point": {
            "latitude": 38.8970383,
            "longitude": -77.0372535
          },
          "layer": "2020 Census Blocks",
          "mtfcc": "G5040",
          "name": "Block 1034"
        },
        {
          "area_land_m2": 15330267,
          "area_water_m2": 3029412,
          "attributes": {
            "BASENAME": "2",
            "CENTLAT": "+38.9000370",
            "CENTLON": "-077.0463477",
            "FUNCSTAT": "N",
            "LDTYP": "O",
            "LSADC": "L1",
            "LSY": "2026",
            "SLDU": "002",
            "STATE": "11"
          },
          "geoid": "11002",
          "internal_point": {
            "latitude": 38.9001359,
            "longitude": -77.0457772
          },
          "layer": "2026 State Legislative Districts - Upper",
          "mtfcc": "G5210",
          "name": "Ward 2"
        },
        {
          "area_land_m2": 6514231,
          "area_water_m2": 4996397,
          "attributes": {
            "BASENAME": "9800",
            "CENTLAT": "+38.8801546",
            "CENTLON": "-077.0352173",
            "COUNTY": "001",
            "FUNCSTAT": "S",
            "LSADC": "CT",
            "STATE": "11",
            "TRACT": "980000"
          },
          "geoid": "11001980000",
          "internal_point": {
            "latitude": 38.8809933,
            "longitude": -77.0363219
          },
          "layer": "Census Tracts",
          "mtfcc": "G5020",
          "name": "Census Tract 9800"
        },
        {
          "area_land_m2": 34187211519,
          "area_water_m2": 5218656831,
          "attributes": {
            "BASENAME": "Washington-Baltimore-Arlington, DC-MD-VA-WV-PA",
            "CENTLAT": "+38.9848368",
            "CENTLON": "-077.2239743",
            "CSA": "548",
            "FUNCSTAT": "S",
            "HU100": "",
            "LSADC": "M0",
            "POP100": ""
          },
          "geoid": "548",
          "internal_point": {
            "latitude": 38.9901097,
            "longitude": -77.2234092
          },
          "layer": "Combined Statistical Areas",
          "mtfcc": "G3100",
          "name": "Washington-Baltimore-Arlington, DC-MD-VA-WV-PA CSA"
        },
        {
          "area_land_m2": 158318974,
          "area_water_m2": 18707004,
          "attributes": {
            "BASENAME": "District of Columbia",
            "CENTLAT": "+38.9047586",
            "CENTLON": "-077.0162860",
            "COUNTY": "001",
            "COUNTYCC": "H6",
            "COUNTYNS": "01702382",
            "FUNCSTAT": "F",
            "LSADC": "00",
            "STATE": "11"
          },
          "geoid": "11001",
          "internal_point": {
            "latitude": 38.9042429,
            "longitude": -77.0165243
          },
          "layer": "Counties",
          "mtfcc": "G4020",
          "name": "District of Columbia"
        },
        {
          "area_land_m2": 158318974,
          "area_water_m2": 18707004,
          "attributes": {
            "BASENAME": "Washington",
            "CENTLAT": "+38.9047586",
            "CENTLON": "-077.0162860",
            "COUNTY": "001",
            "COUSUB": "50000",
            "COUSUBCC": "C5",
            "COUSUBNS": "02390665",
            "FUNCSTAT": "F",
            "LSADC": "25",
            "STATE": "11"
          },
          "geoid": "1100150000",
          "internal_point": {
            "latitude": 38.9042429,
            "longitude": -77.0165243
          },
          "layer": "County Subdivisions",
          "mtfcc": "G4040",
          "name": "Washington city"
        },
        {
          "area_land_m2": 158318974,
          "area_water_m2": 18707004,
          "attributes": {
            "BASENAME": "Washington",
            "CBSAPCI": "Y",
            "CENTLAT": "+38.9047586",
            "CENTLON": "-077.0162860",
            "DISP_CLR": 3,
            "FUNCSTAT": "N",
            "LSADC": "25",
            "NECTAPCI": "N",
            "PLACE": "50000",
            "PLACECC": "C5",
            "PLACENS": "02390665",
            "STATE": "11",
            "STGEOMETRY_Area": 292742530.9541352,
            "STGEOMETRY_Length": 86300.89857680116
          },
          "geoid": "1150000",
          "internal_point": {
            "latitude": 38.9042429,
            "longitude": -77.0165243
          },
          "layer": "Incorporated Places",
          "mtfcc": "G4110",
          "name": "Washington city"
        },
        {
          "area_land_m2": 158318974,
          "area_water_m2": 18707004,
          "attributes": {
            "BASENAME": "District of Columbia",
            "CENTLAT": "+38.9047586",
            "CENTLON": "-077.0162860",
            "DIVISION": "5",
            "FUNCSTAT": "A",
            "LSADC": "00",
            "REGION": "3",
            "STATE": "11",
            "STATENS": "01702382",
            "STUSAB": "DC"
          },
          "geoid": "11",
          "internal_point": {
            "latitude": 38.9042429,
            "longitude": -77.0165243
          },
          "layer": "States",
          "mtfcc": "G4000",
          "name": "District of Columbia"
        },
        {
          "area_land_m2": 3352467067,
          "area_water_m2": 67696919,
          "attributes": {
            "BASENAME": "Washington--Arlington, DC--VA--MD",
            "CENTLAT": "+38.8953259",
            "CENTLON": "-077.1822243",
            "FUNCSTAT": "S",
            "LSADC": "67",
            "UA": "92242"
          },
          "geoid": "92242",
          "internal_point": {
            "latitude": 38.8959429,
            "longitude": -77.1830768
          },
          "layer": "Urban Areas",
          "mtfcc": "G3500",
          "name": "Washington--Arlington, DC--VA--MD Urban Area"
        }
      ],
      "latitude": 38.898702605245,
      "longitude": -77.035189204737,
      "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
      "street_line": "1600 PENNSYLVANIA AVE NW",
      "tiger_line_id": "76225813"
    }
  ],
  "observed_at_ms": 1795205419254,
  "query": {
    "address": "1600 Pennsylvania Ave NW, Washington, DC 20500",
    "city": null,
    "state": null,
    "street": null,
    "zip": null
  },
  "source_url": "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress?address=1600+Pennsylvania+Ave+NW%2C+Washington%2C+DC+20500&benchmark=Public_AR_Current&vintage=Current_Current&format=json",
  "vintage": {
    "description": "Current Vintage - Current Benchmark",
    "name": "Current_Current"
  }
}
```

### Geographies at

- Capability: `addresses/geographies_at`
- Description: Every census geography that contains a latitude and longitude: the state, county, tract and block codes, plus each layer (places, county subdivisions, urban and statistical areas, congressional and state legislative districts) with its GEOID, name, MAF/TIGER feature class, land and water area and internal point. A point outside the United States, Puerto Rico and the Island Areas returns no geographies with an outside_coverage warning.
- Instructions: Use when you already have coordinates (from a GPS fix, openstreetmap-org or another geocoder) and need the census tract, county FIPS code or districts for them. Pick decennial geography with benchmark Public_AR_Census2020 and vintage Census2020_Census2020; layers all adds school districts, ZCTAs and more.
- Cost: 5 credits per call
- Capability file: [Geographies at](https://alexandria.firecrawl.dev/agents/providers/geocoding-geo-census-gov/addresses/geographies_at)

Accepted options:
- `benchmark` (string): Address-range release: Public_AR_Current (default), Public_AR_ACS2026, Public_AR_LUCA or Public_AR_Census2020. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<benchmark>`
- `latitude` (number, required): Latitude, such as 37.7749. Example: `10`
- `layers` (string): Geocoder layer ids or names, comma-separated, or all (19 layers, adding school districts, ZCTAs, metro and micro areas and more). Omit for the default 10 or so layers. The geocoder ignores an unknown layer. Pattern: ^[^\r\n]+$. Example: `<layers>`
- `longitude` (number, required): Longitude, such as -122.4194 (west is negative). Example: `10`
- `vintage` (string): Geography release for the benchmark, such as Current_Current (the default for Public_AR_Current), ACS2025_Current, Census2020_Current, or Census2020_Census2020 and Census2010_Census2020 with Public_AR_Census2020. Defaults to the benchmark's default vintage. An unknown name fails as invalid_input listing the valid ones. Pattern: ^[A-Za-z0-9_]{1,60}$. Example: `<vintage>`

Response schema example:
```json
{
  "benchmark": {
    "description": "Public Address Ranges - Current Benchmark",
    "name": "Public_AR_Current"
  },
  "census": {
    "block": "1000",
    "block_geoid": "060750201011000",
    "block_group": "1",
    "county_fips": "075",
    "county_name": "San Francisco County",
    "state": "CA",
    "state_fips": "06",
    "state_name": "California",
    "tract": "020101",
    "tract_geoid": "06075020101"
  },
  "geographies": [
    {
      "area_land_m2": 107297587,
      "area_water_m2": 479610902,
      "attributes": {
        "BASENAME": "11",
        "CD120": "11",
        "CDSESSN": "120",
        "CENTLAT": "+37.7610466",
        "CENTLON": "-122.7003196",
        "FUNCSTAT": "N",
        "LSADC": "C2",
        "STATE": "06",
        "STGEOMETRY_Area": 940632026.9744955,
        "STGEOMETRY_Length": 210705.60664996534
      },
      "geoid": "0611",
      "internal_point": {
        "latitude": 37.7272391,
        "longitude": -123.0322294
      },
      "layer": "120th Congressional Districts",
      "mtfcc": "G5200",
      "name": "Congressional District 11"
    },
    {
      "area_land_m2": 11570,
      "area_water_m2": 0,
      "attributes": {
        "BASENAME": "1000",
        "BLKGRP": "1",
        "BLOCK": "1000",
        "CENTLAT": "+37.7742261",
        "CENTLON": "-122.4194393",
        "COUNTY": "075",
        "FUNCSTAT": "S",
        "LSADC": "BK",
        "LWBLKTYP": "L",
        "STATE": "06",
        "SUFFIX": "",
        "TRACT": "020101",
        "UR": "U"
      },
      "geoid": "060750201011000",
      "internal_point": {
        "latitude": 37.7742261,
        "longitude": -122.4194393
      },
      "layer": "2020 Census Blocks",
      "mtfcc": "G5040",
      "name": "Block 1000"
    },
    {
      "area_land_m2": 62987629,
      "area_water_m2": 130532630,
      "attributes": {
        "BASENAME": "17",
        "CENTLAT": "+37.7859416",
        "CENTLON": "-122.3859153",
        "FUNCSTAT": "N",
        "LDTYP": "O",
        "LSADC": "L3",
        "LSY": "2026",
        "SLDL": "017",
        "STATE": "06"
      },
      "geoid": "06017",
      "internal_point": {
        "latitude": 37.7860679,
        "longitude": -122.3863351
      },
      "layer": "2026 State Legislative Districts - Lower",
      "mtfcc": "G5220",
      "name": "Assembly District 17"
    },
    {
      "area_land_m2": 166462350,
      "area_water_m2": 510554648,
      "attributes": {
        "BASENAME": "11",
        "CENTLAT": "+37.7512734",
        "CENTLON": "-122.6708513",
        "FUNCSTAT": "N",
        "LDTYP": "O",
        "LSADC": "LU",
        "LSY": "2026",
        "SLDU": "011",
        "STATE": "06"
      },
      "geoid": "06011",
      "internal_point": {
        "latitude": 37.7046374,
        "longitude": -122.4998106
      },
      "layer": "2026 State Legislative Districts - Upper",
      "mtfcc": "G5210",
      "name": "State Senate District 11"
    },
    {
      "area_land_m2": 305224,
      "area_water_m2": 0,
      "attributes": {
        "BASENAME": "201.01",
        "CENTLAT": "+37.7702373",
        "CENTLON": "-122.4201473",
        "COUNTY": "075",
        "FUNCSTAT": "S",
        "LSADC": "CT",
        "STATE": "06",
        "TRACT": "020101"
      },
      "geoid": "06075020101",
      "internal_point": {
        "latitude": 37.7702373,
        "longitude": -122.4201473
      },
      "layer": "Census Tracts",
      "mtfcc": "G5020",
      "name": "Census Tract 201.01"
    },
    {
      "area_land_m2": 31066455166,
      "area_water_m2": 3498492869,
      "attributes": {
        "BASENAME": "San Jose-San Francisco-Oakland, CA",
        "CENTLAT": "+37.5500108",
        "CENTLON": "-121.5762227",
        "CSA": "488",
        "FUNCSTAT": "S",
        "HU100": "",
        "LSADC": "M0",
        "POP100": ""
      },
      "geoid": "488",
      "internal_point": {
        "latitude": 37.5199375,
        "longitude": -121.5755749
      },
      "layer": "Combined Statistical Areas",
      "mtfcc": "G3100",
      "name": "San Jose-San Francisco-Oakland, CA CSA"
    },
    {
      "area_land_m2": 120913761,
      "area_water_m2": 479701779,
      "attributes": {
        "BASENAME": "San Francisco",
        "CENTLAT": "+37.7600883",
        "CENTLON": "-122.6941393",
        "COUNTY": "075",
        "COUNTYCC": "H6",
        "COUNTYNS": "00277302",
        "FUNCSTAT": "C",
        "LSADC": "06",
        "STATE": "06"
      },
      "geoid": "06075",
      "internal_point": {
        "latitude": 37.7272391,
        "longitude": -123.0322294
      },
      "layer": "Counties",
      "mtfcc": "G4020",
      "name": "San Francisco County"
    },
    {
      "area_land_m2": 7672665,
      "area_water_m2": 12207,
      "attributes": {
        "BASENAME": "Mission-Bernal",
        "CENTLAT": "+37.7529305",
        "CENTLON": "-122.4155819",
        "COUNTY": "075",
        "COUSUB": "91976",
        "COUSUBCC": "Z5",
        "COUSUBNS": "02804910",
        "FUNCSTAT": "S",
        "LSADC": "22",
        "STATE": "06"
      },
      "geoid": "0607591976",
      "internal_point": {
        "latitude": 37.7532036,
        "longitude": -122.4157928
      },
      "layer": "County Subdivisions",
      "mtfcc": "G4040",
      "name": "Mission-Bernal CCD"
    },
    {
      "area_land_m2": 120913761,
      "area_water_m2": 479701779,
      "attributes": {
        "BASENAME": "San Francisco",
        "CBSAPCI": "Y",
        "CENTLAT": "+37.7600883",
        "CENTLON": "-122.6941393",
        "DISP_CLR": 4,
        "FUNCSTAT": "A",
        "LSADC": "25",
        "NECTAPCI": "N",
        "PLACE": "67000",
        "PLACECC": "C1",
        "PLACENS": "02411786",
        "STATE": "06",
        "STGEOMETRY_Area": 962575373.572042,
        "STGEOMETRY_Length": 205688.61291983497
      },
      "geoid": "0667000",
      "internal_point": {
        "latitude": 37.7272391,
        "longitude": -123.0322294
      },
      "layer": "Incorporated Places",
      "mtfcc": "G4110",
      "name": "San Francisco city"
    },
    {
      "area_land_m2": 403676534536,
      "area_water_m2": 20288534055,
      "attributes": {
        "BASENAME": "California",
        "CENTLAT": "+37.1547616",
        "CENTLON": "-119.5277735",
        "DIVISION": "9",
        "FUNCSTAT": "A",
        "LSADC": "00",
        "REGION": "4",
        "STATE": "06",
        "STATENS": "01779778",
        "STUSAB": "CA"
      },
      "geoid": "06",
      "internal_point": {
        "latitude": 37.1626642,
        "longitude": -119.5713456
      },
      "layer": "States",
      "mtfcc": "G4000",
      "name": "California"
    },
    {
      "area_land_m2": 1330135792,
      "area_water_m2": 31792944,
      "attributes": {
        "BASENAME": "San Francisco--Oakland, CA",
        "CENTLAT": "+37.7442567",
        "CENTLON": "-122.2913733",
        "FUNCSTAT": "S",
        "LSADC": "67",
        "UA": "78904"
      },
      "geoid": "78904",
      "internal_point": {
        "latitude": 37.7849693,
        "longitude": -122.2701107
      },
      "layer": "Urban Areas",
      "mtfcc": "G3500",
      "name": "San Francisco--Oakland, CA Urban Area"
    }
  ],
  "observed_at_ms": 1795205419258,
  "query": {
    "latitude": 37.7749,
    "longitude": -122.4194
  },
  "source_url": "https://geocoding.geo.census.gov/geocoder/geographies/coordinates?x=-122.4194&y=37.7749&benchmark=Public_AR_Current&vintage=Current_Current&format=json",
  "vintage": {
    "description": "Current Vintage - Current Benchmark",
    "name": "Current_Current"
  }
}
```
