An Introduction to the IPUMS Extract API for Microdata

By Renae Rodgers

Have you heard the news?! The IPUMS Extract API now supports microdata! For users who have been clamoring for this feature for some time, feel free to skip to the final section for resources to get started. For our users who haven’t been awaiting this announcement with bated breath, and who may be saying to themselves, “ok…great…but…”


via GIPHY

This blog post will give a brief introduction to APIs, give some examples of ways to use the IPUMS Extract API in your workflow, and share some more in-depth resources.

What is an API?

API stands for Application Programming Interface. An API is an intermediate layer between a user and a server that allows the user to interact programmatically with another program or a service. First, the user’s program talks to the API – this is known as making an API call or a request. The API, in turn, talks to the server, translating the user’s request into something the server can understand. The server returns the requested information to the API, and the API then returns that information to the user. For example, Google Maps has an API that allows developers to request and retrieve information from Google Maps from within their applications, without needing to go through a web interface.

At this point you may be thinking, “great, now I have a general idea of what an API is, but I am not a software developer so… thanks anyway.”


via GIPHY

The IPUMS Extract API opens up many possibilities for easing collaboration, and creating efficient workflows with only a few simple lines of code. Please read on!

Continue reading…

IPUMS International 2022 Data Release

By Jane Lyon Lee, IPUMS International

IPUMS International has added 7 new census samples and new labor force surveys including the first-time data release from the Slovak Republic and historical samples from Egypt 1848 and 1868. The other newly added samples extend pre-existing series. The growing IPUMSI labor force survey collection has expanded with the addition of quarterly surveys from Mexico (ENOE 2005-2020) and more data from Spain & Italy. See a summary of the full IPUMS collection on the IPUMSI samples page.

Continue reading…

How the COVID-19 Pandemic Impacted the 2020 ACS 1-year PUMS Data

By Danika Brockman and Megan Schouweiler

One of the highlights of the past IPUMS USA release was the 2020 ACS 1-year Public Use Microdata Sample (PUMS) file. Due to the effects of the COVID-19 pandemic on 2020 ACS data collection and data quality, the Census Bureau did not release the standard PUMS data. Instead, they released the 2020 ACS 1-year data with experimental weights designed to account for the impact of the COVID-19 pandemic on data quality. In this blog post, we discuss the impact of the COVID-19 pandemic on the 2020 ACS and the development of the experimental weights, and we provide some recommendations for using the 2020 ACS 1-year PUMS file.

Impact of the Covid-19 Pandemic on Data Collection and Data Quality and the Development of the Experimental Weights

The COVID-19 pandemic severely disrupted data collection for the 2020 ACS. All methods of data collection were either shut down or significantly reduced from March 2020 through the end of the year. Data collection for group quarters was particularly disrupted by the COVID-19 pandemic; in-person visits to group quarter facilities were suspended or greatly reduced from March 2020 through the end of the year, and telephone interviews were not conducted due to logistical constraints. Beyond the impacts to data collection methods, the 2020 ACS had significant variability across the 2020 data collection year in response rates for both housing units and group quarters, and had the lowest overall response rate in the history of the ACS1.

Continue reading…

IPUMS FAQs: How do the original occupation and industry codes map onto harmonized versions created by IPUMS?

By Kari Williams

As part of the IPUMS mission to democratize data, our user support team strives to answer your questions about the data. Over time, some questions are repeated. This blog post is an extension of an earlier series addressing frequently asked questions. Maybe you’ll learn something. Perhaps you’ll just find the information interesting. Regardless, we hope you enjoy it!

Here’s one of those questions:

How do the original occupation and industry codes map onto harmonized versions created by IPUMS?

Continue reading…

Using the MEPS-HC to Study Change in Adult Mental Health

By Julia A. Rivera Drew and Natalie Del Ponte

The Medical Expenditure Panel Survey-Household Component, or MEPS-HC, data are an invaluable resource for studying short-term trajectories in health, including adult mental health. An integrated series of the MEPS-HC data is available at IPUMS MEPS. Collected on the Self-Administered Questionnaire and, starting in 2019, the Preventive Self-Administered Questionnaire, the MEPS-HC includes two validated adult mental health scales. The Kessler Psychological Distress Scale (K6) and the two-item Patient Health Questionnaire depression screener (PHQ-2) are asked twice per panel, during interview rounds 2 and 4 (see Table 1). There are also two validated scales measuring health-related quality of life (HRQOL) that capture several interrelated health domains, including mental health. These include the Short Form-12 (SF-12) in 2000-2016 and the Veterans RAND-12 (VR-12) starting in 2017 (see Table 2 for VR-12 measures). For more information on the SF-12, see the section on SF-12 scoring on MCS and for more information on the VR-12, see ADDAYA.

Continue reading…

Introducing CPS-ASEC Longitudinal Extracts

By Renae Rodgers

The panel component of the Current Population Survey and new Longitudinal Extracts

Did you know that the Current Population Survey (CPS) – an important source of information on unemployment, poverty, and many other topics – has a panel component? If you didn’t, you’re not alone. The CPS rotation pattern is complex and can be difficult to work with. In fact, IPUMS CPS has held multi-day workshops intended to introduce researchers to the CPS panel component, help them understand the rotation pattern, and show some convenient IPUMS CPS features that make working with CPS panel data a little easier. If you’re completely new to the CPS panel, check out the materials from our latest workshop!

Maybe you did know about the CPS panel component, but looked at the complex rotation pattern, the Census Bureau guidelines and linking keys, and decided that this was for the birds. If this sounds like you, then our newest IPUMS CPS feature may be right for you! IPUMS CPS users can now download CPS-ASEC panels that contain two observations per person across a one-year period as longitudinal extracts. The rest of this blog post will explain what you are getting when you make a CPS-ASEC longitudinal extract and will walk you through how to create one for yourself.

Continue reading…