U.S. Department of Commerce

Access Data with the Census API

Available Data

Now available: The Economic Indicators Time Series Database

See details

American Community Survey 5 Year Estimates

The American Community Survey (ACS) is an ongoing survey that provides data every year -- giving communities the current information they need to plan investments and services. The ACS covers a broad range of topics about social, economic, demographic, and housing characteristics of the U.S. population. Much of the ACS data provided on the Census Bureau's Web site are available separately by age group, race, Hispanic origin, and sex. The 5-year estimates from the ACS are "period" estimates that represent data collected over a period of time. The primary advantage of using multiyear estimates is the increased statistical reliability of the data for less populated areas and small population subgroups.

The call to the API for the 2008-2012 5 Year summary file estimates is:

http://api.census.gov/data/2012/acs5?

Example call to the API for the 2008-2012 data profiles - (See notes)

http://api.census.gov/data/2012/acs5/profile?get=DP02_0001PE&for=state:*&key=...

The call to the API for the 2007-2011 5 Year summary file estimates is:

http://api.census.gov/data/2011/acs5?

The call to the API for the 2006-2010 5 Year summary file estimates is:

http://api.census.gov/data/2010/acs5?

ACS Web site: http://www.census.gov/acs/
Documentation: http://www.census.gov/acs/www/data_documentation/documentation_ main/

  • Tips for using ACS data in support of the "National day of Civic Hacking" American Community Challenge
  • American Community Survey 3 Year Estimates

    2010-2012 data profiles and summary files for the nation, all 50 states, the District of Columbia, Puerto Rico, every congressional district, every metropolitan area, and all counties and places with populations of 20,000 or more.

    Example call to the API for the 2010-2012 data profiles

    http://api.census.gov/data/2012/acs3/profile?get=DP02_0001PE&for=state:*&key=...

    The call to the API for the 2010-2012 summary

    http://api.census.gov/data/2012/acs3?

    American Community Survey 1 Estimates

    2012 data profiles and summary files for the nation, all 50 states, the District of Columbia, Puerto Rico, every congressional district, every metropolitan area, and all counties and places with populations of 65,000 or more.

    Example call to the API for the 2012 data profiles

    http://api.census.gov/data/2012/acs1/profile?get=DP02_0001PE&for=state:*&key=...

    The call to the API for the 2012 summary files

    http://api.census.gov/data/2012/acs1?

    Note: 2011 data are only available for Congressional Districts.

    Example calls to the API for the 2011 estimates for the 113th Congressional Districts are:

    Get a variable across all districts: http://api.census.gov/data/2011/acs1_cd113?key=...&get=DP02_0001E&for=congressional+district:*
    Get a variable across all districts in a state: http://api.census.gov/data/2011/acs1_cd113?key=...&get=DP02_0001E&for=congressional+district:*&in=state:06
    Get a variable for a single district: http://api.census.gov/data/2011/acs1_cd113?key=...&get=DP02_0001E&for=congressional+district:12&in=state:06

    Notes on Data Profiles

    Please note that the data profiles may return the following in place of data:

    An '**' entry in the margin of error column indicates that either no sample observations or too few sample observations were available to compute a standard error and thus the margin of error. A statistical test is not appropriate.

    An '-' entry in the estimate column indicates that either no sample observations or too few sample observations were available to compute an estimate, or a ratio of medians cannot be calculated because one or both of the median estimates falls in the lowest interval or upper interval of an open-ended distribution.

    An '-' following a median estimate means the median falls in the lowest interval of an open-ended distribution.

    An '+' following a median estimate means the median falls in the upper interval of an open-ended distribution.

    An '***' entry in the margin of error column indicates that the median falls in the lowest interval or upper interval of an open-ended distribution. A statistical test is not appropriate.

    An '*****' entry in the margin of error column indicates that the estimate is controlled. A statistical test for sampling variability is not appropriate.

    An 'N' entry in the estimate and margin of error columns indicates that data for this geographic area cannot be displayed because the number of sample cases is too small.

    An '(X)' means that the estimate is not applicable or not available.

    2010 Census Summary File 1 (SF1)

    Summary File 1 (SF 1) contains the data compiled from the questions asked of all people and about every housing unit. Population items include sex, age, race, Hispanic or Latino origin, household relationship, household type, household size, family type, family size, and group quarters. Housing items include occupancy status, vacancy status, and tenure (whether a housing unit is owner-occupied or renter-occupied).

    SF 1 includes population and housing characteristics for the total population, population totals for an extensive list of race (American Indian and Alaska Native tribes, Asian, and Native Hawaiian and Other Pacific Islander) and Hispanic or Latino groups, and population and housing characteristics for a limited list of race and Hispanic or Latino groups. Population and housing items may be cross-tabulated. Selected aggregates and medians also are provided.

    The API provides access to a majority of SF1 tables, but not all.

    SF1 includes population tables (identified with a ''P'') and housing tables (identified with an ''H'') shown down to various levels of geography.

    The call to the API for this data set is

    http://api.census.gov/data/2010/sf1?

    2000 Census Summary File 1 (SF1) and Summary File 3 (SF3)

    Summary File 3 consists of 813 detailed tables of Census 2000 social, economic and housing characteristics compiled from a sample of approximately 19 million housing units (about 1 in 6 households) that received the Census 2000 long-form questionnaire.

    The calls to the API for this data set are

    http://api.census.gov/data/2000/sf1?

    http://api.census.gov/data/2000/sf3?

    Census Geographic Relationship Files are provided as a tool to help data users compare the universe of 2000 Census geographies to the universe of 2010 geographies.

    1990 Census Summary File 1 (SF1) and Summary File 3 (SF3)

    The calls to the API for this data set are

    http://api.census.gov/data/1990/sf1?

    http://api.census.gov/data/1990/sf3?

    Census Geographic Relationship Files are provided as a tool to help data users compare the universe of 1990 Census geographies to the universe of 2000 Census geographies.

    [PDF] or PDF denotes a file in Adobe’s Portable Document Format. To view the file, you will need the Adobe® Reader® Off Site available free from Adobe.
    This symbol Off Site indicates a link to a non-government web site. Our linking to these sites does not constitute an endorsement of any products, services or the information found on them. Once you link to another site you are subject to the policies of the new site.
    Source: U.S. Census Bureau | ADCOM/IT | | Last Revised: February 21, 2014