RankSharkDocs
Workspace

Cross-campaign insights

RankShark TrackScopetrack:read

GET
/v1/track/insights

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.

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

Query Parameters

days?integer

7, 30 (default) or 90

Value in73090
clientId?string

Only this business's campaigns (tc_…)

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

Response Body

OK

application/json
  1. response
days*integer
totals*
gainers?array<>

Biggest improvements (up to 8)

decliners?array<>

Biggest declines (up to 8)

competitors?array<>

Competitors by share-of-voice gain (up to 10)

stale?array<>

Keywords not scanned in the period (up to 20)

ai?array<>

AI prompts: mention rate now and before

keywords?array<>

Every keyword scanned in the period

Example Request
curl -X GET 'https://panel.rankshark.io/v1/track/insights'
Example Response
{  "days": 30,  "totals": {    "keywords": 3,    "compared": 3,    "improved": 2,    "declined": 1,    "solv": 48.3,    "solvBefore": 41.5  },  "gainers": [    {      "trackerId": "gt_8fK2mQ9xLp3s",      "campaign": "Harbor Dental · Austin",      "clientId": "tc_5Rw8Jn3Ys2QeLk",      "keyword": "dentist near me",      "engine": "maps",      "at": "2026-11-02T15:06:12.000Z",      "scanId": "gs_3Hq7Vt2NwR8cYp",      "solv": 55.1,      "arp": 4.18,      "solvBefore": 42.86,      "arpBefore": 5.02,      "dSolv": 12.24,      "dArp": -0.84    }  ],  "decliners": [],  "competitors": [    {      "key": "0x1c2d3e4f5a6b7c8d",      "name": "Lakeline Smiles",      "solv": 18.37,      "solvBefore": 10.2,      "dSolv": 8.17,      "keywords": 2    }  ],  "stale": [],  "ai": [    {      "trackerId": "gt_2Wd6Hs9Kq4Tn",      "campaign": "Harbor Dental · AI",      "clientId": "tc_5Rw8Jn3Ys2QeLk",      "prompt": "Who is the best dentist in Austin for a nervous patient?",      "engine": "chatgpt",      "engineLabel": "ChatGPT",      "at": "2026-11-02T15:21:40.000Z",      "scanId": "gs_6Cv1Bn8Mz5JkRt",      "mentionPct": 44.44,      "mentionBefore": 33.33,      "dMention": 11.11,      "citedPct": 22.22,      "topSource": "yelp.com"    }  ],  "keywords": []}

The competitors of a scan GET

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

List the engines GET

Rank engines (Google Maps, the Google local pack, Google Search, and the same on Bing) and AI engines, with what this workspace's plan allows and what one point of each costs. Scope: `track:read`.