Table of Contents

Getting Started

What you can do with GeocodioSpreadsheet formattingFile formatsFile sizesIntersectionsAddress completionPreviewing your spreadsheetReverse geocoding

Families (Census)

With Geocodio, you can match addresses or coordinates to the Census Bureau's American Community Survey data on households and families. You can upload a spreadsheet, or use our API.

This data is provided at the Census Block Group level and is available from the most recent five-year American Community Survey, which is currently the 2021 survey results published in 2022. (The 1-year American Community Surveys do not have granularity at this level.)

This data is for the Census Block Group. It is not for the individual household. Please note, you must provide either street + ZIP, street + city + state, an intersection, or coordinates in order to receive Census results back. We do not provide this data for ZIP codes or city/state pairs. (If your data contains locations without street addresses, you will not be charged for the data append for those locations.)

Download an example

You can download an example of the results when you add Census family household information to a list of addresses here and to latitude/longitude coordinates here.

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.

Data Dictionary

The data returned includes the following data points. For each data point, the data returned includes the value, margin of error, and percentage.

  • Family households (Table #B11001)

    • total; married-couple family; other family; other family: male householder, no wife present; other family: female householder, no husband present; non-family households; non-family households -- householder living alone; non-family households -- householder not living alone
  • Household type by population (Table #B11002)

    • total; in family households; in married-couple family; in married-couple family: relatives; in married-couple family: non-relatives; in male householder, no wife present, family; in male householder, no wife present, family: relatives; in male householder, no wife present, family: nonrelatives; in female householder, no husband present, family; in female householder, no husband present, family: relatives; in female householder, no husband present, family: in nonfamily households
  • Marital status (Table #B12001)

    • never married; now married; now married: married, spouse present; married, spouse absent; married, spouse absent: separated; married, spouse absent: other; married, spouse absent, widowed; married, spouse absent, divorced; male never married; female never married

We recognize that household composition is a sensitive subject. Accordingly, we report the categories exactly as the Census Bureau provides. We recognize that the categories listed may not be all-inclusive or use preferred terminology.


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

You can calculate how much this will cost you and how long it will take here.

Copyright © 2014-2024 Dotsquare LLC, Norfolk, Virginia. All rights reserved.