Pagination and limits
How the RankShark Track and Enhance APIs page long lists, how many items each page holds, and the size limits on requests, answers and history.
Enhance: offset and limit
Enhance lists take offset and limit and answer with the page and the total:
curl "https://panel.rankshark.io/api/v1/campaigns?offset=100&limit=100" \
-H "Authorization: Bearer $RANKSHARK_ENHANCE_KEY"{ "offset": 100, "limit": 100, "total": 214, "items": [ … ] }Keep asking with offset + limit until offset reaches total.
| List | Default | Most per page |
|---|---|---|
GET /api/v1/campaigns, /campaigns/archived | 100 | 1000 |
Visit lists (/reports/statistics) are not paged: narrow them with from, to and campaignId, or download the CSV export.
Track: whole lists and limits
Track lists are small enough to come back whole: campaigns, businesses and saved reports. Where a list can grow, it takes a limit:
| List | Default | Range |
|---|---|---|
GET /v1/track/campaigns/{id}/scans | 50 | 1 to 200, newest first |
GET /v1/track/scans/{id}/competitors | 20 | 1 to 100, best first |
Narrow scan lists with keyword (and engine for AI campaigns), and campaign lists with clientId.
Sizes
- Request bodies up to 10 MB. A business logo for white-label reports is up to 300 KB.
- MCP tool results over 64 KB are cut, with a note on how to narrow the request.
- Report emails go to at most 10 recipients.
History
Track keeps every scan for 25 months. Campaigns and their scans stay until you delete them; deleting a campaign removes its scans too.