Scans
Cancel a running scan
RankShark TrackScopetrack:run
POST
Cancelled before any point, the scan costs nothing: its points come back. A finished scan answers its status.
Scope: track:run.
header
AuthorizationBearer <rstk_… API key or OAuth access token>A Track API key (rstk_…, Settings → API & MCP) or an OAuth access token issued for this API
id*stringScan id (gs_…). A malformed id is 404 not_found.
Match
^gs_[A-Za-z0-9]{10,40}$OK
application/json- response
ok*booleanstatus*stringThe scan's status now
Value in
"done""failed""cancelled"curl -X POST 'https://panel.rankshark.io/v1/track/scans/gs_3Hq7Vt2NwR8cYp/cancel'Example Response
{ "ok": true, "status": "cancelled"}AI visibility of an AI scan GET
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`.
Compare a scan with an earlier one GET
Metric changes (positive = better), point movements on the same grid, competitors then and now. Suspect scans are not compared (change null). Scope: `track:read`.