Interact with IPUMS using code
Our Data, Your Way!
Now you can interact with IPUMS data products programmatically! The IPUMS API allows 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.
The IPUMS API allows 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, IPUMS USA and IPUMS CPS data collections. More coming soon!
IPUMS API News
March 6, 2023 The unified IPUMS API Version 1 is launched! There are no changes in Version 1, but Version 2 was released concurrently with many new features. Please see IPUMS API Versioning for details of this change.
February 17, 2023 - Watch a recording of the 1-hour webinar on using the IPUMS Microdata Extract API & IPUMS CPS to create reproducible workflows, held on Tuesday, February 21, 2023.
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 the IPUMS API.
Looking for endpoints? The reference section lists details for every endpoint in our API.
About the IPUMS API Program
Overview and roadmap for the IPUMS API Program.