With Geocodio, you can bulk lookup the Census demographic data for addresses or coordinates via API as well as spreadsheet upload. If you're uploading a spreadsheet, you can click the "Demographics" append in Step 3 of the upload process to append this data.
Geocodio returns Census demographic data from the most recent five-year American Community Survey, which is currently the 2023 survey results published in 2024. (The 1-year American Community Surveys do not have granularity at this level.)
As of API v1.8, ACS data is automatically returned at the most appropriate geographic level based on the accuracy of the geocoded result.
For example:
Accuracy Type | Census Geography |
---|---|
rooftop, range_interpolation, nearest_street, point, nearest_rooftop_match, street_center, intersection | Census Block Group |
nearest_place, place | Census Place |
county | County |
state | State |
With Geocodio, you can also explicitly request Census demographic data for a specific geographic level through our API or through the spreadsheet geocoding tool. Data is available at the following geographies:
Via API, you should add the geography name to your ACS field request. For example:
acs-demographics-tract (for Census Tract level)
acs-demographics-county (for County level)
acs-demographics-place (for Census Place level)
When using Geocodio's spreadsheet upload tool, you can choose which geographic level you'd like to receive Census demographic data for by using the dropdown menu that appears when the ACS Demographics data append has been selected.
Please note: We do not provide data at the individual household level.
If you are using an API version prior to v1.8, all results return at the Census Block Group level.
You can download an example of the results when you add Census demographics to a list of addresses here or latitude/longitude coordinates here.
Geocodio provides the data exactly as it is packaged by the Census Bureau in the breakouts it gives. The only change we have made is to add a "percentage" calculation to aid ease of use.
The data returned includes the following data points. For each data point, the data returned includes the value, margin of error, and percentage.
Total (Table #B01002)
Population by age range (Table #B01001)
Sex (Table #B01001)
Race and ethnicity (Table #B03002)
We recognize that age, sex, gender, race and ethnicity are sensitive subjects. Accordingly, we return the categories exactly as the Census Bureau provides. We recognize that the categories listed may not be all-inclusive or use preferred terminology.
There are a number of special values that may be returned when working with ACS data. Use the chart below to determine their meaning, which can assist with troubleshooting.
Value | Definition |
---|---|
-888888888 | Estimate not applicable or not available |
-999999999 | Insufficient sample cases in the geographic area |
-222222222 | Margin of error couldn't be computed due to insufficient sample |
-555555555 | Controlled estimate (no sampling error) |
Requests are billed as geocode + ACS Demographic info (i.e., two lookups). For example, if you have 100 addresses that you want Census demographic data for, that would count as 200 lookups.
You can calculate how much this will cost you and how long it will take here.