readiness

Start an AI agent readiness check (async job)

Starts a Free B2B AI Visibility Checker scan of a company's website: a 0-100 score for how well buyers' AI agents can research the company, evaluate its product and reach sales, with evidence-backed findings. A scan takes longer than one request, so this is an async job. A new check returns 202 Accepted with a job_id, a status_url and a Location header pointing at GET /agent/readiness/checks/{job_id}: poll it every Retry-After seconds until status is complete or failed, then read report_json_url (the report as JSON) or report_url (the human page). A public check of a domain already scanned in the last 24 hours returns 200 with the cached report instead of starting a new job. Anonymous. Rate limits per caller IP: 60 requests a minute, plus 3 new checks and 3 comparisons a day without a Turnstile token. Not mirrored under /agent/v1.

post/agent/readiness/checks

Request

  • Base URL: https://vertodigital.com
  • URL: https://vertodigital.com/agent/readiness/checks
  • Auth: none declared

Request body

domainstring required

Website to check, as a domain or URL (example.com or https://www.example.com/). Subdomains fold into the main domain. In compare mode, the competitor's domain.

mode'public' | 'compare'

public: check one company and publish its report. compare: check two companies side by side (set compare_with).

compare_withstring

Compare mode only: your own company's domain, checked side by side with the competitor in domain.

turnstile_tokenstring

Cloudflare Turnstile token sent by the checker's own web page. Agents omit it; the lower daily limits then apply.

Response

This domain was checked in the last 24 hours: the cached report, no new job

status'complete' required
cachedtrue required
report_urlstring uri required

The report page

report_json_urlstring uri required

The report as JSON: GET /agent/readiness/reports/{slug}

Changes

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