概要

API + MCP

GET/v3/rank-tracker/overview

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

クエリパラメータ

timeoutinteger

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

limitinteger

返す結果数です。

デフォルト:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

best_position_has_thumbnail: 最上位の順位（または設定されている場合はターゲットURL）にサムネイルがあります。
type: boolean nullable

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

best_position_has_video_preview: 最上位の順位（または設定されている場合はターゲットURL）に動画プレビューがあります。
type: boolean nullable

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

best_position_kind: 最上位の順位（または設定されている場合はターゲットURL）の種類：オーガニック、広告、または SERP の機能。
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

best_position_kind_previous: 比較日における、最上位の順位（または設定されている場合はターゲットURL）の種類。
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

clicks: クリック指標は、ターゲットキーワードを検索する際にユーザーが検索結果で行うクリックの、月間平均回数を指します。複数の結果がクリックされる検索もあれば、まったくクリックされない検索もあります。
type: integer nullable

clicks_per_search: 検索あたりのクリック数（CPS）は、クリックをキーワードの検索ボリュームで割った比率です。指定した国でユーザーがターゲットキーワードを検索したとき、平均していくつの異なる検索結果がクリックされるかを示します。
type: float nullable

cost_per_click: クリック単価（CPC）は、広告主がキーワードの有料検索結果において広告クリック1回あたりに支払う平均価格を示します。
type: integer nullable

country: あるキーワードが追跡されている国。2文字の国コード（ISO 3166-1 alpha-2）。
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

country_prev: 比較日において、あるキーワードが追跡されている国。2文字の国コード（ISO 3166-1 alpha-2）。
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

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

is_branded: ユーザー意図：指名（branded）。特定のブランド名または企業名を検索しています。
type: boolean

is_commercial: ユーザー意図：商業（commercial）。購入を決める前に、商品やサービスを比較しています。
type: boolean

is_informational: ユーザー意図：情報（informational）。情報の取得や、特定の質問への答えを探しています。
type: boolean

is_local: ユーザー意図：ローカル（local）。特定の場所に関連する情報や、近くのサービスを探しています。
type: boolean

is_main_position: AIによる概要、サイトリンク、トップニュース、画像パック、動画、ディスカッションとフォーラム、X（Twitter）の投稿の順位を除外します。
type: boolean

is_main_position_prev: 比較日において、AIによる概要、サイトリンク、トップニュース、画像パック、動画、ディスカッションとフォーラム、X（Twitter）の投稿の順位を除外します。
type: boolean

is_navigational: ユーザー意図：ナビゲーション（navigational）。特定のWebサイトやWebページを探しています。
type: boolean

is_transactional: ユーザー意図：トランザクション（transactional）。多くの場合は購入など、何らかのアクションを実行する準備ができています。
type: boolean

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

keyword_difficulty: キーワードでオーガニック検索結果のトップ10に入る難易度の推定値（100点満点）。
type: integer nullable

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

keyword_is_frozen: キーワードがプランの追跡キーワード上限を超えているかどうかを示します。該当キーワードは「凍結」され、ランキングは更新されません。
type: boolean

keyword_prev: 比較日においてターゲットがランクインしているキーワード。
type: string

keyword_words: キーワードの単語数。
type: integer

keyword_words_prev: 比較日におけるキーワードの単語数。
type: integer

language: あるキーワードで追跡されている SERP 言語。
type: string

language_prev: 比較日における SERP 言語。
type: string

location: あるキーワードが追跡されている場所（国、州/県、または都市）。
type: string

location_prev: 比較日において、あるキーワードが追跡されている場所（国、州/県、または都市）。
type: string

parent_topic: 親トピックは、ページ上でより一般的なトピックを対象にした場合でも、ターゲットキーワードでランクイン可能かどうかを判断する指標です。親トピックの特定では、対象キーワードで1位のページを取得し、そのページに最も多くのトラフィックを送っているキーワードを見つけます。
type: string nullable

position: オーガニック検索における最上位の順位（または設定されている場合はターゲットURL）。
type: integer nullable

position_diff: 選択した日付間における最上位の順位（または設定されている場合はターゲットURL）の変化。
type: integer nullable

position_prev: 比較日における最上位の順位（または設定されている場合はターゲットURL）。
type: integer nullable

search_type_image: 検索タイプ Image は、キーワードの検索のうち画像検索の割合を示し、ビジュアルコンテンツへの関心を可視化します。
type: float nullable

search_type_news: 検索タイプ News は、キーワードの検索のうちニュース記事の割合を示します。
type: float nullable

search_type_video: 検索タイプ Video は、キーワードの検索のうち動画検索の割合を示し、動画コンテンツへの関心を反映します。
type: float nullable

search_type_web: 検索タイプ Web は、キーワードの検索のうち一般的なWebコンテンツの割合を示し、幅広い情報への関心を示します。
type: float nullable

serp_features: キーワードの検索結果に表示される SERP の機能。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_prev: 比較日において、キーワードの検索結果に表示される SERP の機能。
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_updated: キーワードの検索エンジン結果を最後に確認した日付。
type: datetime nullable

serp_updated_prev: 比較日までに検索エンジン結果を確認した日付。
type: datetime nullable

tags: あるキーワードに割り当てられたタグの一覧。
type: array(string)

tags_prev: 比較日において、あるキーワードに割り当てられたタグの一覧。
type: array(string)

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

traffic: 「volume_mode」パラメータに応じて、直近1か月または直近で判明している12か月のデータに基づく、オーガニック検索からページが獲得する月間訪問数の推定値。
type: integer nullable

traffic_diff: 選択した日付間のトラフィックの変化。
type: integer nullable

traffic_prev: 「volume_mode」パラメータに応じて、直近1か月または直近で判明している12か月のデータに基づく、オーガニック検索からページが獲得する月間訪問数の推定値。
type: integer nullable

url: オーガニック検索における最上位のURL（または設定されている場合はターゲットURL）。
type: string nullable

url_prev: 比較日における最上位のURL（または設定されている場合はターゲットURL）。
type: string nullable

volume: 「volume_mode」パラメータに応じて、直近1か月または直近で判明している12か月のデータに基づく、キーワードの月間平均検索数（検索ボリューム）の推定値。
type: integer nullable

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

volume_mobile_pct: 総検索ボリュームのうちモバイル端末からの割合。
type: float nullable

selectstring必須

返すカラムのカンマ区切りリストです。有効なカラム識別子はレスポンスのスキーマを参照してください。

date_comparedstring

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

datestring必須

レポートする指標の日付（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）。

clicksinteger or null

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

clicks_per_searchnumber 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）。

created_atstring

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

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 or null

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

search_type_newsnumber or null

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

search_type_videonumber or null

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

search_type_webnumber or null

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

serp_featuresarray<string>

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

serp_features_prevarray<string>

比較日における、キーワードの検索結果に表示される SERP の機能。

serp_updatedstring or null

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

serp_updated_prevstring 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

urlstring or null

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

url_prevstring or null

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

volumeinteger or null

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

volume_desktop_pctnumber or null

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

volume_mobile_pctnumber or null

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