Scan a domain as several crawler identities and return a graded record

post/api/scan

Request

  • Base URL: https://crawlcheck.io
  • URL: https://crawlcheck.io/api/scan
  • Auth: none required

Request body

domainstring required

A bare domain or a full URL

visibility'public' | 'unlisted' | 'private'

unlisted: the report is reachable only by its link; the scan is sealed and archived but enters no public registry, dataset, history or resolve answer. private: needs a licence for the domain (or the owner); the report opens only for that licence holder or the owner and is not archived or listed anywhere (default public)

Example request

{
  "domain": "example.com"
}

Response

The scan record

idstring

Report id; the report renders at /r/{id} and the record at /r/{id}.json

domainstring
grade'A' | 'B' | 'C' | 'D' | 'F' | 'null' nullable

null when the origin refused CrawlCheck or the scan could not be graded

overallinteger nullable

AI visibility: reach, then read, then quote

refusedboolean

The homepage and a path that cannot exist answered identically: a wall, not a site. Nothing is scored

self_auditobject

Invariants checked on this record itself; a finding here is a defect in CrawlCheck, never in the site

Changes

No recorded changes to this operation across all 1 revision of this API.