ncvs_api {bjscrapeR}R Documentation

Request Data from the National Crime Victimization Survey (NCVS)


Returns data from NCVS API


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



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.


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


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


Any additional parameters


A tibble containing information downloaded from API.


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


# A request for personal victimization survey for the year 2012
dat <- ncvs_api(year = 2012, dataset = "personal", population = FALSE)

# A request for household victimization survey for the year 1994
dat <- ncvs_api(year = 1994, dataset = "household", population = FALSE)

[Package bjscrapeR version 0.1.0 Index]