location.us.geographies

US Census Geographies

The official geographies containing a coordinate — state, county, tract, block group, block, place, congressional district and ZCTA — each with its FIPS or GEOID.

Example answer

Ask

Which county and census tract is this coordinate in?

GET /v1/locations/us/geographies?lat=38.8977&lon=-77.0365

Eckari

{
  "query": {
    "lat": 38.8977,
    "lon": -77.0365
  },
  "state": {
    "fips": "11",
    "name": "District of Columbia",
    "usps": "DC"
  },
  "county": {
    "fips": "11001",
    "name": "District of Columbia"
  },
  "tract": {
    "geoid": "11001980000",
    "name": "Census Tract 9800"
  },
  "block_group": {
    "geoid": "110019800001"
  },
  "block": {
    "geoid": "110019800001034"
  },
  "place": {
    "geoid": "1150000",
    "name": "Washington city"
  },
  "congressional_district": {
    "geoid": "1198",
    "name": "Delegate District (at Large)"
  },
  "zcta": {
    "geoid": "20006"
  },
  "vintage": "Current_Current",
  "benchmark": "Public_AR_Current"
}

Source: US Census Bureau
Freshness: Live
Price: $0.003

Version: 2.0.0
Transport: HTTP / MCP
Coverage: US

Use this when

Which county and census tract is this coordinate in?
You need the FIPS codes for a US latitude/longitude.
What congressional district covers this location?
You are joining points to census tract or block group statistics.
You need the ZIP Code Tabulation Area containing a point.
You want to know which incorporated place a coordinate falls in.

Don't use this when

You have an address rather than coordinates — use location.us.geocode first.
You need a USPS delivery ZIP code — ZCTAs are statistical approximations, not USPS ZIPs.
The coordinates are outside the US, DC, Puerto Rico and the US island areas.
You need demographic or economic values for the geography — this returns identifiers only.

If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the US Census Bureau Geocoding Services API record.

Input

latnumberrequired

Latitude in decimal degrees (WGS 84), e.g. 38.8977.

lonnumberrequired

Longitude in decimal degrees (WGS 84), negative in the western hemisphere, e.g. -77.0365.

What the result means

queryobject

The point that was looked up, echoed so a batched caller can match answers to requests.

stateobject, null

US state, district or territory containing the point.

countyobject, null

County or county equivalent containing the point; null when the Census Bureau returns no county layer.

tractobject, null

Census tract containing the point; null when the Census Bureau returns no tract layer.

block_groupobject, null

Census block group containing the point, or null.

blockobject, null

Census block containing the point (decennial census block layer), or null.

Provenance

Source: US Census Bureau
Freshness: Live · read at request time, not cached
Region: US

Access

Over MCP: location_us_geographies
Over HTTP: GET https://api.eckari.com/v1/locations/us/geographies
Price: $0.003 per call over x402. Account access $0.002 when that rail opens.