Re-check AI visibility
Queue a fresh AI visibility scan of one verified website, for example after fixing robots.txt or publishing llms.txt.
https://api.rankparse.com/v1/site-scan/recheckFreeAPI keyQueues one AI visibility scan of a website. The scan runs in the background, usually within a few minutes. Read the result with Get AI visibility: scanned_at changes when it has finished.
The website must be verified and the workspace on a paid plan. One re-check per website per 10 minutes is allowed.
Query parameters
site_idstringrequiredA website id from Websites, sent in the query string. The request has no body. A missing, unknown, archived or other workspace's id returns 404 site_scan_site_not_found.
Response
site_idstringThe website.
statusstringqueued (HTTP 202): the scan was queued. throttled (HTTP 200): a re-check was already requested in the last 10 minutes, and nothing changed.
retry_after_secondsintegerOnly with throttled: seconds until a new re-check is accepted.
Behavior and limits
- Cost: 0 credits.
- Throttle: one re-check per website per 10 minutes, shared by everyone in the workspace and the dashboard's Re-check button. The daily background scan also counts: a re-check within 10 minutes of the website being queued for it is throttled. A throttled call is a
200, not an error. - Checks run in order: the website must exist, then be verified (
400 site_scan_not_verified), then the plan must include the scan (403 site_scan_plan_required). - Plan re-read: if the workspace moves to the Free plan while the scan is queued, the scan is skipped.
- Permissions: needs the
site.editcapability. - Rate limit: 60 requests per minute per key. See Rate limiting.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | site_scan_not_verified | No verified Google Search Console or Bing Webmaster Tools property is attached to the website. |
| 400 | site_scan_invalid_host | The website's host cannot be scanned. |
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 403 | capability_missing | Your workspace role cannot edit websites. |
| 403 | site_scan_plan_required | The workspace is on the Free plan. |
| 404 | site_scan_site_not_found | site_id is missing or not a website in your workspace. |
| 429 | rate_limited | More than 60 requests in a minute. |
See Errors for the error body format.
Related
MCP tool: recheck_ai_visibility (accepts site_id).