Endpoints
Domain report
Check a domain before you buy it: its archive history, whether the links it is sold on still exist, and the questions only the seller can answer.
POST
/v1/domain/report
Request
Every tool takes the same shape: a URL or a list, a few options, and back comes data plus what the call cost.
import requestsr = requests.post( 'https://api.snoopscan.com/v1/domain/report', headers={'Authorization': 'Bearer sk_YOUR_KEY'}, json={ 'domain': 'example.com', 'depth': 'buyer' },)print(r.json())
const r = await fetch('https://api.snoopscan.com/v1/domain/report', { method: 'POST', headers: { Authorization: 'Bearer sk_YOUR_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ "domain": "example.com", "depth": "buyer" }),});console.log(await r.json());
curl -X POST https://api.snoopscan.com/v1/domain/report \ -H 'Authorization: Bearer sk_YOUR_KEY' \ -H 'Content-Type: application/json' \ -d '{ "domain": "example.com", "depth": "buyer"}'
Returns findings · concerns · archive history · link checks · quick 5 · buyer 33 · deep 160 credits.
Parameters
Read from the engine itself, so this table is the request it actually validates.
| Field | Type | Default | What it does |
|---|---|---|---|
domain
required |
string | — | A domain, or any URL on it. https://www.example.com/a and example.com are the same request. |
depth
|
quick · buyer · deep | buyer | quick for registration, DNS and today's site; buyer adds history, backlinks and link checks; deep uses larger samples. |
snapshots
|
integer | — | How many archived homepage snapshots to read, one per year at most. Defaults to 6 for buyer and 12 for deep. |
verifyLinks
|
integer | — | How many linking pages to re-read to confirm the link is still there. Defaults to 20 for buyer and 50 for deep. |
Response
A success is always {"success": true, "data": {…}}. data carries what you asked for in formats, the page's metadata, and a cost object saying what the call was charged. A failure is {"success": false, "error": {…}} with a code you can branch on — see Errors.
Nothing is charged for a request that failed.
A page you already fetched, re-read within
maxAge, is free; one served from the shared index costs a single credit. The cost object says which it was.