RankSharkDocs
Scans

AI visibility of an AI scan

RankShark TrackScopetrack:read

GET
/v1/track/scans/{id}/ai-visibility

Mention, citation and first-mention rates, share of voice, sources, the brands named and each answer in short. 404 not_ai for a rank scan.

Scope: track:read.

Authorization

headerAuthorizationBearer <rstk_… API key or OAuth access token>

A Track API key (rstk_…, Settings → API & MCP) or an OAuth access token issued for this API

Path Parameters

id*string

Scan id (gs_…). A malformed id is 404 not_found.

Match^gs_[A-Za-z0-9]{10,40}$

Response Body

OK

application/json
  1. response
scanId*string
keyword?string

The prompt

engine?string
Value in"ai_mode""ai_overview""gemini""chatgpt""perplexity"
status?string
Value in"queued""waiting""running""done""failed""cancelled"
finishedAt?|
Formatdate-time
suspect?boolean
warning?string
aiMetrics*|null
brands*array<>
answers?array<>

Each answer in short (third-party text)

Example Request
curl -X GET 'https://panel.rankshark.io/v1/track/scans/gs_3Hq7Vt2NwR8cYp/ai-visibility'
Example Response
{  "scanId": "gs_6Cv1Bn8Mz5JkRt",  "keyword": "Who is the best dentist in Austin for a nervous patient?",  "engine": "chatgpt",  "status": "done",  "finishedAt": "2026-11-02T15:21:40.000Z",  "suspect": false,  "aiMetrics": {    "answers": 9,    "shown": 9,    "shownPct": 100,    "mentioned": 4,    "mentionPct": 44.44,    "cited": 2,    "citedPct": 22.22,    "page": null,    "pageRead": 9,    "pageCited": 0,    "pageCitedPct": null,    "avgOrder": 2.25,    "firstPct": 11.11,    "sov": 21.05,    "brandsPerAnswer": 2.11,    "sources": [      {        "domain": "yelp.com",        "title": "Best Dentists in Austin",        "answers": 6,        "pct": 66.67,        "own": false      },      {        "domain": "harbordental.example",        "title": "Harbor Dental | Austin dentist",        "answers": 2,        "pct": 22.22,        "own": true      }    ]  },  "brands": [    {      "key": "0x3b8a1f0c2d9e4a17",      "name": "Bluebonnet Family Dentistry",      "isTarget": false,      "answers": 7,      "mentionPct": 77.78,      "avgOrder": 1.29    },    {      "key": "0x6a8d1e2f3c4b5a69",      "name": "Harbor Dental",      "isTarget": true,      "answers": 4,      "mentionPct": 44.44,      "avgOrder": 2.25    }  ],  "answers": [    {      "i": 4,      "row": 1,      "col": 1,      "shown": true,      "mentioned": true,      "cited": true,      "order": 2,      "brands": [        "Bluebonnet Family Dentistry",        "Harbor Dental"      ],      "excerpt": "Harbor Dental is known for sedation options and a calm office.",      "sources": [        "yelp.com",        "harbordental.example"      ]    }  ]}

A scan as CSV GET

One row per point (an AI scan: per answer; a website campaign's search scan: the organic top 10). UTF-8 with a BOM; a text cell that a spreadsheet would read as a formula starts with an apostrophe. Scope: `track:read`.

Cancel a running scan POST

Cancelled before any point, the scan costs nothing: its points come back. A finished scan answers its status. Scope: `track:run`.