The IPUMS USA API

IPUMS USA Data Extract API

The IPUMS USA Data Extract API is currently in beta status and supports a subset of IPUMS USA extract system functionality. Supported features include:

  • Extracts rectangularized on person records
  • Pre-selected variables included by default
  • CSV or fixed-width data file output
  • Formatted data files for Stata, SPSS and SAS

Currently unsupported features include:

  • Hierarchical extracts for H/P records
  • Case Selection
  • Attached Characteristics
  • Custom sample sizes
  • Household-only extracts
  • Data Quality Flags

For more details, please see the IPUMS USA API data extract workflows and the reference documentation.

Where is the Metadata API?

At this time, there is not a publicly available metadata API for IPUMS USA. While we hope to provide one in the future, it is possible to use the IPUMS USA website to gather all of the necessary information to make a request to the IPUMS USA Data Extract API. This includes information such as sample IDs and variable mnemonics.

In particular, we’d like to draw your attention to the IPUMS USA sample IDs page. The other primary piece of required metadata – the variable mnemonics – are displayed when viewing variables in the IPUMS USA extract building interface.