# Ranked AI Developer Docs

> Build on Ranked AI's SEO platform: a REST API for keyword rankings, AI visibility, site audits, backlinks, content calendars and reports; a TypeScript SDK; an MCP server for ChatGPT, Claude and Cursor; and signed webhooks.

## Guides

- [Ranked AI Developer Docs](https://www.ranked.ai/developers.md): Build on top of Ranked AI with our REST API, MCP integration, and webhooks
- [Quickstart](https://www.ranked.ai/developers/quickstart.md): Make your first API call in under 2 minutes
- [Authentication](https://www.ranked.ai/developers/authentication.md): Authenticate API requests with Bearer tokens
- [MCP Overview](https://www.ranked.ai/developers/mcp/overview.md): Connect Ranked AI to ChatGPT, Claude, Cursor, and other AI tools
- [MCP Setup](https://www.ranked.ai/developers/mcp/setup.md): Connect your Ranked AI account to AI tools via MCP
- [MCP Tool Reference](https://www.ranked.ai/developers/mcp/tools.md): Detailed reference for all MCP tools
- [Webhooks Overview](https://www.ranked.ai/developers/webhooks/overview.md): Receive real-time notifications when data changes in your Ranked AI projects
- [Webhook Events](https://www.ranked.ai/developers/webhooks/events.md): All available webhook events and their payload schemas
- [Webhook Security](https://www.ranked.ai/developers/webhooks/security.md): Verify webhook signatures to ensure payloads are authentic
- [Storing Webhook Data](https://www.ranked.ai/developers/webhooks/storing-data.md): Best practices for persisting webhook events in your database
- [Building an Agency Dashboard](https://www.ranked.ai/developers/guides/agency-dashboard.md): How to use the API and webhooks to build a custom client-facing dashboard
- [Rate Limits](https://www.ranked.ai/developers/guides/rate-limits.md): API rate limits and best practices for staying within them
- [Keyword Ranking Monitor](https://www.ranked.ai/developers/recipes/ranking-monitor.md): Build a simple ranking monitor that tracks position changes over time
- [Slack Ranking Alerts](https://www.ranked.ai/developers/recipes/slack-alerts.md): Get Slack notifications when keyword positions change
- [Sync to Google Sheets](https://www.ranked.ai/developers/recipes/google-sheets.md): Automatically sync keyword rankings to a Google Sheet

## API Reference

- [API Reference](https://www.ranked.ai/developers/api-reference/introduction.md): Complete reference for the Ranked AI REST API v1
- [List Projects](https://www.ranked.ai/developers/api-reference/projects/list.md): GET /projects - List all SEO projects for the authenticated user
- [Create Project](https://www.ranked.ai/developers/api-reference/projects/create.md): POST /projects - Create a self-serve SEO Software project from a website URL
- [List Keywords](https://www.ranked.ai/developers/api-reference/keywords/list.md): GET /projects/{projectId}/rankings/keywords - Get keyword positions across Desktop, Mobile, AI Mode, and Maps
- [Keyword History](https://www.ranked.ai/developers/api-reference/keywords/history.md): GET /projects/{projectId}/rankings/keywords/{keywordId}/history - Get daily position history for a specific keyword
- [List Prompts](https://www.ranked.ai/developers/api-reference/prompts/list.md): GET /projects/{projectId}/prompts - Get AI visibility prompts with per-model visibility data
- [Prompt Detail](https://www.ranked.ai/developers/api-reference/prompts/detail.md): GET /projects/{projectId}/prompts/{promptId} - Get detailed AI visibility data for a specific prompt
- [Prompt History](https://www.ranked.ai/developers/api-reference/prompts/history.md): GET /projects/{projectId}/prompts/{promptId}/history - Get AI model response history with citations for a prompt
- [List Audits](https://www.ranked.ai/developers/api-reference/audits/list.md): GET /projects/{projectId}/audits - List site audit tasks for a project
- [Latest Audit](https://www.ranked.ai/developers/api-reference/audits/latest.md): GET /projects/{projectId}/audits/latest - Get the most recent completed audit with issue summary
- [Audit Issues](https://www.ranked.ai/developers/api-reference/audits/issues.md): GET /projects/{projectId}/audits/{auditId}/issues - Get issues for a specific audit sorted by severity
- [List Backlink Targets](https://www.ranked.ai/developers/api-reference/backlinks/overview.md): GET /projects/{projectId}/backlinks - Get tracked backlink targets for a project
- [Backlink Summary](https://www.ranked.ai/developers/api-reference/backlinks/summary.md): GET /projects/{projectId}/backlinks/summary - Get aggregated backlink metrics for a project
- [Referring Domains](https://www.ranked.ai/developers/api-reference/backlinks/domains.md): GET /projects/{projectId}/backlinks/domains - Get referring domains with domain rank, backlink count, and follow status
- [Backlink History](https://www.ranked.ai/developers/api-reference/backlinks/history.md): GET /projects/{projectId}/backlinks/history - Get daily new and lost backlink counts over time
- [Anchor Text](https://www.ranked.ai/developers/api-reference/backlinks/anchors.md): GET /projects/{projectId}/backlinks/anchors - Get anchor text analysis showing the most common anchor texts in your backlink profile
- [List Content](https://www.ranked.ai/developers/api-reference/content/list.md): GET /projects/{projectId}/content - Get content calendar items for a project
- [Content Detail](https://www.ranked.ai/developers/api-reference/content/detail.md): GET /projects/{projectId}/content/{contentId} - Get full details for a content item including the article body
- [Content Preferences](https://www.ranked.ai/developers/api-reference/content/preferences.md): GET /projects/{projectId}/content/preferences - Get or update content preferences for a project
- [Reports](https://www.ranked.ai/developers/api-reference/reports/list.md): GET /projects/{projectId}/reports - List or create shareable SEO report links
- [Report Detail](https://www.ranked.ai/developers/api-reference/reports/detail.md): GET /projects/{projectId}/reports/{reportId} - Get or delete a specific report
- [List Webhooks](https://www.ranked.ai/developers/api-reference/webhooks/list.md): GET /webhooks - List webhook subscriptions or create a new one
- [Manage Webhook](https://www.ranked.ai/developers/api-reference/webhooks/manage.md): GET /webhooks/{webhookId} - Get, update, or delete a webhook subscription
- [Test Webhook](https://www.ranked.ai/developers/api-reference/webhooks/test.md): POST /webhooks/{webhookId}/test - Send a test payload to verify your webhook endpoint

## SDK

- [TypeScript SDK](https://www.ranked.ai/developers/sdk.md): Lightweight TypeScript client for the Ranked AI REST API v1.

## Changelog

- [Changelog](https://www.ranked.ai/developers/changelog.md): Updates and changes to the Ranked AI API

## Support

- [Support](https://www.ranked.ai/developers/support.md): Get help with the Ranked AI API

## Machine-readable

- [OpenAPI 3.1 specification](https://www.ranked.ai/developers/openapi.json): every endpoint, parameter and schema
- [Full documentation in one file](https://www.ranked.ai/developers/llms-full.txt)
- [Agent skill](https://www.ranked.ai/developers/skill.md): SKILL.md for AI coding tools
- [TypeScript SDK source](https://www.ranked.ai/developers/sdk/ranked-ai.ts)