Getting Started


Install getcensus from SSC with:

ssc install getcensus

getcensus requires Stata version 13.1 or later.

The GitHub version of the package may occasionally be more up-to-date than the SSC version. You can install getcensus from GitHub by running:

net install getcensus, from("") replace


We recommend using getcensus with an API key, which can acquired free at Remember to activate your API key before attempting to use it. Without an API key, queries are limited to 500 per day per IP address.


To update your installation of getcensus to the latest version, run:

ado update getcensus, update

A list of changes in each release can be found in News.

Getting Help

If you think you’ve found a bug in getcensus, or have an idea for a new feature, please file a GitHub issue at You’ll need a free GitHub account, which you can obtain at