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