Skip to content
SEO Optimizer is live, Audit on page SEO and AI-search readiness. Try it free
Scanverra
SEO Optimizer

Referência da API

Otimizador de SEO

Analisa o SEO on-page, a prontidão GEO/busca por IA e os sinais de confiança E-E-A-T de uma página, com renderização de JavaScript opcional, comparação de palavras-chave/concorrentes, e dados do Google Search Console.

POST/api/seo-optimizerasync

Inicia uma varredura - SEO on-page, GEO, E-E-A-T e renderização JS opcional

docsApiSeoOptimizer.scanCallout

Corpo da requisição

{
  "url": "https://example.com/page",
  "keyword": "target keyword",
  "competitorUrl": "https://competitor.com/page",
  "renderJs": false
}

Resposta (imediata)

{
  "scanId": "clxyz..."
}

Exemplo

curl -X POST https://www.scanverra.com/api/seo-optimizer \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page","keyword":"widgets"}'
GET/api/seo-optimizersynchronous

Obtém o status e os resultados completos de uma varredura assim que concluída

Parâmetros de consulta

?id={scanId}

Resposta

{
  "id": "clxyz...",
  "status": "done",
  "score": 88,
  "pageData": {...},
  "findings": [...],
  "keywordAnalyses": [...],
  "crawlability": {...},
  "aiSuggestions": {...},
  "competitorPageData": {...},
  "competitorFindings": [...]
}

status é running, done ou failed. pageData, findings e aiSuggestions só são preenchidos quando status é done.

Exemplo

curl "https://www.scanverra.com/api/seo-optimizer?id=clxyz..." \
  -H "X-API-Key: sk_live_..."

Campos opcionais da requisição

keyword: palavras-chave alvo separadas por vírgula, para verificar posicionamento/densidade. competitorUrl: uma segunda URL para escanear e comparar no mesmo relatório. renderJs: defina como true para renderizar a página em um navegador headless primeiro - mais lento, mas vê conteúdo que um fetch simples não captaria em sites React/Vue/SPA.