IPUMS API

Interact with IPUMS using code

Get started

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, IPUMS CPS and IPUMS International data collections. More coming soon!

IPUMS API News

March 6, 2023 We've released Versions 1 and 2 of the newly unified IPUMS API! Version 1 contains all previously-released functionality and Version 2 introduces many new features and support for IPUMS International data extracts. See IPUMS API Versioning for details about 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.

API Reference

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.