Official websites use .gov
A .gov website belongs to an official government organization in the United States.
Secure .gov websites use HTTPS
A lock (
) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.
About
Available APIs
Guidance
Latest Releases
Population Estimates APIs
Each year, the Census Bureau's Population Estimates Program uses current data on births, deaths, and migration to calculate population change since the most recent decennial census and produces a time series of estimates of population, demographic components of change, and housing units. The annual time series of estimates begins with the most recent decennial census data and extends to the vintage year. As each vintage of estimates includes all years since the most recent decennial census, the latest vintage of data available supersedes all previously-produced estimates for those dates.
Note: These products were redesigned in 2015 to provide a better user experience for developers.
Population Estimates
- API Call: api.census.gov/data/2017/pep/population
- Examples and Supported Geographies: api.census.gov/data/2017/pep/population.html
- Variables: api.census.gov/data/2017/pep/population/variables.html
- Example Call: July 1, 2016 Population for all regions
api.census.gov/data/2017/pep/population?get=POP,GEONAME&for=region:*&DATE=9&key=YOUR_KEY
Components of Change Estimates
- API Call: api.census.gov/data/2017/pep/components
- Examples and Supported Geographies: api.census.gov/data/2017/pep/components.html
- Variables: api.census.gov/data/2017/pep/components/variables.html
- Example Call: Number of births and deaths between July 1, 2016 and July 1, 2017
api.census.gov/data/2017/pep/components?get=BIRTHS,DEATHS,GEONAME&for=state:06&PERIOD=7&key=YOUR_KEY
National Monthly Population Estimates
- API Call: api.census.gov/data/2017/pep/natmonthly
- Examples and Supported Geographies: api.census.gov/data/2017/pep/natmonthly.html
- Variables: api.census.gov/data/2017/pep/natmonthly/variables.html
- Example Call: Total population each month from July to December 2017
api.census.gov/data/2017/pep/natmonthly?get=POP&for=us:*&MONTHLY=76:82&key=YOUR_KEY
Demographic Characteristics Estimates by Age Groups
- API Call: api.census.gov/data/2017/pep/charagegroups
- Examples and Supported Geographies: api.census.gov/data/2017/pep/charagegroups.html
- Variables: api.census.gov/data/2017/pep/charagegroups/variables.html
- Example Call: July 1, 2017 population in Alabama
api.census.gov/data/2017/pep/charagegroups?get=POP,GEONAME&for=state:01&DATE=9&key=YOUR_KEY
Housing Unit Estimates for the US, States, and Counties
- API Call: api.census.gov/data/2017/pep/housing
- Examples and Supported Geographies: api.census.gov/data/2017/pep/housing.html
- Variables: api.census.gov/data/2017/pep/housing/variables.html
- Example Call: Housing estimate for the Petersburg census area, Alaska for all dates
api.census.gov/data/2017/pep/housing?get=DATE,GEONAME,HUEST&for=county:195&in=state:02&key=YOUR_KEY
Demographic Characteristics Estimates by Single Year of Age and Sex
- API Call: api.census.gov/data/2017/pep/charage
- Examples and Supported Geographies: api.census.gov/data/2017/pep/charage.html
- Variables: api.census.gov/data/2017/pep/charage/variables.html
- Example Call: July 1, 2017 population in Alabama
api.census.gov/data/2017/pep/charage?get=AGE,SEX,POP&for=state:01&key=YOUR_KEY
Related Information
Population Estimates Categorical Variables 2017
Developers' Forum
Need help? Check out our Developer Forum to submit questions, share your apps, and provide feedback.
FTP Server
To download full datasets, visit our FTP Server.
Population and Housing Unit Estimates
Produces estimates of the population for the United States, its states, counties, cities, and towns, as well as for the Commonwealth of Puerto Rico.
Page Last Revised - December 8, 2021
✕
Is this page helpful?
Yes
No
Yes
No✕
NO THANKS
255 characters maximum
255 characters maximum reached
255 characters maximum reached
✕
Thank you for your feedback.
Comments or suggestions?
Comments or suggestions?
