Endpoints de SEO

Os endpoints de SEO oferecem acesso programático às ferramentas de análise de SEO: • **SEO Report** — relatório completo de auditoria de SEO ({{PRICE_SEO_REPORT}}/requisição) • **PageSpeed** — análise de Core Web Vitals e performance (€0,012/requisição) • **SERP Track** — acompanhe a posição de uma palavra-chave (€0,035/requisição) • **SERP Batch** — acompanhe várias palavras-chave (€0,035/keyword) Estes endpoints usam automação de navegador, a API PageSpeed Insights do Google e serviços profissionais de tracking de SERP para entregar dados precisos em tempo real.

Analisa os Core Web Vitals e métricas de performance de uma URL. **Endpoint:** `POST /v1/seo/pagespeed` **Requisição:** ```json { "url": "https://example.com", "strategy": "mobile" } ``` **Resposta:** ```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 } } ``` **Custo:** €0,012 por análise **Estratégias:** `mobile` (padrão) ou `desktop`

Acompanha a posição de uma palavra-chave nos resultados de busca. **Endpoint:** `POST /v1/seo/serp/track` **Requisição:** ```json { "keyword": "seo tools", "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Resposta:** ```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 } } ``` **Custo:** €0,035 por palavra-chave

Acompanha várias palavras-chave em uma única requisição (até 50). **Endpoint:** `POST /v1/seo/serp/batch` **Requisição:** ```json { "keywords": ["seo tools", "keyword research", "serp tracking"], "domain": "example.com", "location": "United Kingdom", "language": "en" } ``` **Resposta:** ```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 } } ``` **Custo:** €0,035 por palavra-chave (17 % de desconto em relação ao tracking individual)

Os seguintes endpoints de SEO estão planejados para uma versão futura: • **Crawl** — fazer crawl e analisar páginas individuais • **Audit** — auditoria técnica de SEO completa com 8 analisadores Esses endpoints exigem infraestrutura de automação de navegador. Inscreva-se em nosso changelog para receber novidades sobre disponibilidade.