Scan a site

If a result from the last day already has those checks, the API returns it with 200. If a scan of the site is already running, it returns that scan with 202; otherwise it starts a new scan and returns 202. Read the scan at links.self until complete is true: the first results arrive within seconds, and slower sources follow. A scan runs only what its checks need, so fewer checks are faster and cost less. A read-only key gets a recent result or a running scan, but never starts a new one (read_only_key). To check a fix, ask for the readiness check with again: true: once its last result is a few minutes old, the check runs again.

Request

curl -X POST "https://api.checkanysite.com/v1/scans" \
  -H "Authorization: Bearer $CHECKANYSITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "wikipedia.org", "checks": ["ai"]}'

from checkanysite import CheckAnySite

client = CheckAnySite()  # Reads the key from CHECKANYSITE_API_KEY.

scan = client.scans.create("wikipedia.org", checks=["ai"])

const url = 'https://api.checkanysite.com/v1/scans';
const response = await fetch(url, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CHECKANYSITE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ domain: 'wikipedia.org', checks: ['ai'] }),
});
const scan = await response.json();

Parameters

• Idempotency-Keystringheader

  A unique value for this request, such as a UUID. A retry with the same key within 24 hours returns the first response (Idempotent-Replayed: true), and never starts a second scan or charges twice. The same key with a different request returns idempotency_key_reused.

Request body

JSON, with Content-Type: application/json. A field we don’t know is refused, so a typo never passes silently.

• domainstringrequiredbody

  A domain, or a URL whose host is used.

• checksarray of one of: ai, readiness, popularity, tech, dns, trust, summary, historybody

  The checks to answer; left out, every check. A scan runs only what they need, and the call costs what they cost.

• againbooleanbody

  With the readiness check: ask it again once its answer is 3 minutes old, to check a fix. Without it, and for other checks, a result from the last 24 hours answers.

  Default: false

Response

{
  "id": "0b5a7a6e-1f7e-4d7c-9a4e-2f0d8b1c6a11",
  "domain": "wikipedia.org",
  "checks": [
    "ai"
  ],
  "status": "queued",
  "createdAt": "2026-11-10T09:30:00.000Z",
  "finishedAt": null,
  "complete": false,
  "failure": null,
  "result": null,
  "links": {
    "self": "https://api.checkanysite.com/v1/scans/0b5a7a6e-1f7e-4d7c-9a4e-2f0d8b1c6a11?checks=ai",
    "result": "https://checkanysite.com/site/wikipedia.org?focus=ai"
  }
}

• idstring

  The scan’s id.

• domainstring

  The domain scanned.

• checksarray of one of: ai, readiness, popularity, tech, dns, trust, summary, history

  The checks its result holds: those asked that the scan answers.

• statusstring

  Where it is: queued, running, completed or failed.

  One of: queued, running, completed, failed.

• createdAtdate-time

  When it was asked for.

• finishedAtdate-time or null

  When it finished; null while it runs.

• completeboolean

  True once the scan failed, or completed with every slow source in.

• failureobject or null

  Why the scan couldn’t finish; null unless status is failed.

• resultobject or null

  The result once status is completed.

• linksobject

  Where to poll the scan, and where its result is shown.

Once completed, result holds the site’s result, as on the result object.

Errors