Introduction to IPUMS and the IPUMS API

Chapter 1.1 | Data Sources and APIs

The IPUMS (Integrated Public Use Microdata Series) provides access to high-quality, harmonized data on population and health from around the world. Developed and maintained by the Institute for Social Research and Data Innovation (ISRDI) at the University of Minnesota's Minnesota Population Center (MPC), IPUMS datasets cover a range of demographic, health, and geographic topics that support research in fields like public health, economics, geography, and social sciences. IPUMS data offerings include U.S. Census data, global demographic surveys, and health datasets, all standardized across time and location to allow for easy cross-temporal and cross-national comparisons.

Available Data

United States Data

International Data

The ipumsr R Package

The ipumsr package is a tool for loading, managing, and analyzing IPUMS data within R. Designed to simplify the process of working with IPUMS extracts, ipumsr provides functions to import data, handle metadata, and apply labeled values directly, making it easier to move from raw data to analysis. This package supports both the classic rectangular datasets from IPUMS as well as more complex hierarchical files.

The IPUMS API

The ipumsr package uses the IPUMS API to extract data requests from IPUMS.

An API (Application Programming Interface) is a set of rules and protocols that allow different software applications to communicate with each other. APIs enable automated access to data and services, allowing users to retrieve, manipulate, and manage information without directly interacting with a website or user interface.

In the case of IPUMS, the API provides a streamlined, programmatic way to access data, making it possible to request and download datasets directly within R.

★ Create Your IPUMS Account and API Key ★

To download IPUMS data you will need to set up an IPUMS account and to submit data requests using the IPUMS API you will need to obtain an IPUMS API key. You can register for an IPUMS account and get your IPUMS API key by following the instructions on the IPUMS website.

IPUMS API Functionality for IPUMS Data

Use of the IPUMS API with ipumsr supports the following levels of functionality for each IPUMS project.

Browse Metadata, Request and Download Data, Read Data Extracts

Request and Download Data, Read Data Extracts

Read Data Extracts only

Not Currently Supported

★ Thank You ★

Thank you so much for engaging with this notebook and supporting the project! The R Spatial Notebooks Project is a labor of love so if you enjoy or benefit from these notebooks, please consider donating to the project. Your support allows me to continue producing notebooks and supporting the R Spatial Notebooks community.