Docs
搜索文档...⌘K

项目健康评分

API + MCP
GET/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

目标的协议。可能的值:bothhttphttps

target_urlstring

项目目标的 URL。

target_modestring

目标的范围。可能的值:exactprefixdomainsubdomains

datestring or null

最近一次已完成抓取的结束日期和时间(GMT 时区)。

statusstring or null

最近一次已完成抓取的状态。可能的值:CompletedStoppedErrorIn_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 总数