This page will help you get started with Offenders.io API.
If you don't have an API key yet, contact us ([email protected]) to obtain one. Or you can self-serve your API key via the RapidAPI platform https://rapidapi.com/offenders-offenders-default/api/sex-offenders. Please note, to play with the API sandbox here, you will need an API key directly from us.
This API supports two types of searches: GIS Search and Attribute Search.
GIS Search
You can use the Javascript example below to fetch the data from Offenders.io's Sex Offender API endpoint, this example demonstrates how you can use our endpoint to use GIS search that is based on lat, lng and radius.
You can further filter down your result by firstName
,lastName
, dob
, city
, state
, zipcode
and dob
fetch('https://api.offenders.io/sexoffender?lat=30.967139&lng=-91.116236&radius=2&key={YOUR_API_KEY}&firstName=Michael&dob=1900-01-01', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
}
})
.then(response => response.json())
.then(data => {
console.log(data)
});
Attribute Search
Offenders.io's Sex Offender API endpoint also supports general searches by offenders'firstName
, lastName
, dob
, city
, state
, zipcode
and dob
. You can combine them however you like, as long as there's at least one of them in the query param.
Attribute Search - Extensive Mode (requires Mega+ tier)
The Attribute Search supports an additional &mode=extensive
param, which will pull additional datasets including the offender's photo URL and source link to the State agency website. Please note this will come with a significant response time increase compared to the normal mode and should only be used if needed (~ 2s+ response time).
fetch('https://api.offenders.io/sexoffender?key={YOUR_API_KEY}&firstName=Michael&zipcode=12345&dob=1900-01-01', {
method: 'GET',
headers: {
'Content-Type': 'application/json',
}
})
.then(response => response.json())
.then(data => {
console.log(data)
});
Read Our Full Integration Guide
Ready to integrate? Take a look at our full integration guide to view additional details about our request and response fields, as well as other things like error handling. Please email [email protected] to get a copy of our integration guide.