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-recordsParameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Required | Full name to search (e.g., "John Smith")Example: "John Smith" |
state | string | Optional | Two-letter state code or full state name (e.g., "CA" or "California"). Omit to search all states.Example: "CA" |
dob | string | Optional | Date 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.