Microproduct Data GuideBeginner

Census Geocoder Address Lookup

U.S. Census Bureau address-to-tract geocoding responses for assigning a user-entered address to its reviewed Census geography.

Start the Guide Open Official Source Open in Colab
Report a Problem

At a Glance

Difficulty
Beginner — comfortable for a first prototype
Size
Tiny · ≤0.01 GB
Formats
JSON
Access
API
API Key
Not Required
Provider
U.S. Census Bureau
Updates
Occasional
Last Verified
Sep 28, 2026
Source Type
Government Source
Data Terms
Census API terms permit search and analysis; identify the Census source and state that Census does not endorse or certify the resulting application.
  • Python Syntax Checked
  • Runnable Notebook

From Source to Product Signal

Test a Product Idea in Four Steps

The Census Geocoder returns address matches and Census tract geography for one submitted U.S. address. Start with the Census Bureau's own public example address and request the current 2020 geography vintage. Do not send confidential addresses in a tutorial; an approximate range match needs review before it is used as a property location.

1

Check the Setup

  • Python 3.10 or newer
  • An internet connection
  • The requests Python package
2

Access the Data

  1. 1.Read the official geocoding request format and API terms.
  2. 2.Request one public example address with an explicit benchmark and vintage.
  3. 3.Inspect the returned tract identifier and match quality.
Open Official Source
3

Run the Python Example

Install the packages, then run the notebook cell.

python -m pip install requests

import requests

response = requests.get(
    "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress",
    params={"address": "4600 Silver Hill Rd, Washington, DC 20233",
            "benchmark": "Public_AR_Current", "vintage": "Census2020_Current",
            "format": "json"}, timeout=30,
)
response.raise_for_status()
for match in response.json()["result"]["addressMatches"][:5]:
    tracts = match["geographies"].get("Census Tracts", [])
    print(match["matchedAddress"], [tract["GEOID"] for tract in tracts])
4

Test a Useful Signal

Check a Census Tract Match

Inspect a public example address before using geocoding in a local lookup.

  1. 01Keep the matched address, coordinates, benchmark, vintage, and tract GEOID.
  2. 02Handle zero or multiple matches without silently choosing one.
  3. 03Explain why address-range coordinates can differ from a parcel location.

Related Datasets

Dataset Details

U.S. Census Bureau is a government source. Last verified 2026-09-28. Temporal coverage: current address-range benchmark with selectable geography vintage.

Domains

Geography

Data Types

Geospatial

Geography

United States

Formats

JSON

Provider

U.S. Census Bureau

Data Terms

Census API terms permit search and analysis; identify the Census source and state that Census does not endorse or certify the resulting application.

Send Feedback