项目问题

API + MCP

GET/v3/site-audit/issues

此端点每次请求会消耗固定的 50 API 单位。

查询参数

date_comparedstring (date-time)

以 YYYY-MM-DDThh:mm:ss 格式表示的时间戳，用于指定要与指标进行对比的抓取日期。遵循与 date 字段相同的规则。

datestring (date-time)

以 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

响应

issuesarray<object>

addedinteger or null

当前日期存在该问题、但在上一日期不存在该问题的 URL 数量。

categorystring

问题的类别。可能的值：Internal pages、Indexability、Links、Redirects、Content、Social tags、Duplicates、Localization、Usability and performance、Images、JavaScript、CSS、Sitemaps、External pages、Other。

changeinteger or null

指定日期之间受影响 URL 数量的差值。

crawledinteger

当前受该问题影响的 URL 数量。

importancestring

问题的重要性。可能的值：Error、Warning、Notice。

is_indexableboolean or null

如果该问题仅适用于可索引页面，则为 True。

issue_idstring

问题的唯一标识符。

missinginteger or null

在上一日期存在该问题，但在当前日期无法找到的 URL 数量。

namestring

问题的名称。

newinteger or null

当前日期新发现且存在该问题的 URL 数量。

removedinteger or null

在上一日期存在该问题，但在当前日期不再存在该问题的 URL 数量。