RankSharkDocs
Scans

A scan as CSV

RankShark TrackScopetrack:read

GET
/v1/track/scans/{id}/csv

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.

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

CSV (UTF-8 with BOM), as a download (Content-Disposition: attachment)

response?stringtext/csv
Example Request
curl -X GET 'https://panel.rankshark.io/v1/track/scans/gs_3Hq7Vt2NwR8cYp/csv'
Example Response
"point,row,column,latitude,longitude,status,rank,top_1,top_2,top_3,error\r\n0,1,1,30.2943,-97.7995,ok,3,Bluebonnet Family Dentistry,Lakeline Smiles,Harbor Dental,\r\n24,4,4,30.2509,-97.7493,ok,1,Harbor Dental,Bluebonnet Family Dentistry,Lakeline Smiles,\r\n"

Whether PDF export is available GET

Scope: `track:read`.

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`.