IPUMS APIs

Interact with IPUMS using code

Get started

Our Data, Your Way!

Now, for the first time, 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 data. IPUMS USA coming soon!

BETA Alert - We're just getting started building IPUMS APIs. The APIs are currently available on an invite-only basis so we can ramp up thoughtfully. Like being on the leading edge? Interested in helping us test our APIs as we build them? Contact us at ipums+api@umn.edu and ask for access to our beta API program.

IPUMS API News

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.