Interact with IPUMS using code

Get started

Our Data, Your Way!

Now you can interact with IPUMS data products programmatically! IPUMS APIs allow you to explore and retrieve IPUMS data in a whole new way. You can automate and integrate IPUMS data into your own tools and workflows.

Our first public APIs, the IPUMS Metadata and Data Extract APIs, allow you to submit a JSON request to describe the data you want, monitor our progress building your data extract, and download your data when it is ready. Currently it supports IPUMS NHGIS and IPUMS USA data. More coming soon!

Join our Beta Program - Like being on the leading edge? Interested in helping us test our APIs as we build them? Check out our beta program!


June 3, 2022 - IPUMS USA and IPUMS CPS Extract API public betas are launched!

December 1, 2021 - IPUMS USA Extract API early beta program is launched!

December 17, 2019 - NHGIS Metadata and Data Extract APIs have reached v1.0!

October 30, 2019 - We've added shapefiles, extent selection, year selection and breakdown values to the IPUMS NHGIS Metadata and Data Extract Beta APIs! The docs have all the info.

September 23, 2019 - We've added time series data and table-level metadata to the IPUMS NHGIS Metadata and Data Extract Beta APIs! See the docs for more details.

April 24, 2019 - We're pleased to announce the launch of the IPUMS NHGIS Metadata and Data Extract Beta APIs!

Example Workflows and Code

These sample workflows walk you through a few tasks you can accomplish with IPUMS APIs.

API Reference

Looking for endpoints? The reference section lists details for every endpoint in our APIs.

About the IPUMS API Program

Overview and roadmap for the IPUMS API Program.