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

SERP の概要

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

クエリパラメータ

selectstring必須

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

top_positionsinteger

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

datestring

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

countrystring必須

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

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordstring必須

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

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

positionsarray<object>
ahrefs_rankinteger or null

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

backlinksinteger or null

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

domain_ratingnumber or null

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

keywordsinteger or null

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

page_typestring or null

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

positioninteger

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

refdomainsinteger or null

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

titlestring or null

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

top_keywordstring or null

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

top_keyword_volumeinteger or null

(10 units) 直近の判明している 12 か月間のデータに基づく、上位キーワードの月平均検索回数の推定値。

trafficinteger or null

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

typearray<string>

ポジションの種類:オーガニック、有料、または SERP の機能。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
update_datestring

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

urlstring or null

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

url_ratingnumber or null

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

valueinteger or null

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