{
"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'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Validador de Hreflang API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Verifica las anotaciones hreflang de una página web contra las reglas documentadas de Google y comprueba que hasta 10 alternativas enlacen de vuelta. Devuelve un informe JSON calificado con códigos de problemas estables
Códigos de idioma y región autorreferencia x-default anotaciones en conflicto o duplicadas URL relativas conflictos canónicos y si hasta 10 alternativos vinculan de nuevo Devuelve una calificación una puntuación y problemas codificados
Máximo 10 por página los primeros 10 en orden de declaración Cuando una página lista más returnLinks.partial es verdadero y la calificación cubre solo los alternos que realmente se han verificado
No. Solo se leen las etiquetas de enlace en la cabecera HTML y el encabezado de respuesta Link. Una página que declara hreflang solo en un mapa del sitio se informa como que no tiene hreflang
Sí Un dominio desnudo como example.com se trata como https Se aceptan alias de parámetros como u link target y site también
Cuente los errores en el resumen en lugar de solo la calificación lettera Añada el parámetro fresh establecido en 1 para omitir la caché de 15 minutos justo después de un despliegue
La API devuelve un informe JSON clasificado que incluye la URL verificada el código de estado los hallazgos de hreflang un resumen de problemas y información detallada sobre cualquier error o advertencia relacionada con las anotaciones hreflang
Los campos clave incluyen "url" (la URL verificada) "statusCode" (código de respuesta HTTP) "grade" (evaluación general) "summary" (conteos de errores advertencias y información) y "issues" (descripciones detalladas de cualquier problema encontrado)
La respuesta está estructurada en formato JSON con campos de nivel superior para la URL el estado la calificación el resumen y los problemas Cada problema incluye severidad código mensaje y enlaces de documentación para referencia adicional
La API proporciona información sobre las anotaciones hreflang incluyendo su presencia corrección referencias auto x-default configuraciones y si los alternativos enlazan de vuelta correctamente junto con un sistema de evaluación.
Los usuarios pueden personalizar las solicitudes especificando la URL a validar. También pueden controlar el número de alternativos verificados ajustando el parámetro maxAlternates aunque el valor predeterminado se establece en 10
Los casos de uso típicos incluyen validar anotaciones hreflang para sitios web multilingües asegurar prácticas adecuadas de SEO e identificar problemas que podrían afectar la indexación en buscadores y la experiencia del usuario en diferentes regiones
Los usuarios pueden analizar los campos "grado" y "resumen" para evaluar la calidad general de la implementación de hreflang. El array "problemas" proporciona información útil para solucionar problemas específicos, mejorando los esfuerzos de localización del sitio
La precisión de los datos se mantiene al adherirse a las reglas documentadas de Google para las anotaciones hreflang La API verifica el cumplimiento de estos estándares y proporciona códigos de problemas estables para asegurar informes consistentes