项目健康评分
API + MCPGET/v3/site-audit/projects
对此端点的请求免费,不会消耗任何 API 单位。
查询参数
project_urlstring
按目标 URL 筛选项目(忽略协议和末尾斜杠)。
project_namestring
按名称筛选项目。
datestring
以 YYYY-MM-DDThh:mm:ss 格式表示的时间戳,用于指定要从哪次抓取中获取指标的抓取日期。如未提供,则默认使用最近一次可用的抓取。对于计划抓取,我们会返回在该时间戳之前完成的最近一次抓取的数据。对于始终开启的审计抓取,我们会返回截至所提供日期和时间的数据。如果省略时间部分,则默认使用 00:00:00。该时间戳按 UTC 解释。
project_idinteger
项目的唯一标识符。你可以在 Ahrefs 的 Site Audit 项目 URL 中找到它:https://app.ahrefs.com/site-audit/#project_id#
outputstring
输出格式。
允许的值:jsoncsvxmlphp
响应
healthscoresarray<object>
project_idstring
项目的唯一标识符。
project_namestring
项目名称。
target_protocolstring
目标的协议。可能的值:both、http、https。
target_urlstring
项目目标的 URL。
target_modestring
目标的范围。可能的值:exact、prefix、domain、subdomains。
datestring or null
最近一次已完成抓取的结束日期和时间(GMT 时区)。
statusstring or null
最近一次已完成抓取的状态。可能的值:Completed、Stopped、Error、In_progress。
health_scoreinteger or null
基于最近一次已完成抓取,反映你的网站内部 URL 中无错误 URL 的占比。不包括正在开始、进行中、收尾阶段或已跳过的抓取。
urls_with_errorsinteger or null
存在错误的内部 URL 数量
urls_with_warningsinteger or null
存在警告的内部 URL 数量
urls_with_noticesinteger or null
存在提示的内部 URL 数量
totalinteger or null
抓取到的内部 URL 总数
errorstring
errorstring
errorstring
errorstring
errorstring