tidycensus is an R package that allows users to interface with the US Census Bureau’s decennial Census and five-year American Community APIs and return tidyverse-ready data frames, optionally with simple feature geometry included. Install from CRAN with the following command:


tidycensus is designed to help R users get Census data that is pre-prepared for exploration within the tidyverse, and optionally spatially with sf. To learn more about how the package works, plase read through the following articles:

Future development

To keep up with on-going development of tidycensus and get even more examples of how to use the package, subscribe to the Walker Data email list below. You’ll also get updates on the forthcoming CRC Press book Analyzing the US Census with R, which will cover a wide range of Census data analysis applications.

While tidycensus focuses on a select number of US Census Bureau datasets, there are many others available via the Census Bureau API. For access to all of these APIs, please check out Hannah Recht’s excellent censusapi package.

If you find tidycensus useful in your work and would like to ensure continued development of the package, you can provide support in the following ways:

Note: This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.