RankSharkDocs
Workspace

Points used this month and the plan limits

RankShark TrackScopetrack:read

GET
/v1/track/usage

A scan costs one point per grid point at its engine's cost (a website campaign: one point per keyword; an AI answer limits.aiPointCost). Months are UTC calendar months; bought points (topup) are spent after the month's.

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

Response Body

OK

application/json
  1. response
month*string

YYYY-MM (UTC)

used*integer
limit*integer

The month's points

monthLeft?integer
topup?
left*integer

What can still be scanned: the month's rest plus bought points

limits?|null
Example Request
curl -X GET 'https://panel.rankshark.io/v1/track/usage'
Example Response
{  "month": "2026-11",  "used": 3528,  "limit": 50000,  "monthLeft": 46472,  "topup": {    "balance": 2000,    "nextExpiresAt": "2027-05-01T00:00:00.000Z",    "nextExpiringPoints": 2000  },  "left": 48472,  "limits": {    "maxPoints": 225,    "maxTrackers": 60,    "keywordsPerTracker": 10,    "monthlyPoints": 50000,    "browsersPerScan": 12,    "search": true,    "ai": true,    "aiMaxPoints": 49,    "aiPointCost": 5,    "daily": true,    "schedules": true,    "historyDays": null,    "engines": null,    "aiEngines": null,    "allAiEngines": [      "ai_mode",      "ai_overview",      "gemini",      "chatgpt",      "perplexity"    ],    "pointCost": null  }}

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

The dashboard GET

Daily points, scans, SoLV, ARP and AI mention rate for the period and the period before it, running and recent scans, upcoming runs and usage. Days are UTC calendar days. Scope: `track:read`.