What's in this dataset
Resolve any U.S. address or coordinate to the law-enforcement agency that actually polices it, then pull that agency's reported crime record straight from the FBI Crime Data Explorer — eight offense types, per-100k rates, percentile context against four comparison cohorts (national, state, metro-area, and county), 3-year and 5-year trends, county and CBSA rollups with explicit coverage floors and disclosure bands, and NIBRS premise breakdowns that show how much reported crime happens at commercial locations. Built to a strict zero-bias mandate — no demographic fields anywhere, no safety scores, no grades, no leaderboards, and missing data returned as an explicit null with a stable machine-readable reason code rather than a silent zero. Every percentile ships with its cohort, comparison-universe size, and release identity, so numbers arrive with the caveats attached.
Capabilities at a glance
POST /v1/analyze— Primary one-call location analysis — resolves an address or lat/lng and returns the agency, selected year, offense counts, rates, state/national context rates, four-cohort percentiles, 3yr/5yr trends, premise data, and all applicable disclosures. Body: { address: string } OR { latitude: number, longitude: number }, plus optional { year: number }. Prefer coordinates (see geocoding caveat).POST /v1/resolve-agency— Resolve an address or coordinate to covering_agencies[] (best-match order), fallback_agencies[], nearest_agencies[], the resolved county_fips, and confidence values (place_match, county_match, state_fallback). Body: { address } OR { latitude, longitude }.GET /v1/agencies/{ori}— Agency identity, geography, population history (with population_carried_forward flags), offense-year range, and premise-year availability.GET /v1/agencies/{ori}/offenses— Offense counts and reporting coverage by year.GET /v1/agencies/{ori}/percentiles— National, state, CBSA, and county percentile cohorts by year and metric, each with ranking_universe_size and stable reason codes where null.GET /v1/agencies/{ori}/trends— Flat 3-year and 5-year trend records with window_years and trend_direction (increasing/decreasing/stable).GET /v1/agencies/{ori}/premise— NIBRS premise buckets and shares, bucket_rates_per_100k, offense-by-premise per_offense matrix, and availability/reason fields. NIBRS-complete years only.GET /v1/counties/{fips}— County rollup — per-year summed counts and recomputed rates with raw population_coverage_pct, coverage floor/ceiling withholding, and disclosure-band notes.GET /v1/counties/{fips}/percentiles— County-vs-county percentiles for eligible rollup years.GET /v1/cbsa/{cbsa_code}— CBSA/metro rollup across member counties with the same coverage rules as counties.GET /v1/cbsa/{cbsa_code}/percentiles— CBSA-vs-CBSA percentiles for eligible rollup years.GET /v1/meta/offenses— Offense vocabulary and premise bucket definitions (free — no lookup cost).GET /v1/meta/percentile-breakpoints— National p10–p90 distributions by year and metric (free — no lookup cost).GET /v1/meta/coverage— Coverage, year semantics (max_data_year vs latest_complete_year, provisional_years), release identity (release_id, build_marker, schema_version), and source freshness (free — no lookup cost).GET /v1/version— Immutable build identity — git_sha, build_timestamp, source_digest, deployment_id (free and unmetered).
Example queries
What does reported crime look like around 100 S University Ave, Provo, UT?Which law-enforcement agency covers this property, and what are its reported offense counts?How does this agency's total crime rate compare nationally, statewide, within its metro area, and within its county?What are the 3-year and 5-year trends in property crime for this jurisdiction?What share of reported offenses here occur at commercial premises like retail and lodging?Show the county-level crime rollup for Utah County and how it ranks against other counties.How does this CBSA's total crime rate compare to other metro areas?What is the latest complete data year and release identity for this dataset?Full reference
Reference documentation coming soon.
Skills powered by this dataset
No published skills tag this dataset yet — but every skill in the Hub can call it directly via MCP or REST.