Request Data from the National Crime Victimization Survey (NCVS)

Source: R/ncvs_api.R

Returns data from NCVS API

ncvs_api(year = 2016, dataset = "personal", population = FALSE, ...)

Arguments

year

These data-archives span all the way back from 1993 to 2016. Currently there is no way to query multiple years at a time. The default year is 2016.
dataset

The API provides two different datasets, the personal victimization, and household victimization for all years.
population

A boolean value specifying whether to return personal victimization population of incidents reported to the NCVS by year.
...

Any additional parameters

Value

A tibble containing information downloaded from API.

Note

Please be aware of the Decennial Sample Redesign: "In 2006 and 2016, the NCVS sample was redesigned to reflect changes in the population based on the most recent Decennial Census. The redesign impacted the comparability of 2006 and 2016 estimates to prior years of data. Use caution when comparing 2006 and 2016 estimates to other years. See Criminal Victimization, 2006 Technical Notes (BJS Web, NCJ 219413, December 2007), Criminal Victimization, 2007 (BJS Web, NCJ 224390, December 2008) and Criminal Victimization, 2016 (BJS Web, NCJ 250652, November 2017) for more information."

See also

https://www.bjs.gov/developer/ncvs/methodology.cfm

Examples


# A request for personal victimization survey for the year 2012

dat <- ncvs_api(year = 2012, dataset = "personal", population = FALSE)
#> Trying BJS Servers...
#> Payload Successful

# A request for household victimization survey for the year 1994

dat <- ncvs_api(year = 1994, dataset = "household", population = FALSE)
#> Trying BJS Servers...
#> Payload Successful