# On-Page SEO API

> On-page SEO optimization data for applications and AI agents. Scan any page
> against the top Google results to find missing entities, content gaps, and
> prioritized fixes, returned as a structured JSON report. Available as a REST
> API and an MCP server. New accounts get 10 free credits — no credit card.

If you are an AI agent, the complete product brief in a single file is at
https://api.on-page.ai/llms-full.txt — it covers endpoints, auth, the report
schema, pricing, rate limits, and MCP setup without crawling the site.

## Getting started
- [Quickstart](https://api.on-page.ai/docs/quickstart): Get an API key and run your first scan
- [Authentication](https://api.on-page.ai/docs/authentication): Bearer API keys, scopes, and error codes
- [Install / connect](https://api.on-page.ai/install): Connect the MCP server or call the REST API (12 clients)
- [Pricing](https://api.on-page.ai/pricing): Pay-as-you-go credit packs, no subscriptions

## API reference
- [API overview](https://api.on-page.ai/docs/api): All endpoints, parameters, and response shapes
- [Report schema](https://api.on-page.ai/docs/report-schema): Exact structure of a scan result (onpage-report-customer-v1)
- [Rate limits](https://api.on-page.ai/docs/rate-limits): Per-key and per-org limits, concurrency, and headers
- [Webhooks](https://api.on-page.ai/docs/webhooks): Async job-completion callbacks
- [SDKs](https://api.on-page.ai/docs/sdks): Client libraries

## MCP (for AI agents)
- [MCP server docs](https://api.on-page.ai/mcp/docs): Tools, prompts, and the HTTP (Streamable) transport
- [MCP install](https://api.on-page.ai/mcp/install): Connect Claude, Cursor, Codex, VS Code, Windsurf, Cline, ChatGPT

## Use cases (what you can achieve)
- [Make a page rank higher on Google and in AI answers](https://api.on-page.ai/automate-seo#7-standard-optimization-single-page): Optimize a page against the pages currently winning the SERP
- [Find out why a page isn't ranking](https://api.on-page.ai/automate-seo#11-advanced-page-diagnostic-why-isn-t-this-page-ranking): Pinpoint the relevance, entity-coverage, and structure gaps holding it back
- [Recover a page that lost its rankings](https://api.on-page.ai/automate-seo#1-recover-a-stuck-page-in-one-command): See what changed and fix a stuck or declining page fast
- [Out-rank a specific competitor](https://api.on-page.ai/use-cases/competitor-gap-analysis): Surface what the ranking pages cover that yours doesn't, prioritized by impact
- [Close the content gaps on a page](https://api.on-page.ai/use-cases/entity-gap-analysis): Add the high-value entities and topics the top results have and yours lacks
- [Optimize an entire site at scale](https://api.on-page.ai/automate-seo#8-standard-optimization-site-wide): Apply evidence-based fixes across every page without rewriting your content
- [Keep content fresh and stop ranking decay](https://api.on-page.ai/automate-seo#5-site-wide-refresh-fix-all-your-old-stale-pages): Refresh old and stale pages before they lose traffic
- [Strengthen rankings with internal links](https://api.on-page.ai/use-cases/internal-linking-plan): Add the internal links Google needs to understand and rank a page
- [Win new clients with instant audits](https://api.on-page.ai/use-cases/client-acquisition): Turn any prospect URL into a ready-to-send SEO opportunity report
- [Deliver client-ready audit reports](https://api.on-page.ai/automate-seo#9-full-client-website-audit-pdf): Produce a polished SEO audit for a whole site or a single page
- [Rank local pages across the cities you serve](https://api.on-page.ai/automate-seo#15-local-page-tuning-standard-optimization): Tune local pages to compete in each city or region
- [Find out why a local page isn't ranking](https://api.on-page.ai/automate-seo#14-local-page-diagnostic-why-isn-t-this-local-page-ranking): Diagnose local-specific relevance and coverage gaps
- [Align your site with your Google Business Profile](https://api.on-page.ai/automate-seo#16-local-website-gbp-alignment-verification): Make sure your local pages and GBP tell Google the same story
- [Stop your local pages from competing with each other](https://api.on-page.ai/automate-seo#17-local-website-cannibilization-checker-city-region-audit): Detect and resolve city/region keyword cannibalization

## Compare
- [On-Page.ai vs DataForSEO](https://api.on-page.ai/compare/dataforseo)
- [On-Page.ai vs Surfer SEO](https://api.on-page.ai/compare/surfer-seo)

## Optional
- [SEO recipes](https://api.on-page.ai/automate-seo): Ready-made agent workflows
- [Whitepaper: Agentic SEO Ops Playbook](https://api.on-page.ai/whitepaper/agentic-seo-ops-playbook)
- [Blog: AI-generated webpage production-readiness checklist](https://api.on-page.ai/blog/ai-generated-webpage-production-readiness-checklist)