Read the stored AI visibility and site health checks for one website, with a score per area.

GEThttps://api.rankparse.com/v1/site-scanFreeAPI key

Returns the latest stored AI visibility scan of one website: every check with its status, severity and evidence, and a score per area. It reads stored results only and never fetches the website. To scan again after a fix, use Re-check AI visibility.

Query parameters

site_idstringrequired

A website id from Websites. A missing, unknown, archived or other workspace's id returns 404 site_scan_site_not_found.

Response

site_idstring

The website asked for.

hoststring

The website's canonical host.

eligibleboolean

false when the website is not scanned. scanned_at, error_code and score are then null and checks is empty.

reasonstring | null

null when eligible. not_verified when no verified Google or Bing property is attached, plan_required when the workspace is on the Free plan. See Eligibility.

scanned_atinteger | null

When the last scan finished, in Unix milliseconds. null before the first scan.

error_codestring | null

Set when the last scan could not reach the home page (for example home_http_503, home_timeout). The checks then still show the previous results.

scoreobject | null

Scores (see Scoring). Each score object is { passing, failing, score }, where score is 0 to 100 or null when no check counted.

Show properties

overallobject

The AI visibility score. Site health checks are not included.

areasobject

One score object per area: discoverability, content, bot_access, capabilities, site_health.

checksarray

Stored checks in a fixed order. A check that has never run is absent. See Checks for every id.

Show properties

check_idstring

For example ai_answer_bots_blocked.

areastring

discoverability, content, bot_access, capabilities or site_health.

categorystring

site_health for the site_health area, else ai_visibility.

titlestring

What a passing check means, for example llms.txt is published.

statusstring

pass, fail or unknown (could not tell: timeout, server error). unknown is not a failure.

severitystring

bad, warn or info: how much a failure matters.

optionalboolean

true for info checks: optional features or choices, left out of the score and never an issue on their own.

evidenceobject | null

Small details behind the result, varying by check: for example url and http_status, reason (html_instead_of_file, not_text, not_json, missing_fields, empty, page_truncated), blocked (a list of { agent, via } where via is agent or wildcard), final_url, noindex_by (meta or header), canonical, block_count, valid_block_count and types. Evidence over 2 KB is replaced by { "truncated": true }.

checked_atinteger

When this result was recorded, in Unix milliseconds. An unknown result keeps the previous conclusion and its time.

first_failed_atinteger | null

When the check started failing (Unix milliseconds). Cleared when it passes.

last_passed_atinteger | null

When the check last passed (Unix milliseconds).

Behavior and limits

Cost: 0 credits.
Stored data: websites are scanned about once a day. The response never triggers a fetch.
Not eligible is not an error: an unverified website or a Free workspace gets 200 with eligible: false.
Permissions: needs the site.read capability.
Rate limit: 60 requests per minute per key. See Rate limiting.

Errors

HTTP	Code	When
401	`invalid_api_key`	Missing, invalid or revoked API key.
403	`capability_missing`	Your workspace role cannot read websites.
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.

MCP tool: get_ai_visibility (accepts site_id).

curl "https://api.rankparse.com/v1/site-scan?site_id=site_abc123" \
  -H "X-API-Key: rp_your_key"

Response

{
  "site_id": "site_abc123",
  "host": "example.com",
  "eligible": true,
  "reason": null,
  "scanned_at": 1761548400000,
  "error_code": null,
  "score": {
    "overall": { "passing": 4, "failing": 2, "score": 67 },
    "areas": {
      "discoverability": { "passing": 2, "failing": 0, "score": 100 },
      "content": { "passing": 1, "failing": 2, "score": 33 },
      "bot_access": { "passing": 1, "failing": 0, "score": 100 },
      "capabilities": { "passing": 0, "failing": 0, "score": null },
      "site_health": { "passing": 5, "failing": 0, "score": 100 }
    }
  },
  "checks": [
    {
      "check_id": "ai_answer_bots_blocked",
      "area": "bot_access",
      "category": "ai_visibility",
      "title": "AI search and answer agents may crawl the site",
      "status": "pass",
      "severity": "bad",
      "optional": false,
      "evidence": null,
      "checked_at": 1761548400000,
      "first_failed_at": null,
      "last_passed_at": 1761548400000
    },
    {
      "check_id": "llms_txt",
      "area": "content",
      "category": "ai_visibility",
      "title": "llms.txt is published",
      "status": "fail",
      "severity": "warn",
      "optional": false,
      "evidence": { "url": "https://example.com/llms.txt", "http_status": 404 },
      "checked_at": 1761548400000,
      "first_failed_at": 1761203000000,
      "last_passed_at": null
    }
  ]
}

200 not eligible

{
  "site_id": "site_abc123",
  "host": "example.com",
  "eligible": false,
  "reason": "not_verified",
  "scanned_at": null,
  "error_code": null,
  "score": null,
  "checks": []
}

Get AI visibility

Query parameters

Response

Behavior and limits

Errors

AI visibility

Re-check AI visibility

Issues

Get AI visibility

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

Behavior and limitsCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

AI visibility

Re-check AI visibility

Issues

Query parameters

Response

Behavior and limits

Errors

Related