The Rank Prompt Developer API gives you programmatic access to the same data and actions you use in the app: run reports, read visibility scores, fetch citations, manage shares, and more. Build custom dashboards, automate workflows, or connect Rank Prompt to your existing tools.
API access is available as an add-on subscription on top of any paid plan.
Go to Settings → Developers → Plans tab and choose an API tier.
Each tier is an add-on billed on top of your existing plan.
Once your API plan is active:
Go to Settings → Developers → API Keys tab
Click Create API Key
Give the key a name (e.g., "Production")
Copy the key — it is shown only once
curl https://api.rankprompt.com/v1/brands \
-H "Authorization: Bearer rp_live_xxx"See the full API reference at rankprompt.com/docs/v1/.
All API requests use Bearer token authentication. Pass your API key in the Authorization header:
Authorization: Bearer rp_live_xxxThere are no cookies or session tokens — every request must include the key.
Store your key in an environment variable, never in source code
Each key can be rotated or revoked from Settings → Developers → API Keys
Create separate keys for different environments (development, staging, production)
All tiers share a rate limit of 120 requests per minute. Choose based on your monthly request volume.
Plan | Price | Monthly Requests | Bonus Credits |
|---|---|---|---|
API Basic | $29/month | 10,000 | 0 |
API Starter | $99/month | 50,000 | 500 |
API Pro | $299/month | 200,000 | 2,000 |
API Starter and API Pro include bonus credits added to your account each billing period. These work the same as regular Rank Prompt credits and can be used for reports, article generation, SEO audits, and other features.
Go to Settings → Developers → Plans to upgrade, downgrade, or cancel your API plan at any time. Changes take effect at the next billing cycle.
All plans enforce a rate limit of 120 requests per minute. If you exceed this limit, the API returns a 429 Too Many Requests response. Wait for the reset window and retry.
The public API covers:
Resource | Description |
|---|---|
Brands | List and read your brands |
Reports | Run reports and read results |
Citations | Fetch citation data for your brands |
Shares | Create and manage share links |
Jobs | Check the status of async jobs |
Scheduled Reports | List and manage scheduled reports |
For the full endpoint reference, request/response schemas, and code examples, visit rankprompt.com/docs/v1/.
From Settings → Developers → API Keys you can:
Action | Description |
|---|---|
Create key | Generate a new key (name it for easy identification) |
View usage | See request count and last used timestamp |
Revoke key | Delete a key permanently — cannot be undone |
Keys are account-scoped: they have access to all brands in your account.
The Overview tab in Settings → Developers shows:
Requests used this billing period
Requests remaining
Rate limit status
Recent request history
API access requires a paid Rank Prompt plan plus an active API add-on subscription.
API Plan | Requests/month | Rate Limit | Bonus Credits |
|---|---|---|---|
API Basic | 10,000 | 120/min | 0 |
API Starter | 50,000 | 120/min | 500 |
API Pro | 200,000 | 120/min | 2,000 |
Yes. The API add-on sits on top of your existing Starter, Pro, Agency, or Agency Plus subscription.
Yes. The Claude Code integration is built on the public API. Install the Rank Prompt skill and point it at your API key to let Claude Code read your visibility data and act on findings directly in your repo.
Requests over your monthly quota return 429 errors until the billing period resets. You can upgrade your API plan mid-cycle if you need more capacity.
No. A key has access to all brands in your account. Use separate keys per environment or integration rather than per brand.
Contact [email protected] for refund requests within 7 days of payment.
API Reference - Full endpoint documentation
Connect Claude Code - Use the API from Claude Code
Credit Usage - Understand how bonus credits work
Contact us at [email protected]