ScraperCity logo

Criminal Records Search API Documentation

Criminal Records Search

Search nationwide criminal records across Sex Offender Registry, Department of Corrections, Arrest Records, and Court Records. Free if no records are found. Submit one name per request.

$1.00 per search (only charged if records found)POST /api/v1/scrape/criminal-records

Parameters

NameTypeRequiredDescription
namestringRequiredFull name to search (e.g., "John Smith")Example: "John Smith"
statestringOptionalTwo-letter state code or full state name (e.g., "CA" or "California"). Omit to search all states.Example: "CA"
dobstringOptionalDate of birth to filter results (e.g., "02/07/1992"). Only records matching this DOB will be returned. You are only charged if DOB-matched records are found.Example: "02/07/1992"

Examples

Search with state filter

curl -X POST https://app.scrapercity.com/api/v1/scrape/criminal-records \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "state": "CA"
  }'

# Response:
{
  "runId": "abc123...",
  "name": "John Smith",
  "state": "CA",
  "message": "Criminal records search queued. Poll /api/v1/scrape/status/abc123 for progress.",
  "note": "You will only be charged $1 if records are found."
}

# Poll for completion:
curl https://app.scrapercity.com/api/v1/scrape/status/abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

# When status is SUCCEEDED, download CSV:
curl https://app.scrapercity.com/api/downloads/abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Search all states

curl -X POST https://app.scrapercity.com/api/v1/scrape/criminal-records \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Jane Doe" }'

Search with DOB filter

curl -X POST https://app.scrapercity.com/api/v1/scrape/criminal-records \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "state": "CA",
    "dob": "02/07/1992"
  }'

# Only records with an exact DOB match to 02/07/1992 will be returned.
# No charge if no DOB-matched records are found.

Use Cases

  • Background screening (non-FCRA purposes only)
  • Due diligence research
  • Public records research
  • Investigative journalism

Best Practices

  • Submit one name per API call - for multiple names, make multiple requests
  • Only charged $1 if records are found - no charge for names with no results
  • Use full names for best results (e.g., "John Michael Smith")
  • State filter accepts "CA", "California", or "california" - all normalized to abbreviation
  • DOB filter accepts most date formats: "02/07/1992", "1992-02-07", "February 7 1992"
  • When DOB is provided, only exact DOB matches are returned and you are only charged if matches exist
  • Results include Sex Offender Registry, Department of Corrections, Arrest Records, and Court Records
  • NOT for employment screening, tenant screening, or any FCRA-regulated purpose
  • Poll /api/v1/scrape/status/{runId} until status is SUCCEEDED
  • Download CSV results using /api/downloads/{runId}

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.