{
"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'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Hreflang 验证器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
检查网页的 hreflang 注释是否符合谷歌的文档规则,并验证最多 10 个备用链接是否回指。返回一个带有稳定问题代码的评分 JSON 报告
语言和地区代码 自我引用 x-default 冲突或重复注释 相对网址 规范冲突以及最多10个替代链接是否回溯 它返回一个等级 一个分数和编码问题
每页最多10个,按照声明顺序列出前10个。当一页列出更多时,returnLinks.partial为true,成绩仅涵盖实际上检查的替代项
不 只有在HTML头部的link标签和Link响应头中会读取hreflang 仅在网站地图中声明hreflang的页面被报告为没有hreflang
是的 像example.com这样的裸域被视为https 参数别名如u link target和site也被接受
在总结中对错误数量进行门控,而不仅仅是字母等级 在部署后将新参数设置为1以绕过15分钟的缓存
API返回一个分级的JSON报告,其中包括检查的URL 状态码 hreflang发现 问题摘要以及与hreflang注释相关的任何错误或警告的详细信息
关键字段包括“url”(检查的URL),“statusCode”(HTTP响应代码),“grade”(总体评估),“summary”(错误、警告和信息的计数)和“issues”(发现的任何问题的详细描述)
响应以JSON格式构造,顶级字段包括URL、状态、等级、摘要和问题。每个问题包括严重性、代码、消息和供进一步参考的文档链接
该API提供有关hreflang标注的信息,包括它们的存在性、正确性、自我引用、x-default设置以及替代链接是否正确回链,还包括用于评估的评分系统
用户可以通过指定要验证的 URL 来自定义请求他们还可以通过调整 maxAlternates 参数来控制检查的备选项数量尽管默认设置为 10
典型用例包括验证多语言网站的 hreflang 注释确保正确的 SEO 实践以及识别可能影响搜索引擎索引和不同地区用户体验的问题
用户可以分析“等级”和“摘要”字段来评估整体 hreflang 实施质量 “问题”数组提供可操作的见解以修复特定问题,增强网站本地化工作
通过遵循谷歌记录的hreflang注释规则来维护数据准确性 API会检查是否符合这些标准并提供稳定的错误代码以确保一致的报告