Skip to main content

​
Quickstart

This guide walks through creating a DarkRecon scan and retrieving full results via scan_id.

​
1) Set your API key

export DARKRECON_API_KEY="YOUR_API_KEY"

​
2) Start a scan

Call POST /scan with either:
  • queries: a list of emails and/or phone numbers
  • domain: a domain to enumerate and scan
curl -X POST "https://darkrecon.1337807.xyz/scan" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DARKRECON_API_KEY" \
  -d '{
    "queries": ["john@example.com", "+1234567890"]
  }'
The response includes:
  • scan_id: UUID used to fetch full results
  • status: success, no_results, or no_queries
  • total_breaches: count of breaches found

​
3) Retrieve full scan results

curl -X GET "https://darkrecon.1337807.xyz/scan/YOUR_SCAN_ID" \
  -H "X-API-Key: $DARKRECON_API_KEY"
The response includes:
  • queries and optional domain
  • results.data: values by category (emails, usernames, passwords, IPs, etc.)
  • results.counts: aggregated counts per category
  • results.occurrences: breach-source occurrence metadata

​
Next steps

  • /darkrecon/api/start-scan
  • /darkrecon/api/get-scan-results
  • /darkrecon/schemas/scan-request
  • /darkrecon/schemas/scan-result