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

SERP の概要

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

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

クエリパラメータ

project_idinteger必須

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

keywordstring必須

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

language_codestring

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

countrystring必須

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

許可される値:adaeafagaialamaoarasatauawazba…
location_idinteger

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

datestring (date-time)

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

devicestring必須

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

許可される値:desktopmobile
top_positionsinteger

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

outputstring

出力形式。

許可される値:jsonphpxml

応答

positionsarray<object>
ahrefs_rankinteger or null

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

backlinksinteger or null

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

domain_ratingnumber (float) 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_overview、ai_overview_sitelink、discussion、image、image_th、knowledge_card、knowledge_panel、local_pack、organic、organic_shopping、paid_top、paid_bottom、paid_right、question、sitelink、snippet、top_story、tweet、video、video_th。

update_datestring (date)

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

urlstring (url) or null

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

url_ratingnumber (float) or null

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

valueinteger or null

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