9Rank Developer Hub

Get API Key →

API Reference

Transform your applications with the 9Rank Data Engine. We expose our entire data processing pipeline via a unified interface, supporting both traditional backend software and next-generation autonomous AI agents.

Authentication

All API requests must be authenticated with a live API Key.

For REST API requests, pass the key in the headers:

Authorization: Bearer 9r_live_xxxxxxxxxxxxxxxxxxxxx

For MCP connections, pass it as a query parameter:

?apiKey=9r_live_xxxxxxxxxxxxxxxxxxxxx

Credits & Pricing

The Developer API deducts credits natively from your overall account balance exactly as if you used the web interface. If you run out of credits, API requests will immediately return a 402 Payment Required error.

AI Agents (Model Context Protocol)

Connect 9Rank directly to Cursor, Claude Desktop, VS Code, Windsurf, or your custom agent pipeline. Our server streams native JSON-RPC tool calls via Server-Sent Events (SSE).

Settings → Features → MCP → Add SSE Server
// Cursor: Settings → Features → MCP → Add new global MCP server
// Type: SSE
// URL (paste this):

https://mcp.9rank.ai/api/mcp?apiKey=YOUR_API_KEY
Open Cursor → Settings → Features → MCP → add new server, choose type: SSE. Replace YOUR_API_KEY with your key from Developer Dashboard.
Gateway URL
https://mcp.9rank.ai/api/mcp
Auth method
?apiKey=YOUR_KEY

Standard REST API

For traditional software development inside Python, PHP, or Java. Just fire a stateless POST request.

Endpoint Configuration

POST /api/v1/tools
curl -X POST https://app.9rank.ai/api/v1/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "get_keyword_suggestions",
    "arguments": { "keyword": "iphone 16" }
  }'

Tool Catalog

get_amazon_best_sellers

1 Credit / Req

Fetches current live Amazon Best Sellers tracking array for an exact category slug.

Arguments:
  • categorySlug (string, required): Example kitchen
  • countryCode (string, optional): Example US

get_keyword_suggestions

1 Credit / Req

Pulls raw prediction semantic mapping from search autocomplete via the 9Rank Data Engine.

Arguments:
  • keyword (string, required): Seed search term. Example iphone 16

copy_checker

Dynamic (1-20 CR)

Scans textual content for plagiarism against billions of web pages and returns similarity details.

Arguments:
  • text (string, required): The text content to check for plagiarism.

brand_voice_checker

2 Credits / Req

Analyzes content against a predefined brand voice profile across 9 semantic dimensions using AI.

Arguments:
  • contentToCheck (string, required): The text content to evaluate.
  • brandVoiceDefinition (string, required): The brand voice profile or rules to evaluate against.
  • language (string, optional): Language of the content (default: 'en').

keyword_intent_classifier

Hot Seller
1 Credit / Req

Classifies keyword search intent (Informational, Commercial, Transactional, Navigational, Brand-defense, Comparison, AI-answer). Perfect for automating bulk PPC or SEO keyword organization and cutting wasted ad spend in a tough economy.

Arguments:
  • keyword (string, required): The keyword to classify.

run_full_audit

Enterprise
20 Credits / Req

Performs a complete SEO audit for a given URL and region, returning scores, competitive signals, and AI recommendations. A powerful backend flow now available as a single API call.

Arguments:
  • url (string, required): The URL to audit. Example https://example.com
  • region (string, optional): The 2-letter country code. Example US

authority_checker

Enterprise
15 Credits / Req

Calculates the proprietary 9R Score and domain authority metrics for a given URL.

Arguments:
  • url (string, required): The URL to evaluate.
  • region (string, optional): The 2-letter country code. Example US

detect_ai_content

2 Credits / Req

Scans text to detect the probability of it being AI-generated.

Arguments:
  • text (string, required): The text content to analyze.
HomeAudit
KeywordsProfile