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

競合ページ

API + MCP
GET/v3/rank-tracker/competitors-pages

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

クエリパラメータ

timeoutinteger

手動で設定するタイムアウト時間(秒)です。

limitinteger

返す結果数です。

デフォルト:1000
order_bystring

結果の並び替えに使用する列を、任意で方向を付けてカンマ区切りで指定します。有効な列識別子については、レスポンスのスキーマを参照してください。

Example:field_a,field_b:asc,field_c:desc
wherestring

フィルター式。次の列識別子が認識されます(select パラメータで認識される識別子とは異なります)。

selectstring必須

返却する列のカンマ区切りリスト。有効な列識別子については、レスポンススキーマを参照してください。

target_and_tracked_competitors_onlyboolean

ページをターゲットおよび追跡中の競合他社に限定します

デフォルト:false
date_comparedstring (date)

比較対象とする日付(YYYY-MM-DD 形式)。

datestring (date)必須

メトリクスのレポート対象日(YYYY-MM-DD形式)。

devicestring必須

モバイルとデスクトップのランキングを選択します。

許可される値:desktopmobile
project_idinteger必須

プロジェクトの一意の識別子。AhrefsのランクトラッカーのプロジェクトURLで確認できます:https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

検索ボリュームの計算モード:monthly または average。ボリューム、トラフィック、およびトラフィック値に影響します。

許可される値:monthlyaverage
デフォルト:monthly
outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

competitors-pagesarray<object>
keywordsinteger

ターゲットがオーガニック検索結果の上位 100 位以内にランクインしたキーワードの合計数。

share_of_traffic_valuenumber (float)

ターゲットのオーガニック検索トラフィック値のシェアを、すべての追跡されたキーワードに対する総オーガニック検索トラフィック値と比較したものです。

share_of_traffic_value_prevnumber (float)

比較する日付におけるトラフィック値のシェア。

share_of_voicenumber (float)

ターゲットのオーガニック検索トラフィックのシェアを、すべての追跡されたキーワードに対する総オーガニック検索トラフィックと比較したものです。

share_of_voice_prevnumber (float)

比較する日付におけるシェア・オブ・ボイス。

statusstring

ページのステータス:新たにランクインし始めたページ(「left」)、検索結果から消えたページ(「right」)、または変更なし(「both」)。

Allowed values:leftrightboth
titlestring or null

上位キーワードの SERP でページに表示されるタイトル。

title_prevstring or null

比較する日付におけるタイトル。

trafficinteger

オーガニック検索から獲得した月間アクセス数の推定値。

traffic_previnteger

比較する日付におけるトラフィック。

traffic_valueinteger or null

米ドルセントで表した、あるページの月間オーガニック検索トラフィックの推定価値。

traffic_value_previnteger or null

比較する日付におけるトラフィック値。

urlstring (url)

ページのURL。