RankSharkDocs
Scans

The competitors of a scan

RankShark TrackScopetrack:read

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

The businesses seen across the grid, best (lowest ATRP) first; the tracked business is marked isTarget. AI scans also list the brands the answers named.

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}$

Query Parameters

limit?integer

1-100, default 20

Range1 <= value <= 100

Response Body

OK

application/json
  1. response
scanId*string
keyword?string
engine?string
status?string
Value in"queued""waiting""running""done""failed""cancelled"
competitors*array<>
brands?array<>

AI scans

Example Request
curl -X GET 'https://panel.rankshark.io/v1/track/scans/gs_3Hq7Vt2NwR8cYp/competitors'
Example Response
{  "scanId": "gs_3Hq7Vt2NwR8cYp",  "keyword": "dentist near me",  "engine": "maps",  "status": "done",  "competitors": [    {      "key": "0x6a8d1e2f3c4b5a69",      "name": "Harbor Dental",      "category": "Dentist",      "rating": 4.8,      "reviews": 312,      "address": "1200 S Congress Ave, Austin, TX 78704",      "lat": 30.2509,      "lng": -97.7493,      "fid": "0x8644b50a3e3c0b1d:0x6a8d1e2f3c4b5a69",      "pid": "ChIJd8BlQ2BZwokRAFUEcm_qrcA",      "appearances": 44,      "arp": 4.18,      "atrp": 5.9,      "solv": 55.1,      "top3": 27,      "best": 1,      "isTarget": true    },    {      "key": "0x3b8a1f0c2d9e4a17",      "name": "Bluebonnet Family Dentistry",      "category": "Dentist",      "rating": 4.6,      "reviews": 198,      "address": "815 W 6th St, Austin, TX 78703",      "lat": 30.2716,      "lng": -97.7529,      "fid": "0x8644b5a1c2d3e4f5:0x3b8a1f0c2d9e4a17",      "pid": null,      "appearances": 46,      "arp": 3.61,      "atrp": 4.67,      "solv": 61.22,      "top3": 30,      "best": 1,      "isTarget": false    },    {      "key": "0x1c2d3e4f5a6b7c8d",      "name": "Lakeline Smiles",      "category": "Cosmetic dentist",      "rating": 4.9,      "reviews": 87,      "address": "2300 S Lamar Blvd, Austin, TX 78704",      "lat": 30.2468,      "lng": -97.7801,      "fid": "0x8644b4c3d2e1f0a9:0x1c2d3e4f5a6b7c8d",      "pid": null,      "appearances": 31,      "arp": 6.4,      "atrp": 11.78,      "solv": 18.37,      "top3": 9,      "best": 2,      "isTarget": false    }  ]}

List a campaign's scans GET

Newest first, summaries only (no points). Scope: `track:read`.

Cross-campaign insights GET

Each keyword's latest scan of the period against its latest scan before it: the biggest movers both ways, competitors gaining share of voice, keywords not scanned in the period, and AI prompts. Scope: `track:read`.