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:

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

How-To Materials for Using the Census API

• https://www.census.gov/data/what-is-data-census-gov/guidance-for-data-users/how-to-materials-for-using-the-census-api.html Recorded webinars, short videos, and step-by-step PDF walkthroughs with screenshots

Dataset Discovery Tool:

• https://api.census.gov/data.html List of Census API Datasets
• https://api.census.gov/data.xml List of Census API Datasets in XML
• https://api.census.gov/data.json List of Census API Datasets in JSON

Census Data API Developers Page:

• https://www.census.gov/developers/

Convert JSON to CSV data:

• https://www.convertcsv.com/json-to-csv.htm

Guide to Accessing Census Data API via Python

• https://pypi.python.org/pypi/census/0.5

Census Bureau Geography

• https://www.census.gov/programs-surveys/geography.html

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