README.md

May 12, 2026 ยท View on GitHub

tidycensus

<img src=tools/readme/tidycensus_sticker.png width = "250px">

R build status CRAN Badge CRAN Downloads

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:

install.packages("tidycensus")

For the latest updates, install from GitHub:

remotes::install_github("walkerke/tidycensus")

To learn more about the package, please visit the package documentation at https://walker-data.com/tidycensus/ or read the book Analyzing US Census Data: Methods, Maps, and Models in R at https://walker-data.com/census-r/.

A free Census API key is required to use tidycensus. Obtain one at https://api.census.gov/data/key_signup.html and register it with:

library(tidycensus)
census_api_key("YOUR API KEY GOES HERE", install = TRUE)

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