R build status CRAN BadgeCRAN Downloads

tidycensus is an R package that allows users to interface with a select number of the US Census Bureau’s data 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:

If you’d like to go further with tidycensus, be sure to check out the following resources:

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.