SEO Endpoints

The SEO endpoints provide programmatic access to SEO analysis tools: • **SEO Report** - Comprehensive SEO audit report ({{PRICE_SEO_REPORT}}/request) • **PageSpeed** - Core Web Vitals and performance analysis (£0.010/request) • **SERP Track** - Track single keyword ranking (£0.030/request) • **SERP Batch** - Track multiple keywords (£0.030/keyword) These endpoints use browser automation, Google's PageSpeed Insights API, and professional SERP tracking services to deliver accurate, real-time data.

Analyze a URL's Core Web Vitals and performance metrics. **Endpoint:** `POST /v1/seo/pagespeed` **Request:** ```json { "url": "https://example.com", "strategy": "mobile" } ``` **Response:** ```json { "success": true, "data": { "url": "https://example.com", "strategy": "mobile", "score": 72, "coreWebVitals": { "lcp": 2.4, "fid": 0.08, "cls": 0.12, "fcp": 1.8, "ttfb": 0.6 }, "opportunities": [ { "id": "render-blocking-resources", "title": "Eliminate render-blocking resources", "savings": "1.2s" } ], "diagnostics": [...] }, "usage": { "cost": 0.05, "balanceRemaining": 19.95 } } ``` **Cost:** £0.010 per analysis **Strategies:** `mobile` (default) or `desktop`

Track a keyword's ranking position in search results. **Endpoint:** `POST /v1/seo/serp/track` **Request:** ```json { "keyword": "seo tools", "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Response:** ```json { "success": true, "data": { "keyword": "seo tools", "domain": "example.com", "position": 8, "url": "https://example.com/seo-tools", "searchVolume": 12000, "difficulty": 65, "topResults": [ { "position": 1, "url": "https://competitor1.com/...", "title": "..." }, { "position": 2, "url": "https://competitor2.com/...", "title": "..." } ], "features": ["featured_snippet", "people_also_ask"], "trackedAt": "2026-02-27T12:00:00Z" }, "usage": { "cost": 0.03, "balanceRemaining": 19.97 } } ``` **Cost:** £0.030 per keyword

Track multiple keywords in a single request (up to 50). **Endpoint:** `POST /v1/seo/serp/batch` **Request:** ```json { "keywords": ["seo tools", "keyword research", "serp tracking"], "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Response:** ```json { "success": true, "data": { "results": [ { "keyword": "seo tools", "position": 8, "change": 2 }, { "keyword": "keyword research", "position": 15, "change": -3 }, { "keyword": "serp tracking", "position": 4, "change": 1 } ], "summary": { "total": 3, "improved": 2, "declined": 1, "avgPosition": 9 } }, "usage": { "cost": 0.075, "balanceRemaining": 19.925 } } ``` **Cost:** £0.030 per keyword (17% discount vs single tracking)

The following SEO endpoints are planned for a future release: • **Crawl** - Crawl and analyze individual pages • **Audit** - Full technical SEO audit with 8 analyzers These endpoints require browser automation infrastructure. Subscribe to our changelog for updates on availability.