getCensus: Retrieve Census data from a given API

In censusapi: Retrieve Data from the Census APIs

Retrieve Census data from a given API

Description

Retrieve Census data from a given API

Usage

getCensus(
  name,
  vintage = NULL,
  key = Sys.getenv("CENSUS_KEY"),
  vars,
  region = NULL,
  regionin = NULL,
  time = NULL,
  year = NULL,
  date = NULL,
  period = NULL,
  monthly = NULL,
  show_call = FALSE,
  convert_variables = TRUE,
  category_code = NULL,
  data_type_code = NULL,
  naics = NULL,
  pscode = NULL,
  naics2012 = NULL,
  naics2007 = NULL,
  naics2002 = NULL,
  naics1997 = NULL,
  sic = NULL,
  ...
)

Arguments

name	The programmatic name of your dataset, e.g. 'timeseries/poverty/saipe' or 'acs/acs5'. See 'listCensusApis()' for options.
vintage	Vintage (year) of dataset, e.g. 2014. Not required for timeseries APIs.
key	Your Census API key, obtained at https://api.census.gov/data/key_signup.html. This function will default to a 'CENSUS_KEY' stored in your .Renviron if available.
vars	List of variables to get. Required.
region	Geography to get.
regionin	Optional hierarchical geography to limit region.
time, year, date, period, monthly	Optional arguments used for some time series APIs.
show_call	List the underlying API call that was sent to the Census Bureau.
convert_variables	Convert likely numeric variables into numeric data. Default is true. If false, results will be characters, which is the type returned by the Census Bureau.
category_code, data_type_code, naics, pscode, naics2012, naics2007, naics2002, naics1997, sic	Optional arguments used in economic data APIs.
...	Other valid arguments to pass to the Census API. Note: the APIs are case sensitive.

Examples

## Not run: 
# Get total population and median household income for places (cities, towns, villages)
# in one state from the 5-year ACS.
acs_simple <- getCensus(
  name = "acs/acs5",
  vintage = 2020,
  vars = c("NAME", "B01001_001E", "B19013_001E"),
  region = "place:*",
  regionin = "state:01")
head(acs_simple)

# Get all data from the B19013 variable group.
# This returns estimates as well as margins of error and annotation flags.
acs_group <- getCensus(
  name = "acs/acs5",
  vintage = 2020,
  vars = c("B01001_001E", "group(B19013)"),
  region = "place:*",
  regionin = "state:01")
head(acs_group)

# Retreive 2010 Decennial Census block-level data within a specific tract,
# using the regionin argument to precisely specify the Census tract.
decennial_2010 <- getCensus(
  name = "dec/sf1",
  vintage = 2010,
  vars = c("NAME","P001001"),
  region = "block:*",
  regionin = "state:36+county:027+tract:010000")
head(decennial_2010)

# Get poverty rates for children and for people of all ages over time using the
# Small Area Income and Poverty Estimates API
saipe <- getCensus(
  name = "timeseries/poverty/saipe",
  vars = c("NAME", "SAEPOVRT0_17_PT", "SAEPOVRTALL_PT"),
  region = "state:01",
  year = "2000:2019")
head(saipe)

# Get County Business Patterns data for a specific NAICS sector.
cbp_2016 <- getCensus(
 name = "cbp",
  vintage = "2016",
  vars = c("EMP", "ESTAB", "NAICS2012_TTL", "GEO_TTL"),
  region = "state:*",
  naics2012 = "23")
head(cbp_2016)

## End(Not run)

censusapi documentation built on Aug. 9, 2022, 5:07 p.m.