{
"url": "https://example.com/",
"finalUrl": "https://example.com/",
"statusCode": 200,
"hreflangFound": false,
"grade": "A+",
"score": 99,
"summary": {
"errors": 0,
"warnings": 0,
"infos": 1
},
"issues": [
{
"severity": "info",
"code": "no_hreflang",
"message": "No hreflang annotations were found in the HTML <head> or the Link header. That is fine for a single-language site; multilingual sites should declare every language version. Basis: Google Search Central, \"Tell Google about localized versions of your page\".",
"docs": "https://developers.google.com/search/docs/specialty/international/localized-versions"
}
],
"omittedIssues": 0,
"annotations": [],
"annotationCount": 0,
"selfReference": {
"found": false,
"hreflang": []
},
"xDefault": null,
"canonical": null,
"returnLinks": null,
"cached": false,
"checkedAt": "2026-10-21T02:00:54.694Z",
"note": "Checks the hreflang annotations a page declares in its HTML <head> and Link response header, and fetches up to maxAlternates alternate URLs (without following their redirects) to verify return links. XML sitemap annotations are not read, JavaScript is not rendered, and the result does not show which version Google actually serves in search results."
}
curl --location --request GET 'https://zylalabs.com/api/14381/hreflang+validator+api/36043/validate+the+hreflang+annotations+of+a+live+page?url=https://example.com&maxAlternates=10' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Validador Hreflang API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Verifica as anotações hreflang de uma página da web em relação às regras documentadas do Google e verifica se até 10 alternados fazem link de volta. Retorna um relatório em JSON classificado com códigos de problemas estáveis
Códigos de idioma e região autocitação x-default anotações conflitantes ou duplicadas URLs relativas conflitos canônicos e se até 10 alternativas se vinculam de volta Retorna uma nota uma pontuação e problemas codificados
No máximo 10 por página os primeiros 10 na ordem da declaração quando uma página lista mais retornolinks.parcial é verdadeiro e a nota abrange apenas os alternates realmente verificados
Não Apenas as tags de link no cabeçalho HTML e o cabeçalho de resposta Link são lidos Uma página que declara hreflang apenas em um sitemap é relatada como não tendo hreflang
Sim Um domínio simples como example.com é tratado como https Aliases de parâmetros como u link target e site também são aceitos
Contabilize os erros no resumo em vez de apenas na nota Letra Adicione o novo parâmetro definido como 1 para ignorar o cache de 15 minutos logo após um deploy
A API retorna um relatório JSON classificado que inclui a URL verificada, o código de status, as descobertas de hreflang, um resumo dos problemas e informações detalhadas sobre quaisquer erros ou avisos relacionados às anotações hreflang
Os campos principais incluem "url" (a URL verificada) "statusCode" (código de resposta HTTP) "grade" (avaliação geral) "summary" (contagem de erros avisos e informações) e "issues" (descrições detalhadas de quaisquer problemas encontrados)
A resposta é estruturada no formato JSON com campos de nível superior para a URL status nota resumo e problemas Cada problema inclui severidade código mensagem e links de documentação para referência adicional
A API fornece informações sobre anotações hreflang incluindo sua presença correção autorreferências configurações x-default e se os alternativos fazem o link de volta corretamente juntamente com um sistema de classificação para avaliação
Os usuários podem personalizar as solicitações especificando a URL a ser validada Eles também podem controlar o número de alternados verificados ajustando o parâmetro maxAlternates embora o padrão seja 10
Casos de uso típicos incluem validar anotações hreflang para websites multilíngues, garantir práticas adequadas de SEO e identificar problemas que possam afetar a indexação por mecanismos de busca e a experiência do usuário em diferentes regiões
Os usuários podem analisar os campos "nota" e "resumo" para avaliar a qualidade geral da implementação de hreflang O array "problemas" fornece insights acionáveis para corrigir problemas específicos, melhorando os esforços de localização do site
A precisão dos dados é mantida pela adesão às regras documentadas do Google para anotações hreflang A API verifica a conformidade com esses padrões e fornece códigos de erro estáveis para garantir relatórios consistentes