Dados da web

API de auditoria de SEO on-page

Audite uma página por pedido e obtenha todos os sinais de SEO on-page numa única resposta JSON: meta tags, diretivas canonical e robots, estrutura de cabeçalhos, contagem de palavras, links, imagens, Open Graph e dados estruturados, além de 38 verificações ponderadas e uma pontuação de 0 a 100. Adicione render=true para auditar a página depois de o JavaScript ser executado.

Ver documentação Testar a ferramenta gratuita Explorar todas as APIs

Pontos finais Ativo

GET /v1/onpage

Exemplo de requisição

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/onpage?url=example.com/shoes/trail-runner&render=true"

Exemplo de resposta 200 OK

{
  "status": "ok",
  "score": 87,
  "meta": {
    "title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
    "title_length": 55,
    "canonical_self_referencing": true,
    "indexable": true
  },
  "headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
  "content": { "word_count": 122, "text_to_html_ratio": 0.221 },
  "checks": [
...

Exemplo de requisição GET /v1/onpage

Principais Recursos 4

Perguntas frequentes 4

Códigos de status HTTP 200 / 400 / 401 / 402 / 429

Categoria Dados da web

Pontos finais 1

Principais Recursos 4

Perguntas frequentes 4

Usado por pessoas nestas empresas

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

O que esta API ajuda você a lançar

Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.

Fluxo de integração

Um caminho simples da primeira requisição ao uso repetível em produção.

Autentique uma vez

Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.

Consulte com exemplos

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Opere e monitore

Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.

Kit de desenvolvedor

Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.

Esquema OpenAPI

Gere clientes ou inspecione cada formato de requisição e resposta.

Coleção Postman

Importe requisições prontas para testes manuais e repasse ao time.

SDKs e CLI

Use pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.

Integração MCP

Exponha inteligência de domínios para agentes de IA e assistentes internos.

Mapa de parâmetros e resposta

Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.

Parâmetros da requisição

Parâmetro

urlrender

Campos da resposta

Exemplo de resposta

statusscoremetameta.titlemeta.title_lengthmeta.canonical_self_referencingmeta.indexableheadingsheadings.h1contentcontent.word_countcontent.text_to_html_ratio

Cobertura de status

Códigos de status HTTP

200400401402429

Pontos finais

GET /v1/onpage

Créditos: 2-6Autenticação: Autenticação necessária

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Status do serviço Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

Cota gratuita Cadastre-se gratuitamente

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Ativo Exemplo de requisição

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Principais Recursos

Em bruto ou renderizada

Audite o HTML que o seu servidor envia, ou defina render=true para auditar a página depois de o JavaScript ser executado num navegador isolado, tal como os rastreadores modernos veem as aplicações de página única.

38 verificações ponderadas

Cada verificação devolve aprovado, aviso, falha ou não aplicável com uma gravidade, desde títulos em falta e canonicals em conflito até conteúdo misto, imagens sem texto alternativo e níveis de cabeçalho ignorados.

Todos os sinais numa só chamada

Comprimento do título e da descrição, meta robots e X-Robots-Tag, idioma, viewport, favicon, Open Graph, Twitter cards, contagem de links e imagens e tipos de dados estruturados.

Desconhecidos assumidos

Os pedidos bloqueados, limitados ou falhados devolvem status unknown com um motivo e são reembolsados, para que uma página que não foi possível ler nunca pareça uma página limpa.

Exemplo de requisição

GET /v1/onpage?url=example.com/shoes/trail-runner&render=true bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/onpage?url=example.com/shoes/trail-runner&render=true"

Exemplo de resposta

200 OK json

{
  "status": "ok",
  "score": 87,
  "meta": {
    "title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
    "title_length": 55,
    "canonical_self_referencing": true,
    "indexable": true
  },
  "headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
  "content": { "word_count": 122, "text_to_html_ratio": 0.221 },
  "checks": [
    { "id": "mixed_content", "status": "fail", "severity": "high", "value": 1 },
    { "id": "images_alt", "status": "warn", "severity": "medium", "value": 1 }
  ],
  "issues": ["mixed_content", "heading_hierarchy", "word_count", "images_alt"]
}

Perguntas frequentes

Como é calculada a pontuação?

As verificações de gravidade alta valem 10 pontos, as médias 5 e as baixas 2. Uma aprovação obtém o peso total, um aviso obtém metade e uma falha não obtém nada. As verificações que não se aplicam, como o texto alternativo de imagens numa página sem imagens, ficam de fora.

Quando devo utilizar render=true?

Utilize-o em páginas criadas com frameworks de JavaScript, onde os títulos, o conteúdo ou os links só aparecem depois de os scripts serem executados. Compare ambas as versões com a API de SEO de JavaScript para ver exatamente o que muda.

Rastreia o site inteiro?

Não. Cada pedido audita um URL, pelo que controla que páginas são verificadas e quanto gasta. Combine-a com a API de auditoria de sitemap para escolher os URL a auditar.

Quantos créditos custa?

Dois créditos por uma auditoria de HTML em bruto e seis créditos com render=true. Os resultados que terminam em status unknown são reembolsados.

Ferramentas e recursos relacionados

Códigos de status HTTP

Estes são os códigos de status HTTP que você deve tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados ausentes e falhas de origem.

OK 200

Pedido bem-sucedido

Pedido inválido 400

Parâmetros inválidos

Não autorizado 401

Chave de API ou sessão em falta ou inválida.

Pagamento necessário 402

Não tens créditos suficientes para executar este pedido.

Demasiados pedidos 429

Limite de taxa excedido

Auditar uma página

Começar gratuitamente Ver documentação Testar a ferramenta gratuita