Rank Tracker API
Track a domain's organic rankings and AI visibility in one async job — submit a domain, get the full report pushed to your webhook when it's ready.
rank:readOne request, structured JSON back
curl -X POST https://instarankseo.com/api/v1/rank-tracker \
-H "X-API-Key: isk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com", "callbackUrl": "https://you.com/hook"}'// 202 Accepted — returns immediately
{
"success": true,
"status": "queued",
"job_id": "job_3f2a...",
"domain": "example.com",
"status_url": "/api/v1/rank-tracker/jobs/job_3f2a...",
"meta": { "creditsUsed": 300, "apiVersion": "1.0" }
}
// Then poll the status_url, or receive the signed webhook when done.Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| domain | string | required | Target domain (hostname or URL). |
| callbackUrl | string | optional | HTTPS webhook to POST the finished report to (HMAC-signed, SSRF-guarded). |
Built for builders
Organic + AI in one job
Discovers the domain's top keywords and AI queries, looks up organic rankings for each, and measures AI visibility across four engines — one report, two channels.
Async with webhooks
The call returns a job id instantly. When the work finishes, the signed report is pushed to your callbackUrl — or poll the status URL on your own schedule.
Pay only for results
The job credit is automatically refunded if every upstream lookup fails, so a total outage never costs you.
Pricing & limits
Price
$0.30 per job
300 credits per job
Billed from one credit wallet. Failed upstream calls are refunded automatically.
Rate limits
- Free10 / min
- SEO+60 / min
- Agency120 / min
Surfaced as X-RateLimit-* headers on every response.
Errors
Every non-2xx shares one envelope with a machine-readable code, a retryable flag, and a requestId for tracing.
A complete organic-plus-AI rank report in a single async job, delivered to your webhook — no polling loops to build, no separate tools to stitch together.
Last updated:
Rank Tracker API FAQ
Common questions about the Rank Tracker API — pricing, auth, and what it returns.
Why is the Rank Tracker API asynchronous?
A full rank report involves several SERP lookups and four AI-engine queries, which takes a couple of minutes — longer than a synchronous HTTP request should stay open. So the API accepts the job, returns a job id immediately with a 202 response, and delivers the result via webhook or polling when it is ready.
How do I get the results?
Two ways. Supply a callbackUrl and the finished, HMAC-signed report is POSTed to it. Or poll GET /api/v1/rank-tracker/jobs/{job_id} until the status is "done", which returns a short-lived signed URL to the full result.
What does the report contain?
The domain's discovered keywords and AI queries, the organic ranking position (and ranking URL) for each term, and the per-engine AI visibility across ChatGPT, Claude, Gemini, and Perplexity.
How much does it cost?
Three hundred credits per job, which is $0.30 at the standard rate. The credit is fully refunded if the job produces no results because every upstream lookup failed.
Is the webhook secure?
Yes. Webhook payloads are HMAC-signed so you can verify they came from InstaRank, the callback URL is validated against SSRF before any delivery, and each job is delivered at most once.