U.S. flag

An official website of the United States government

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

Census Data API User Guide

The purpose of this user guide is to instruct developers and researchers on how to use the Census Data Application Programming Interface (API) to request data from U.S. Census Bureau datasets.

Help & Contact Us
  • Overview
  • What is the API
  • Available Data
  • Core Concepts
  • Example API Queries
  • Help & Contact Us
Help & Contact Us

Query Limits

You can include up to 50 variables in a single API query and can make up to 500 queries per IP address per day. More than 500 queries per IP address per day requires that you register for a Census key. That key will be part of your data request URL string.

Please keep in mind that all queries from a business or organization having multiple employees might employ a proxy service or firewall. This will make all of the users of that business or organization appear to have the same IP address.  If multiple employees were making queries, the 500-query limit would be for the proxy server/firewall, not the individual user.

You also need an API key if you create a mobile or web application that makes more than 500 queries to the API in a day. This cumulative limit is reached by adding up all instances when the application queries the Census Data API, even if multiple users access your application through different IP addresses.

API Key

You can register for an API key, free of charge by following these steps:

  1. Go to the Developers site
  2. Click on the Request a KEY box on the left side of the page.
  3. Fill out the pop-up window form.
  4. You will receive an email with your key code in the message and a link to register it.

Once, you have a key, insert &key= followed by your key code at the end of your API calls: &key=your key here

Resources for Learning More

How-To Materials for Using the Census API

Dataset Discovery Tool:

Census Data API Developers Page:

Convert JSON to CSV data:

Guide to Accessing Census Data API via Python

Census Bureau Geography

Contact Us

If you have additional questions about the Census Data API, contact us by emailing cedsci.feedback@census.gov.

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