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

SERP の概要

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

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

クエリパラメータ

top_positionsinteger

返すオーガニック SERP の上位順位数。指定しない場合は、利用可能な順位がすべて返されます。

devicestring必須

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

許可される値:desktopmobile
datestring

最後に利用可能な SERP の概要を返すためのタイムスタンプ(YYYY-MM-DDThh:mm:ss 形式)。指定しない場合は、最新の SERP の概要が返されます。

location_idinteger

追跡対象キーワードのロケーションID。management/project-keywords エンドポイントを使用すると、追跡対象キーワードの国コード、言語コード、ロケーションIDを取得できます。

countrystring必須

2文字の国コード(ISO 3166-1 alpha-2)。

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

追跡対象キーワードの言語コード。management/project-keywords エンドポイントを使用すると、追跡対象キーワードの国コード、言語コード、ロケーションIDを取得できます。

keywordstring必須

SERP の概要を返す対象キーワード。

project_idinteger必須

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

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

positionsarray<object>
ahrefs_rankinteger or null

データベースに登録されている他のウェブサイトと比較したドメインの被リンクプロファイルの強さで、ランク 1 が最も強いことを意味します。

backlinksinteger or null

検索結果を指している他のウェブサイトからのリンクの総数。

domain_ratingnumber or null

当社データベース内の他のドメインと比較した、ドメインの被リンクプロファイルの強さを 100 点満点で示します。

keywordsinteger or null

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

nr_wordsinteger or null

ウェブページの HTML に含まれる単語の総数。

page_typestring or null

ランキング対象ページの、AI が予測した階層型ページタイプパスのカンマ区切りリスト。各値はスラッシュで始まるパスです(例:/Article/How_to)。

positioninteger

SERPにおける検索結果の順位。

refdomainsinteger or null

検索結果にリンクしているユニークドメインの総数。

titlestring or null

ランクインしているページのタイトル。

top_keywordstring or null

検索結果に最もオーガニック流入をもたらすキーワード。

top_keyword_volumeinteger or null

上位キーワードの直近の判明している 12 か月間のデータの中から、月平均の検索回数を推定したもの。

trafficinteger or null

その結果がランクインしているすべてのキーワードから得られる、月間オーガニック検索トラフィックの推定値。

typearray<string>

順位の種類:オーガニック、広告、または SERP の機能。許可される値:ai_overviewai_overview_sitelinkdiscussionimageimage_thknowledge_cardknowledge_panellocal_packorganicorganic_shoppingpaid_toppaid_bottompaid_rightquestionsitelinksnippettop_storytweetvideovideo_th

update_datestring

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

urlstring or null

ランクインしているページのURL。

url_ratingnumber or null

ページの被リンクプロファイルの強さを 100 点満点の対数スケールで示します。

valueinteger or null

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