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

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

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

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

クエリパラメータ

project_idinteger

プロジェクトの一意の識別子です。Ahrefs のサイト監査プロジェクトの URL(https://app.ahrefs.com/site-audit/#project_id#)で確認できます。

datestring (date-time)

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

project_namestring

名前でプロジェクトをフィルタリングします。

project_urlstring

ターゲット URL でプロジェクトをフィルタリングします(プロトコルと末尾のスラッシュは無視します)。

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

healthscoresarray<object>
datestring (date-time) or null

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

health_scoreinteger or null

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

project_idstring

プロジェクトの一意の識別子。

project_namestring

プロジェクト名。

statusstring or null

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

target_modestring

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

target_protocolstring

ターゲットのプロトコル。使用可能な値: bothhttphttps

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の数