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.

Dataset Types
  • 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
Dataset Types

Dataset Types: Aggregate, Microdata, or N/A

The API provides access to many different types of data, and the API Discovery Tool shows the complete list of datasets in the Census Data API.

When you visit the Discovery Tool, browse the column titled “Dataset Type” (see Figure 1). This will tell you whether an API dataset is:

  • Aggregate: Provides data that the Census Bureau have tabulated to get results for a specific geography.
  • Microdata: Provides untabulated, raw data. You can use these individual records to create custom statistics using the appropriate weights, universe, and geography.
  • N/A: A timeseries dataset.

This user guide describes how to use the microdata API. If the statistics you need are available through an aggregate or timeseries dataset, we recommend using those datasets instead of the microdata API. To learn how to use aggregate and timeseries datasets, please see the API User Guide.

Figure 1: Dataset Type Column in the API Discovery Tool

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