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.
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.
You can register for an API key, free of charge by following these steps:
Once, you have a key, insert &key= followed by your key code at the end of your API calls: &key=your key here
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
If you have additional questions about the Census Data API, contact us by emailing email@example.com.