Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
Dados da web
API de validação de hreflang
Valide as anotações hreflang de uma página a partir do HTML e dos cabeçalhos HTTP e obtenha até 20 páginas alternativas para confirmar que cada uma liga de volta. Detete códigos inválidos, x-default em falta, autorreferências em falta e links de retorno quebrados.
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.
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
Comece com 1.000 créditos grátis todo mês. Precisa de mais? Escolha um plano mensal ou compre um pacote avulso.
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.
Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.
Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.
Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.
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.
Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.
Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.
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.
Gere clientes ou inspecione cada formato de requisição e resposta.
Coleção PostmanImporte requisições prontas para testes manuais e repasse ao time.
SDKs e CLIUse pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.
Integração MCPExponha 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âmetro
Exemplo de resposta
Códigos de status HTTP
Pontos finais
/v1/hreflang
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.
Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
Comece com 1.000 créditos grátis todo mês. Precisa de mais? Escolha um plano mensal ou compre um pacote avulso.
Principais Recursos
Os subtags de idioma, escrita e região são verificados, incluindo erros comuns como en-UK em vez de en-GB e sublinhados em vez de hífenes.
As páginas alternativas são obtidas para confirmar que ligam de volta à página, e são assinalados os redirecionamentos, os canonicals que apontam para outro lado e as incompatibilidades de idioma.
As anotações são lidas a partir das tags link e do cabeçalho HTTP Link, e cada entrada mostra onde foi encontrada.
A autorreferência em falta, o x-default em falta, os URL relativos e um código que aponta para vários URL são indicados para o conjunto inteiro.
Exemplo de requisição
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/hreflang?url=example.com/shoes/trail-runner"
Exemplo de resposta
{
"status": "ok",
"entries": [
{ "hreflang": "en", "url": "https://example.com/shoes/trail-runner", "valid_code": true },
{ "hreflang": "es-ES", "url": "https://example.com/es/zapatillas/trail-runner", "valid_code": true },
{ "hreflang": "x-default", "url": "https://example.com/shoes/trail-runner", "valid_code": true }
],
"self_reference": true,
"x_default": true,
"issues": [],
"return_links": { "checked": 1, "confirmed": 1, "missing": 0, "unknown": 0 }
}
Perguntas frequentes
Pelo menos uma página alternativa foi lida e não liga de volta à página auditada. As anotações hreflang têm de ser recíprocas, caso contrário os motores de pesquisa podem ignorá-las.
É indicada como desconhecida com um motivo, nunca como um link de retorno em falta, para que páginas bloqueadas ou lentas não criem falsos erros.
Esta API verifica o HTML da página e os cabeçalhos HTTP. Utilize a API de auditoria de sitemap para ver se os sitemaps têm extensões hreflang.
Três créditos por auditoria, incluindo a verificação de links de retorno de até 20 páginas alternativas. 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.
Pedido bem-sucedido
Parâmetros inválidos
Chave de API ou sessão em falta ou inválida.
Não tens créditos suficientes para executar este pedido.
Limite de taxa excedido
Validar hreflang

