U.S. flag

An official website of the United States government

Skip Header
About
Guidance
Latest Releases
Search data, events, resources, and more

Census Microdata API User Guide

The purpose of this guide is to provide an overview of the U.S. Census Bureau’s microdata application programming interface (API) and walk through how to make queries. Through this guide, you will learn what the microdata API is, when to use it, and how to use it to get raw data and custom statistics.

What is the Microdata API
  • What is Public Use Microdata
  • What is the Microdata API
  • Dataset Types
  • Types of Microdata API Queries
  • Terms
  • Additional Concepts
  • How To Create API Queries
  • Limitations, Contact Us & Appendix
What is the Microdata API

What is the Microdata API?

The microdata application programming interface (API) is a data service that allows software developers to access and use Census Bureau microdata within their applications. The service allows users to request results for individual microdata records or create custom statistics.

Like any data from the API, the microdata API is an efficient way to query data directly from Census Bureau servers with many advantages:

  • No need to host data on own server
  • Connects to statistical software like R and SAS
  • Provides immediate access to most current data
  • Facilitates building new mobile and Web applications
  • Drives interactive data visualizations

Microdata Access on data.census.gov is a prime example of an interactive application powered by the microdata API. All the data in Microdata Access is being requested in real time from the microdata API and fed on your screen in a user-friendly way. This allows you to access the data by navigating an intuitive system rather than making requests directly to the microdata API, which is the focus of this guide. Please visit the Microdata Access Resources page if you would like to learn how to use Microdata Access on data.census.gov.

In comparison to bulk downloads of microdata from the file transfer protocol (FTP) sites, the microdata API and Microdata Access on data.census.gov provide unique benefits. They both allow you to:

  • Create custom statistics without using your own statistical software.
  • Download a subset of microdata records instead of the entire dataset. Specifically, you can limit your data requests to get data only for specific variables or geographies. You can also apply universe restrictions prior to downloading the microdata records.

Page Last Revised - December 21, 2023
Is this page helpful?
Thumbs Up Image Yes Thumbs Down Image No
NO THANKS
255 characters maximum 255 characters maximum reached
Thank you for your feedback.
Comments or suggestions?

Top

Back to Header