FBI Crime Data Scraper — Statistics & NIBRS Counts

Query the FBI Crime Data Explorer for structured annual crime statistics and aggregated NIBRS offense counts. This actor is designed for researchers, journalists, analysts, public-sector teams, and AI agents that need a compact, repeatable FBI crime-data surface.

What it returns

Each dataset item represents one normalized FBI observation, usually one year × offense × geography combination. Fields include:

Field	Meaning
recordType	summary or nibrs-offense-count
dataYear	Calendar year supplied by the FBI API
locationLevel	National, state, or agency
stateCode / ori	State abbreviation or FBI agency ORI when present
offense	Query slug such as violent-crime or robbery
count / actual / cleared	Normalized count fields when the endpoint supplies them
rate / population	Rate and population fields when supplied
raw	Compact source row for endpoint-specific fields
sourceUrl	Exact FBI API request URL
warnings	Coverage and interpretation notes

Supported modes

Summary crime statistics

Use dataMode: "summary" for FBI SRS-style summaries by national, state, or agency. State mode uses a two-letter stateCode; agency mode uses an FBI ORI. Common offense slugs include:

violent-crime, property-crime, homicide, rape, robbery, aggravated-assault, burglary, larceny, motor-vehicle-theft, and arson.

NIBRS offense counts

Use dataMode: "nibrs" with locationLevel: "state" for state-level offense-count aggregates. NIBRS data is more detailed than SRS, but this public API surface returns aggregated counts—not raw incident/case records. Use the FBI Crime Data Explorer bulk-download files for raw NIBRS segment data.

Example input

{
  "dataMode": "summary",
  "locationLevel": "state",
  "stateCode": "CA",
  "offenses": ["violent-crime", "property-crime", "homicide"],
  "fromYear": 2020,
  "toYear": 2024,
  "maxResults": 100,
  "apiKey": "DEMO_KEY"
}

For a NIBRS offense-count query:

{
  "dataMode": "nibrs",
  "locationLevel": "state",
  "stateCode": "TX",
  "offenses": ["robbery", "aggravated-assault"],
  "fromYear": 2022,
  "toYear": 2024
}

Use a registered api.data.gov key for larger or repeated runs. DEMO_KEY is intended for small tests and is subject to a low shared limit.

Pricing

Event	Price
Actor start	$0.00005
Stored crime observation	$0.002

The actor prints the maximum result-charge cap at startup. A result event is charged only after its validated dataset write succeeds. Invalid, empty, or blocked requests do not generate result charges.

Data and coverage notes

The FBI Crime Data Explorer is a reporting system. Counts reflect data submitted by participating law-enforcement agencies and may vary by year, endpoint, and reporting coverage. NIBRS counts are not equivalent to total crime victimization and should not be presented as a complete census of crime. The actor preserves endpoint-specific raw fields and warnings to support downstream review.

The current implementation uses the FBI's first-party public API endpoints at cde.ucr.cjis.gov. API endpoint behavior and data availability can change as the FBI updates the Crime Data Explorer. The actor fails honestly when every requested endpoint is unavailable rather than emitting fabricated rows.

When not to use this actor

Do not use it for live emergency information, individual criminal-history checks, personally identifying information, case-level incident files, geospatial hot-spot analysis, or legal conclusions. Do not infer that zero returned NIBRS rows means zero crime; it may mean no participating data for that query.

Source

Official source: FBI Crime Data Explorer. The FBI Crime Data Explorer describes its purpose as providing public access to criminal and noncriminal law-enforcement data and publishes UCR summary and NIBRS resources.

Related workflow

For raw incident research, download the relevant annual NIBRS files from the FBI Crime Data Explorer and process the pipe-delimited segments with the FBI technical specification. For quick state or national trend tables, use this actor with a narrow year range and a registered API key.