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

概要

API + MCP
GET/v3/rank-tracker/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

出力形式。

許可される値:jsoncsvxmlphp

応答

overviewsarray<object>
best_position_has_thumbnailboolean or null

最上位の順位(または設定されている場合はターゲットURL)にサムネイルがあります。

best_position_has_thumbnail_previousboolean or null

比較日に、最上位の順位(または設定されている場合はターゲットURL)にサムネイルがあります。

best_position_has_video_previewboolean or null

最上位の順位(または設定されている場合はターゲットURL)に動画プレビューがあります。

best_position_has_video_preview_previousboolean or null

比較日に、最上位の順位(または設定されている場合はターゲットURL)に動画プレビューがあります。

best_position_kindstring or null

最上位の順位(または設定されている場合はターゲットURL)の種類:オーガニック、広告、または SERP の機能。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_previousstring or null

比較日付時点での最上位の種類(または設定されている場合はターゲット URL)。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

クリック数とは、対象キーワードを検索した際に表示される検索結果の平均クリック数を指します。検索によっては複数の結果にクリックが発生する場合もありますが、発生しない場合もあります。

clicks_per_searchnumber (float) or null

検索あたりのクリック数( CPS )は、キーワード検索数に対するクリックの割合です。これは、ある国でターゲットキーワードが検索された際に、平均何件の異なる検索結果がクリックされたかを示しています。

cost_per_clickinteger or null

クリック単価は、キーワードの有料検索結果で広告がクリックされるごとに広告主が支払う平均価格を示します。

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

キーワードがプロジェクトに追加された日付。

is_brandedboolean

ユーザーの検索意図:ブランド検索型。ユーザーは特定のブランドや企業名を検索しています。

is_commercialboolean

ユーザーの検索意図:商業調査型。ユーザーは購入を決定する前に製品やサービスを比較しています。

is_informationalboolean

ユーザーの意図:情報収集型。ユーザーは情報や特定の質問に対する答えを探しています。

is_localboolean

ユーザーの意図:ローカル型。ユーザーは特定の場所や近隣のサービスに関連する情報を探しています。

is_navigationalboolean

ユーザーの意図:案内型。ユーザーは特定のウェブサイトやページを検索しています。

is_transactionalboolean

ユーザーの意図:取引型。ユーザーは購入などの行動を完了する準備ができています。

keywordstring

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

keyword_difficultyinteger or null

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

keyword_has_databoolean

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

keyword_is_frozenboolean

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

keyword_prevstring

比較日付時点でターゲットがランクインしているキーワード。

languagestring

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

language_prevstring

比較日付時点の SERP の言語。

locationstring

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

location_prevstring

比較日付時点で特定のキーワードが追跡されている場所(国、州/県、都市)。

parent_topicstring or null

親トピックは、ページではより一般的なトピックをターゲットにしながら、ターゲットキーワードでランクインできるかどうかを判断します。 親トピックを決めるには、キーワードのランキング 1 位のページを取り上げ、そのページに最も多くトラフィックを送っているキーワードを見つけます。

positioninteger or null

オーガニック検索における最上位の順位(または設定されている場合はターゲット URL)。

position_diffinteger or null

選択した日付間での最上位の順位(または設定されている場合はターゲット URL)の変化。

position_previnteger or null

比較日付時点での最上位の順位(または設定されている場合はターゲット URL)。

search_type_imagenumber (float) or null

画像検索は、キーワードの検索に占める画像の割合を示し、ビジュアルコンテンツへの関心の高さを示します。

search_type_newsnumber (float) or null

検索タイプ「ニュース」は、ニュース記事に対して行われたキーワードの検索の割合を示します。

search_type_videonumber (float) or null

動画検索タイプは、キーワードに対しての動画検索の割合を示しています。動画コンテンツへの関心を強調します。

search_type_webnumber (float) or null

検索タイプ「ウェブ」は、一般的なウェブコンテンツを対象としたキーワードの検索割合を示し、幅広い情報への関心を示しています。

serp_featuresarray<string>

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<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>

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

tags_prevarray<string>

比較する日付において、特定のキーワードに割り当てられていたタグの一覧。

target_positions_countinteger

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

trafficinteger or null

ページが直近1か月、または「volume_mode」パラメータに応じて直近の判明している12か月間のデータにおいて、オーガニック検索から獲得した月間訪問数の推計値。

traffic_diffinteger or null

選択された期間におけるトラフィック値の変化。

traffic_previnteger or null

ページが直近1か月、または「volume_mode」パラメータに応じて直近の判明している12か月間のデータにおいて、オーガニック検索から獲得した月間訪問数の推計値。

urlstring (url) or null

オーガニック検索における最上位のURL(設定されている場合はターゲットURL)。

url_prevstring (url) or null

比較する日付における最上位のURL(設定されている場合はターゲットURL)。

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

総検索ボリュームのうち、デスクトップ端末からの割合。

volume_mobile_pctnumber (float) or null

総検索ボリュームのうち、モバイル端末からの割合。