Docs
ドキュメントを検索...⌘K

プロジェクト健全性スコア

API + MCP
GET/v3/site-audit/projects

このエンドポイントへのリクエストは無料で、API ユニットを消費しません。

クエリパラメータ

project_urlstring

プロジェクトをターゲット URL で絞り込みます(プロトコルと末尾のスラッシュは無視します)。

project_namestring

プロジェクトを名前で絞り込みます。

datestring

取得する指標の基準となるクロール日を指定する、YYYY-MM-DDThh:mm:ss 形式のタイムスタンプです。省略した場合、利用可能な最新のクロールが既定になります。スケジュールされたクロールの場合は、指定したタイムスタンプより前に完了した最新のクロールのデータを返します。Always-on 監査クロールの場合は、指定した日時時点のデータを返します。時刻部分を省略すると、00:00:00 が既定になります。このタイムスタンプは UTC として解釈されます。

project_idinteger

プロジェクトの一意の識別子です。Ahrefs のサイト監査プロジェクトの 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

ターゲットのスコープ。利用可能な値: exact, prefix, domain, subdomains

datestring or null

最後に完了したクロールの完了日時(GMT)。

statusstring or null

最新の完了済みクロールのステータス。指定可能な値: CompletedStoppedErrorIn_progress

health_scoreinteger or null

最後に完了したクロールに基づき、エラーのないサイト内の内部URLの割合を示します。開始中、進行中、最終処理中、またはスキップされたクロールは除外されます。

urls_with_errorsinteger or null

エラーのある内部URLの数

urls_with_warningsinteger or null

警告のある内部URLの数

urls_with_noticesinteger or null

通知のある内部URLの数

totalinteger or null

クロールされた内部URLの総数