The American Community Survey (ACS) is an ongoing survey that provides data every year—giving communities the current information they need to make important decisions. The ACS covers a broad range of topics about social, economic, housing, and demographic characteristics of the U.S. population.
Detailed Tables, Subject Tables, Data Profiles, and Comparison Profiles are available for the nation, all 50 states, the District of Columbia, Puerto Rico, every congressional district, every metropolitan area, all counties, all places (i.e., towns or cities), and all census tracts and block groups.
Detailed Tables contain the most detailed estimates on all topics for all geographies. The data are presented as estimates.
Subject Tables provide a span of information on a particular ACS subject presented in the format of both estimates and percentages.
Data Profiles contain broad social, economic, housing, and demographic information. The data are presented as estimates and percentages.
Comparison Profiles are similar to Data Profiles but also include comparisons with past-year data. The current 5-year data are compared with the preceding non-overlapping 5-year data (e.g. 2018-2022 ACS 5-year estimates compared to 2013-2017 ACS 5-year estimates) and include statistical significance testing.
To create an API call, you must enter a specific URL into the address bar of a web browser. The call will vary depending on the following factors:
Year of data release
Dataset (ACS 1-year or 5-year)
Table ID
Geography level
Please review the example API calls for each of the table types listed below and use those examples to build your API calls. API calls are also available for tables found in data.census.gov by selecting the API function in the tool bar. Visit the API Resources page for tutorial videos, workshops and other tools.
The API is one of several ways to access ACS data. Visit the ACS Data page to find all the ways to access ACS data.
US Census Bureau has released the American Community Survey 5-year (ACS 5-yr) dataset for 2010-2014. The Detail Tables are now available in the API. Some topics from the 2010-2014 ACS 5-year data products are different from current year. For information on these changes, visit: