Three ways to build on your AI visibility data
Pull it into your backend with the REST API, hand it to your AI agent over the MCP server, or have us push events to you with webhooks. Track how ChatGPT, Perplexity, Google AI Mode, Claude, Gemini, and Grok recommend your brand, all from one contract.
# 1 · REST API · your backend pulls
curl https://api.rankprompt.com/v1/reports \
-H "Authorization: Bearer $RANKPROMPT_API_KEY"
# 2 · MCP server · your AI agent acts
claude mcp add --transport http --scope user rankprompt \
https://mcp.rankprompt.com/mcp
# 3 · Webhooks · we push to you
curl https://api.rankprompt.com/v1/brands/$BRAND/webhooks \
-H "Authorization: Bearer $RANKPROMPT_API_KEY" \
-d '{"url":"https://you.app/hooks","events":["report.completed"]}' One platform, three ways to wire it in
The API, the MCP server, and webhooks all read from the same data layer: six AI engines normalized into one schema. Pick the surface that matches how you work, or use all three.
your backend pulls
Call /v1 from your code
Six AI engines normalized into one schema. Manage brands, run reports, and read citations from your backend, warehouse, or product.
- OpenAPI 3.1 spec
- Scoped, brand-restricted keys
- Idempotent writes + quota headers
your AI agent acts
Connect your AI agent
Plug your AI visibility data into Claude Code, Cursor, or any MCP client over OAuth. Your agent reads reports and citations, then runs reports and ships fixes.
- OAuth in the browser, no key paste
- Claude Code, Cursor, Claude Desktop
- 20 read and write tools
we push to you
Get events as they happen
Subscribe a per-brand endpoint and we POST signed events the moment a report or a scheduled run finishes. No polling loop to babysit.
- report.completed, report.failed
- schedule.run.completed, schedule.run.failed
- HMAC signing, secret rotation, auto-disable
Every feature in the platform, available as an API
The same building blocks that power the Rank Prompt dashboard. Brand management ships today; the rest is rolling out under /v1 over the coming months. Every endpoint follows the same auth, error, and idempotency contract from day one.
Brand management
Programmatically onboard brands, update categories, languages, aliases, and competitors. Perfect for agencies provisioning new clients without touching the dashboard.
AI visibility reports
Run prompts across ChatGPT, Perplexity, Google AI Mode, Claude, Gemini, and Grok. Pull mentions, ranking position, and visibility score into your stack.
Citation & source tracking
Discover the sources AI assistants cite when recommending brands in your space, with the Rank Prompt Score so you only outreach to reachable targets.
Scheduled reports
Cron-style report definitions: weekly competitor snapshots, monthly visibility deltas, anomaly alerts. Delivered as JSON or shareable PDFs.
Brand audit & perception
Automated snapshots of how AI describes your brand: positioning, claims, comparisons against competitors, and the weak spots to fix first.
AI-optimized content
Generate 8 content types built to be cited by AI: comparison, ranked list, location, case study, product deep-dive, FAQ, Statistics Roundup, and Glossary. Trigger and ship the full content lifecycle from your stack.
Technical SEO audits
Trigger Lighthouse-grade crawls, Core Web Vitals checks, and AI-readability scans. Stream issues into your existing engineering ticket queue.
Outreach & backlinks
Surface high-value outreach targets, push prospects into your CRM, and trigger AI-personalized email campaigns with verified contact data.
Webhooks & events
Subscribe a per-brand endpoint to report.completed, report.failed, schedule.run.completed, and schedule.run.failed. HMAC-signed payloads, secret rotation, and auto-disable after repeated failures.
Track release dates in the changelog or browse the live surface in the API reference.
From signup to first call in under 10 minutes
No oddly-named handshakes, no SDK install dance. A bearer token, a curl command, and you're moving data.
Mint a scoped API key
API access is included on any Starter and up plan (or pick a standalone API plan). Open the Developers page in your workspace, choose the scopes you need, and (optionally) pin the key to a single brand for white-label work.
Call /v1 from your backend
Send a bearer token, follow the OpenAPI spec. Every metered response carries quota headers so you can pace work; idempotency keys make every POST safe to retry.
Stream insights into your stack
Pipe results into your dashboard, warehouse, CRM, or Slack. Register a webhook so we push report.completed and schedule.run.completed events the moment they happen, no polling loop required.
A contract you can depend on
Every primitive you'd expect from a serious payments or analytics API. Boring, predictable, and well-documented; not flashy and brittle.
OpenAPI 3.1 spec
Spec-first design. Generate an idiomatic client in any language with openapi-generator, Stainless, Fern, or Speakeasy. The whole surface is browseable in the hosted reference.
Scoped & brand-restricted keys
Mint keys with the minimum surface area required: read-only, write-only, per-resource, or pinned to a single brand for white-label work. Keys are shown once, stored hashed.
Idempotent writes
Every POST accepts an `Idempotency-Key`. Network retries, queue redelivery, and worker restarts are safe by default.
Predictable rate limits
120 requests per minute per key plus a monthly quota. Every metered response carries `X-RP-Quota-*` headers; throttled calls return `Retry-After`. No surprise back-pressure.
Structured errors
Stable `error.code` values from a published catalog, machine-readable details, and a `request_id` echoed in every response for end-to-end tracing in support tickets.
Versioned forever
The /v1 contract is additive: new fields and endpoints only. When a breaking change is needed we ship /v2 alongside, with long deprecation windows announced via `Sunset` headers.
Ship in days, not quarters
The four shapes most teams take when they integrate. Pick the one closest to yours; mix and match the rest.
White-label AI visibility dashboards
Spin up a per-client dashboard in your own product. One brand-pinned API key per client, your branding, your billing, our data layer.
Pipe AI metrics into your warehouse
Schedule nightly pulls of ranking, citation, and visibility data into Snowflake, BigQuery, or Looker. Track AI presence right next to organic traffic.
Trigger Slack and PagerDuty when reports land
Subscribe a webhook to schedule.run.completed, diff the new visibility score against last week, and page the team only when it actually moves.
Catch SEO/AEO regressions on every push
Add a GitHub Action that calls /v1/page-audit (a URL, a list, or a whole sitemap) on each pull request, comments the score and concrete fixes, and fails the build below your threshold.
Pricing built for developers
The API, the MCP server, and webhooks are included free on every Starter plan and up. Want the API on its own? Two standalone subscriptions cover that, with no surprise overages.
Included with your plan
API, MCP server, and webhooks
on any Starter plan and up, from $49/mo
Monthly request cap by plan
- Starter · $49/mo 10,000
- Pro · $89/mo 25,000
- Agency · $149/mo 50,000
- Agency Plus · $299/mo 100,000
- Public REST API, MCP server, and webhooks
- Credit-consuming calls draw from your plan credits
- All scopes + brand-pinned keys for white-label
- MCP for Claude Code, Cursor, and Claude Desktop
- OpenAPI 3.1 spec + hosted reference
7-day free trial · 50 free prompts
API Starter
Standalone API plan for customers without a dashboard plan
- 50,000 monthly request units
- 500 API credits / month included
- Standalone subscription. No dashboard plan required.
- 120 requests / minute burst limit per key
- All scopes: read + write across every resource
- Brand-pinned keys for white-label work
- Idempotent writes + structured error catalog
- OpenAPI 3.1 spec + hosted reference
- Email support during business hours
7-day free trial. Cancel anytime.
API Pro
Standalone API plan for embedded SaaS and high-volume workloads
- 200,000 monthly request units
- 2,000 API credits / month included
- Priority quota raises on request
- Everything in Starter, plus:
- Dedicated support channel
- Early access to roadmap endpoints
7-day free trial. Cancel anytime.
How requests are metered
Two meters. Request units cap raw API throughput; credits cap LLM and search work. You never pay twice for the same operation, whether you trigger it from the dashboard or from /v1.
/v1/me and
/v1/me/quota: free to poll, anytime.
Typical CRUD call (list brands, fetch a brand, mint a key).
Per-key burst limit. Quota and Retry-After exposed on every response.
Developer questions
Everything teams ask before they integrate. Email us if your question isn't covered.
What can I build with the Rank Prompt API today?
How is the API priced?
What are the rate limits?
Is there a sandbox or test environment?
Can I issue per-brand keys for my clients?
Can my AI agent (Claude Code or Cursor) use Rank Prompt?
How do I get an API key?
I'm already on a Starter / Pro / Agency plan. Do I need an API plan?
Are there official client libraries?
How do you handle versioning and breaking changes?
Do you support webhooks?
How is the API secured?
Still have questions? Contact our team
Start building today
Read the quickstart, mint your first API key, and ship a working integration before lunch.