Skip to content
Close API

Search census places by name

GET
/v1/places

Resolve a city/town name to its census place GEOID and WGS84 centroid. Free (no API key). Matches are ranked prefix-first, then by population. Feed lon/lat into /v1/blocks/query (center + radius_m), or geoid into /v1/places/{geoid}/blocks.

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
q
required
Q

Name substring, e.g. ‘Providence’

string
>= 2 characters <= 80 characters

Name substring, e.g. ‘Providence’

limit
Limit
integer
default: 10 >= 1 <= 20

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

PlacesResponse
object
places
required
Places
Array<object>
Place

A census place (city/town) matched by name, with its GEOID and WGS84 centroid. (routers.places.places)

object
geoid
required
Geoid

Census place GEOID

string
lat
required
Lat

Centroid latitude (WGS84)

number
lon
required
Lon

Centroid longitude (WGS84)

number
name
required
Name
string
state
Any of:
string