Rate limits and usage
How many requests a minute the RankShark APIs and MCP servers allow per plan, what happens over the limit, and what scans and campaigns cost.
Requests per minute
Limits count per workspace and per product: Track calls never use up Enhance's budget, and the other way round. REST and MCP calls count together.
| Plan | Requests a minute |
|---|---|
| Most plans | 600 |
| Track Growth | 1,200 |
| Track Enterprise | 2,400 |
An Enhance plan that includes Track gets at least that Track plan's limit on its Track calls. Need more? Contact us about a custom limit.
On Enhance, calls that start, stop, restart or delete campaigns are also limited to 10 a minute per key.
Lookup limits (Track)
Some Track calls do more work, so they also have hourly limits per workspace:
| Call | Limit |
|---|---|
Find a business (POST /v1/track/find) | 60 an hour, one at a time |
Read a website, search places (POST /v1/track/site, /places) and other place lookups | 120 an hour together |
Email a saved report now (POST /v1/track/reports/{id}/send) | 30 an hour |
Over the limit
You get 429 and a Retry-After header with the seconds to wait (60 for the per-minute limits):
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json
{"error":"rate_limited"}The lookup limits answer 409 with {"code": "rate_limited"}. There are no other rate-limit headers: keep your own count, or simply wait when you see 429.
Good habits:
- Poll scans every 15 to 30 seconds, not in a tight loop.
- Read one campaign's scans (
GET /v1/track/campaigns/{id}/scans) instead of every campaign each time. - Back off when you see
429, and retry afterRetry-After.
What calls cost
API and MCP calls themselves are not charged. What they do is:
- Track scans spend points. One point per grid point, or one per keyword on a website campaign. Some engines and every AI answer cost more.
GET /v1/track/usageshows points used this month, bought points left andleft, everything you can still scan.GET /v1/track/enginesshows the cost of each engine on your plan. - Enhance campaigns use your plan while they send visits, the same as when you start them in the panel.
Monthly points renew on the first day of each month (UTC). When the month's points run out, bought points are used. A run that needs more than you have left is refused with 409 quota before it starts.
Errors
Error bodies, codes and HTTP statuses of the RankShark Track and Enhance APIs and MCP servers, what each one means and when to retry.
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.