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

競合の概要

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

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

クエリパラメータ

timeoutinteger

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

limitinteger

返す結果数です。

デフォルト:1000
order_bystring

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

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

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

selectstring必須

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

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

出力形式。

許可される値:jsonphp

応答

keywordsarray<object>
competitors_listarray<object>

特定のキーワードに関する競合情報。次のフィールドが含まれます:url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev。末尾が prev のフィールドは、比較ビューでのみ含まれます。

countrystring

特定のキーワードが追跡されている国。2 文字の国コード(ISO 3166-1 alpha-2)。

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keywordstring

ターゲットがランクインしているキーワード。

keyword_difficultyinteger or null

キーワード難易度とは、あるキーワードでオーガニック検索結果の上位 10 位以内にランクインするのがどれだけ難しいかを 100 点満点で評価したものです。

keyword_has_databoolean

キーワードがまだ処理中で、SERP がまだ取得されていない場合は false を返します。

keyword_is_frozenboolean

キーワードがプランの追跡キーワード上限を超過しているかどうかを示します。このようなキーワードは「凍結」され、ランキングは更新されません。

languagestring

特定のキーワードで追跡される SERP の言語。

locationstring

特定のキーワードが追跡されている場所(国、州/県、都市)。

serp_featuresarray<string>

キーワードの検索結果に表示される SERP の機能。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_updatedstring (date-time) or null

検索エンジンでキーワードの結果を最後に確認した日付。

serp_updated_prevstring (date-time) or null

比較日までの検索エンジン結果を確認した日付。

tagsarray<string>

特定のキーワードに割り当てられたタグのリスト。

volumeinteger or null

キーワードの月間平均検索回数を、「volume_mode」パラメータに応じて直近1か月、または直近の判明している12か月間のデータから推計したものです。