Census Income Data

With Geocodio's Economics data append, you can bulk match addresses or coordinates to the Census Bureau's American Community Survey data for Census median household income data. This data is available via API as well as spreadsheet upload. If you're uploading a spreadsheet, you can click the "Economics" append in Step 3 of the upload process to append this data.

Geocodio's Census income data is 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.)

Selecting the geography level

With version 1.8 of the Geocodio API and the current version of the spreadsheet geocoding tool, Census median household income data is automatically returned at the most appropriate geographic-level based on the accuracy of the geocoded result.

For example:

With Geocodio, you can also explicitly request Census household income data for a specific geographic level through our API or through the spreadsheet geocoding tool. Data is available at the following geographies:

• Block Group
• Tract
• Place
• County Subdivision
• County
• MSA
• State

Via API, you should add the geography name to your ACS field request. For example:

• acs-economics-tract (for Census Tract level)
• acs-economics-county (for County level)
• acs-economics-place (for Census Place level)

When using our spreadsheet upload tool, you can choose which geographic level you'd like to receive data for by using the dropdown menu that appears when the ACS Economics 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 Block Group level.

Download an example

You can download an example spreadsheet of addresses with Census household income data added here.

Economics Data Returned

We provide 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.

• Median household income (Table #B19013)

• Household income (Table #B19001)

  • less than $10,000; $10,000-$14,999; $15,000-$19,999; $20,000-$24,999; $25,000-$29,999; $30,000-$34,999; $40,000-$44,999; $45,000-$49,999; $50,000-$59,000; $60,000-$74,999; $75,000-$99,999; $100,000-$124,999; $125,000-$149,000; $150,000-$199,999; $200,000 or more

• Per capita income (Table #B19301)

Census Household Income Data Returned

There are a number of special values that may be returned when working with ACS data. You can use the chart below to determine their meaning when troubleshooting.

Cost

Requests are billed as geocode + Census Economics info (i.e., two lookups). For example, if you have 100 addresses that you want ACS economics data for, that would count as 200 lookups.

Pay-as-you-go customers can calculate how much this will cost you and how long it will take here.