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

オーガニックキーワード

API + MCP
GET/v3/site-explorer/organic-keywords

クエリパラメータ

timeoutinteger

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

limitinteger

返す結果数です。

デフォルト:1000
order_bystring

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

Example:field_a,field_b:asc,field_c:desc
wherestring

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

selectstring必須

返却する列のカンマ区切りリスト。有効な列識別子については、レスポンススキーマを参照してください。

protocolstring

ターゲットのプロトコル。

許可される値:bothhttphttps
デフォルト:both
targetstring (url)必須

検索対象:ドメインまたはURL。

modestring

入力したターゲットに基づく検索範囲。

許可される値:exactprefixdomainsubdomains
デフォルト:subdomains
countrystring

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

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

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

datestring (date)必須

メトリクスのレポート対象日(YYYY-MM-DD形式)。

volume_modestring

検索ボリュームの計算モード:monthly または average。ボリューム、トラフィック、およびトラフィック値に影響します。

許可される値:monthlyaverage
デフォルト:monthly
outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

keywordsarray<object>
all_positionsarray<object>

(5 units) キーワードの全順位リスト。

all_positions_prevarray<object>

(5件)比較日における、キーワードの全順位のリスト。

best_positioninteger or null

ターゲットがキーワードのオーガニック検索結果で獲得している上位順位。

best_position_diffinteger or null

選択した期間での順位の変化。

best_position_has_thumbnailboolean or null

最上位の順位にはサムネイルがあります。

best_position_has_thumbnail_prevboolean or null

比較日時点の最上位の順位にはサムネイルがあります。

best_position_has_videoboolean or null

最上位の順位には動画があります。

best_position_has_video_prevboolean or null

比較日時点の最上位の順位には動画があります。

best_position_kindstring or null

最上位順位の種類(オーガニック、広告、または SERP の機能)。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

並べ替え用に最適化された最上位順位の種類。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

比較日時点の最上位順位の種類。

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

比較日時点の最上位の順位。

best_position_setstring

最上位順位のランキンググループ。

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

比較日時点の最上位順位のランキンググループ。

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

オーガニック検索結果における上位ランキングの URL。

best_position_url_prevstring (url) or null

比較日における順位付けURL。

cpcinteger or null

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

cpc_mergedinteger or null

並べ替え用に最適化されたCPCフィールド。

cpc_previnteger or null

比較日のCPC指標。

entitiesarray<object>

キーワードに含まれる組織、製品、人名、作品名、イベント、場所。

is_best_position_set_top_11_50boolean

トップ順位のランキンググループは11〜50です。

is_best_position_set_top_11_50_prevboolean or null

比較日では、トップ順位のランキンググループは11〜50でした。

is_best_position_set_top_3boolean

トップ順位のランキンググループがトップ3です。

is_best_position_set_top_3_prevboolean or null

比較日では、トップ順位のランキンググループはトップ3でした。

is_best_position_set_top_4_10boolean

トップ順位のランキンググループは4〜10です。

is_best_position_set_top_4_10_prevboolean or null

比較日では、トップ順位のランキンググループは4〜10でした。

is_brandedboolean

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

is_commercialboolean

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

is_informationalboolean

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

is_localboolean

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

is_navigationalboolean

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

is_transactionalboolean

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

keywordstring or null

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

keyword_countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_difficultyinteger or null

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

keyword_difficulty_mergedinteger or null

(10 単位) 並べ替え用に最適化されたキーワード難易度フィールド。

keyword_difficulty_previnteger or null

(10 単位) 比較日付時点のキーワード難易度。

keyword_languagearray<string>

検索クエリの言語。

keyword_mergedstring

並べ替え用に最適化されたキーワードフィールド。

keyword_prevstring or null

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

languagestring

SERP の言語。

language_prevstring or null

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

last_updatestring (date-time)

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

last_update_prevstring (date-time) 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_countinteger

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

serp_features_count_previnteger or null

比較日の SERP の機能の数。

serp_features_mergedarray<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_target_main_positions_countinteger

Sitelinks、Top stories、Image packs、X(Twitter)での投稿の順位を除いた、キーワードでランクインしているターゲット URL 数。

serp_target_main_positions_count_previnteger or null

比較日において、Sitelinks、Top stories、Image packs、X(Twitter)での投稿の順位を除いた、キーワードでランクインしているターゲット URL 数。

serp_target_positions_countinteger

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

serp_target_positions_count_previnteger or null

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

statusstring

ページのステータス:新たにランクインし始めたページ(「left」)、検索結果から消えたページ(「right」)、または変更なし(「both」)。

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10単位)あるキーワードの有料検索からターゲットが獲得する月間訪問数の推定値。

sum_paid_traffic_mergedinteger

(10単位)ソート用に最適化された有料トラフィックのフィールド。

sum_paid_traffic_previnteger or null

(10 units) 比較日における有料トラフィック。

sum_trafficinteger or null

(10 units) あるキーワードのオーガニック検索からターゲットが獲得した月間アクセス数の推定値。

sum_traffic_mergedinteger

(10 units) 並べ替え用に最適化されたトラフィックフィールド。

sum_traffic_previnteger or null

(10 units) 比較日におけるトラフィック。

volumeinteger or null

(10 units) 直近 1 か月間におけるキーワード検索回数の推定値。

volume_desktop_pctnumber (float) or null

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

volume_mergedinteger or null

(10 units) 並べ替え用に最適化された検索ボリュームフィールド。

volume_mobile_pctnumber (float) or null

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

volume_previnteger or null

(10 units) 比較日における検索ボリューム。

wordsinteger or null

キーワードの単語数。

words_mergedinteger

並べ替え用に最適化されたキーワードの単語数。

words_previnteger or null

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