ForHosting KIT · SEO

Como verificar o hreflang

Se o seu site existe em mais de um idioma, o hreflang diz ao Google qual versão mostrar para cada público. Cole o HTML e a ferramenta confere códigos de idioma e região, duplicidades e a presença do x-default. Grátis no navegador; a conferência direto por URL é feita via API.

● EstávelGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

O visitante certo na versão certa

Hreflang mal configurado tem um sintoma cruel: o brasileiro busca no Google e cai na versão de Portugal do seu site, com preço em euro e um português que não é o dele — e volta correndo para o resultado do concorrente. A tag existe para evitar exatamente isso: declarar que a página pt-BR atende o Brasil, a es atende a América hispânica, e assim por diante. Quando as tags erram o código ou se contradizem, o buscador ignora tudo e improvisa.

Erros clássicos que a checagem pega

Código de idioma ou país que não existe (en-UK em vez de en-GB é o campeão), tags duplicadas apontando para destinos diferentes, ausência do x-default que define a versão de fallback, e a falta de autorreferência — a página que declara as irmãs mas esquece de si mesma. São detalhes miúdos de sintaxe que nenhum olho humano confere de bom grado, e que decidem se o conjunto inteiro de tags vale ou é descartado.

Modo grátis: cole e confira, sem enviar nada

Copie o HTML da página e cole aqui: o exame roda dentro do seu navegador, o código não é transmitido e não há cadastro nem limite de usos. É a conferência ideal durante o desenvolvimento, quando o site multilíngue ainda está em homologação e nem sequer tem URL pública. Cada colagem analisa uma página; para conferir as versões irmãs, cole cada uma delas — os conjuntos precisam bater entre si.

No pipeline, via API

Sites multilíngues mudam o tempo todo, e cada deploy é uma chance de quebrar as tags. Pela API, a checagem é feita direto pela URL, a US$ 0,002 por chamada, com retorno estruturado — o formato certo para rodar depois de cada publicação e alertar quando um template esquecer o x-default. Para quem mantém dezenas de páginas em três ou quatro idiomas, é a diferença entre descobrir o erro no deploy ou no relatório de tráfego.

Casos de uso

Loja que vende para Brasil e Portugal

O mesmo produto tem página em pt-BR e pt-PT. A checagem garante que cada versão declara a outra corretamente — sem isso, o Google escolhe uma só e o cliente português vê preço em real.

SaaS de olho na América Latina

Uma empresa de software de Florianópolis lançou o site em espanhol. Conferir os pares pt-BR/es antes do lançamento evitou que o tráfego mexicano caísse na versão portuguesa.

Turismo na tríplice fronteira

Um hotel de Foz do Iguaçu mantém o site em português, espanhol e inglês. As tags garantem que o argentino que busca no Google veja a versão em espanhol, não a brasileira.

Agência cuidando de multinacional

Com 12 mercados no ar, a equipe cola o HTML de cada template novo e valida os códigos de região antes de replicar para o site inteiro.

Perguntas frequentes

Meu site é só em português. Preciso de hreflang?

Não. A tag só faz sentido quando existem duas ou mais versões de idioma ou região disputando o mesmo público. Com uma versão única, deixe o campo fora do template.

Uso pt ou pt-BR na tag?

Se você distingue Brasil de Portugal, use pt-BR e pt-PT. Se existe uma única versão em português para todos, pt genérico resolve. O erro é misturar os dois critérios entre páginas.

A ferramenta confere as tags de retorno das outras versões?

Cada análise examina o HTML de uma página. Para validar a reciprocidade, cole também as versões irmãs: o erro de retorno aparece quando os conjuntos declarados não batem entre si.

Hreflang melhora meu ranqueamento?

Diretamente, não — ele não é fator de ranking. O ganho é de direcionamento: cada público vê a versão certa, o que reduz rejeição e melhora o comportamento na página.

O HTML que eu colo fica registrado?

Não fica: a checagem gratuita roda na sua aba e nada é enviado ou armazenado. Sites em homologação podem ser conferidos sem exposição.

E quanto custa pela API?

US$ 0,002 por chamada, apontando a URL. Sem plano, sem mínimo — bom para automatizar a conferência no deploy.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/seo/hreflang-check

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/seo/hreflang-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"url":"https://ejemplo.com"}'

const res = await fetch("https://api.kit.forhosting.com/seo/hreflang-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "url": "https://ejemplo.com"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/hreflang-check",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "url": "https://ejemplo.com"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/hreflang-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"url":"https://ejemplo.com"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"url":"https://ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/hreflang-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "url": "https://ejemplo.com"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.hreflang_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →

Executar grátis