## tidycensus

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

[![R build status](https://github.com/walkerke/tidycensus/workflows/R-CMD-check/badge.svg)](https://github.com/walkerke/tidycensus/actions) ![CRAN Badge](http://www.r-pkg.org/badges/version/tidycensus)  ![CRAN Downloads](http://cranlogs.r-pkg.org/badges/tidycensus)

__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: 

```r
install.packages("tidycensus")
```

For the latest updates, install from GitHub: 

```r
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:

```r
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.