company logo

Help center

Go to Rank Prompt
Powered by
All collectionsIntegrationsDeveloper API

Developer API

Use the Rank Prompt public API to access your brands, reports, citations, and shares programmatically.

Developer API

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.

Developer API access is included with every paid dashboard plan (Starter and up), each with a monthly request cap. If you only want the API without a dashboard plan, standalone API plans are also available.

Getting Started

Step 1: Confirm Your API Access

If you are on a paid dashboard plan (Starter, Pro, Agency, or Agency Plus), Developer API access is already included, with a monthly request cap based on your tier, so you can go straight to creating a key.

If you do not have a dashboard plan and only want the API, go to Settings → Developers → Plans tab and choose a standalone API plan (API Starter or API Pro).

Step 2: Create an API Key

Once your API plan is active:

  1. Go to Settings → Developers → API Keys tab

  2. Click Create API Key

  3. Give the key a name (e.g., "Production")

  4. Copy the key — it is shown only once

Step 3: Make Your First Request

curl https://api.rankprompt.com/v1/brands \
  -H "Authorization: Bearer rp_live_xxx"

See the full API reference at rankprompt.com/docs/v1/.

Authentication

All API requests use Bearer token authentication. Pass your API key in the Authorization header:

Authorization: Bearer rp_live_xxx

There are no cookies or session tokens — every request must include the key.

Key Security

  • 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)

API Plan Tiers

All API access shares a per-key burst limit of 120 requests per minute. Your monthly request cap depends on how you access the API.

Included With Your Dashboard Plan

Every paid dashboard plan includes Developer API access with a monthly request cap:

Dashboard Plan

Monthly API Requests

Starter

10,000

Pro

25,000

Agency

50,000

Agency Plus

100,000

Credit-consuming endpoints (for example, running a report) draw from your plan's monthly credits, the same as in the app.

Standalone API Plans

If you only want the API and do not have a dashboard plan, choose a standalone API plan:

Plan

Price

Monthly Requests

Included Credits

API Starter

$99/month

50,000

500

API Pro

$299/month

200,000

2,000

Notes on Bonus Credits

Standalone API Starter and API Pro include 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.

Changing Your Plan

If you are on a standalone API plan, go to Settings → Developers → Plans to upgrade, downgrade, or cancel at any time. If your API access comes with a dashboard plan, your request cap changes when you change that plan. Changes take effect at the next billing cycle.

Rate Limits

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.

Available Endpoints

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

Managing Keys

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.

Quota & Usage

The Overview tab in Settings → Developers shows:

  • Requests used this billing period

  • Requests remaining

  • Rate limit status

  • Recent request history

Plan Requirements

The API is available either through a paid dashboard plan (access included) or through a standalone API plan if you do not have a dashboard plan.

Access

Requests/month

Rate Limit

Credits

Starter (dashboard)

10,000

120/min

Uses plan credits

Pro (dashboard)

25,000

120/min

Uses plan credits

Agency (dashboard)

50,000

120/min

Uses plan credits

Agency Plus (dashboard)

100,000

120/min

Uses plan credits

API Starter (standalone)

50,000

120/min

500

API Pro (standalone)

200,000

120/min

2,000

Frequently Asked Questions

Do I need a paid base plan to use the API?

Not necessarily. Developer API access is included with every paid dashboard plan (Starter, Pro, Agency, Agency Plus). If you do not have a dashboard plan and only want the API, you can subscribe to a standalone API plan (API Starter or API Pro).

Can I use the API with Claude Code?

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.

What happens if I exceed my monthly request limit?

Requests over your monthly quota return 429 errors until the billing period resets. You can move to a higher plan mid-cycle if you need more capacity.

Are API keys scoped to a single brand?

No. A key has access to all brands in your account. Use separate keys per environment or integration rather than per brand.

Do I get a refund if I cancel the API plan?

Contact [email protected] for refund requests within 24 hours of a charge.

Next Steps

  • API Reference - Full endpoint documentation

  • Connect Claude Code - Use the API from Claude Code

  • Credit Usage - Understand how bonus credits work

Need Help?

Contact us at [email protected]

Did this answer your question?
😞
😐
😁