GET
/
v1
/
census
/
income

This API endpoint calculates the median income inside a circle from US Census data. You can provide either a coordinate (latitude and longitude) or an address, plus a radius around the center.

This endpoint is useful for real estate applications, when one might want to contextualize a property according to its surrounding neighborhood.

Request Parameters

center
string

The center of the circle as a coordinate. Residents inside this circle will be counted in calculating income statistics.

The center coordinate is formatted as longitude,latitude. One of center or address is required.

address
string

The center of the circle as an address. Residents inside this circle will be counted in calculating income statistics.

If the address is ambiguous, the best result will be chosen, which may or may not be the target address. To get the best results, provide the full address, including: building number, street name, city name, state, zip code, and country.

An example address is 335 McAllister St, San Francisco, CA 94102. One of center or address is required.

radius
number
required

The radius around the center, in meters. Maximum radius is 16,093 meters (10 miles).

api_key
string
required

Your account’s API key. You can create an API key by registering for an account and copy and paste it from your account dashboard.

Response

When features are successfully counted, a 200 OK response will be issued, with Content-Type: application/json. The body will have a property median_income which will be a floating point number representing the median income of residents of the circle, in US dollars.

median_income
number

The median income of the population of the circle, according to US Census data.

source
string

A descriptive source for the data, including the year the data was collected.

In the event of an error, an error response will be issued, usually with a 5xx error code. The error will be JSON-formatted, with an error field describing the cause.

error
string

The error message if the extract request parameters were incorrectly formatted.

This response field will not be present if the extract succeeds.

Data License

This API serves data from the US Census Bureau, which is freely available.