オーガニックキーワード

API + MCP

GET/v3/site-explorer/organic-keywords

クエリパラメータ

timeoutinteger

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

limitinteger

返す結果数です。

デフォルト:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

best_position: キーワードのオーガニック検索結果における、ターゲットの最上位順位。
type: integer nullable

best_position_diff: 選択した日付間での順位の変化。
type: integer nullable

best_position_has_thumbnail: 最上位順位にサムネイルが表示されている。
type: boolean nullable

best_position_has_thumbnail_prev: 比較日の最上位順位にサムネイルが表示されている。
type: boolean nullable

best_position_has_video: 最上位順位に動画が表示されている。
type: boolean nullable

best_position_has_video_prev: 比較日の最上位順位に動画が表示されている。
type: boolean nullable

best_position_kind: 最上位順位の種類（オーガニック、広告、または 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_merged: 並び替えに最適化した最上位順位の種類。
type: 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"

best_position_kind_prev: 比較日における最上位順位の種類。
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_prev: 比較日における最上位順位。
type: integer nullable

best_position_set: 最上位順位のランキンググループ。
type: string
enum: "top_3" "top_4_10" "top_11_50" "top_51_more"

best_position_set_prev: 比較日における最上位順位のランキンググループ。
type: string nullable
enum: "top_3" "top_4_10" "top_11_50" "top_51_more"

best_position_url: オーガニック検索結果でのランクイン URL。
type: string nullable

best_position_url_prev: 比較日におけるランクイン URL。
type: string nullable

best_position_url_raw: エンコード形式のランクインページ URL。
type: string nullable

best_position_url_raw_prev: 比較日における、エンコード形式のランクインページ URL。
type: string nullable

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

cpc_merged: 並び替えに最適化した CPC フィールド。
type: integer nullable

cpc_prev: 比較日における CPC 指標。
type: integer nullable

entities: キーワード内で見つかった組織、製品、人物、作品、イベント、場所。
type: array(object)

event_entities: キーワード内で見つかったイベント。
type: array(string)

is_best_position_set_top_11_50: 最上位順位のランキンググループが 11〜50 位。
type: boolean

is_best_position_set_top_11_50_prev: 比較日における最上位順位のランキンググループが 11〜50 位。
type: boolean nullable

is_best_position_set_top_3: 最上位順位のランキンググループがトップ 3。
type: boolean

is_best_position_set_top_3_prev: 比較日における最上位順位のランキンググループがトップ 3。
type: boolean nullable

is_best_position_set_top_4_10: 最上位順位のランキンググループが 4〜10 位。
type: boolean

is_best_position_set_top_4_10_prev: 比較日における最上位順位のランキンググループが 4〜10 位。
type: boolean nullable

is_branded: ユーザー意図: 指名。特定のブランド名や会社名を探している。
type: boolean

is_commercial: ユーザー意図: 商用。購入前に製品・サービスを比較している。
type: boolean

is_informational: ユーザー意図: 情報収集。特定の質問への回答や情報を探している。
type: boolean

is_local: ユーザー意図: ローカル。特定の地域や近隣サービスに関する情報を探している。
type: boolean

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

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

is_navigational: ユーザー意図: ナビゲーショナル。特定の Web サイトや Web ページを探している。
type: boolean

is_transactional: ユーザー意図: トランザクショナル。購入などのアクションを実行する準備ができている。
type: boolean

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

keyword_country: ターゲットがランクインしているキーワードの国。
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"

keyword_difficulty (10 units): キーワードでオーガニック検索結果トップ 10 にランクインする難易度の推定値（100 点スケール）。
type: integer nullable

keyword_difficulty_merged (10 units): 並び替えに最適化したキーワード難易度フィールド。
type: integer nullable

keyword_difficulty_prev (10 units): 比較日におけるキーワード難易度。
type: integer nullable

keyword_language: 検索クエリの言語
type: array(string)

keyword_merged: 並び替えに最適化したキーワードフィールド。
type: string

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

language: SERP の言語。
type: string

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

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

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

location_entities: キーワード内で見つかった場所。
type: array(string)

organisation_entities: キーワード内で見つかった組織。
type: array(string)

person_entities: キーワード内で見つかった人物。
type: array(string)

position_kind: 順位の種類（オーガニック、広告、または SERP の機能）。特定のキーワードと URL について最上位順位を選ぶ前の、すべての順位に適用されます。
type: 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"

position_kind_prev: 比較日における順位の種類。
type: 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"

positions_kinds: 最上位順位の種類。
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"

positions_kinds_prev: 比較日における最上位順位の種類。
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"

product_entities: キーワード内で見つかった製品。
type: array(string)

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_count: キーワードの検索結果に表示される SERP の機能の数。
type: integer

serp_features_count_prev: 比較日における SERP の機能の数。
type: integer nullable

serp_features_merged: 並び替えに最適化した 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_target_main_positions_count: サイトリンク、トップニュース、画像パック、X（Twitter）上の投稿の順位を除外した、キーワードでランクインしているターゲット URL の数。
type: integer

serp_target_main_positions_count_prev: 比較日において、サイトリンク、トップニュース、画像パック、X（Twitter）上の投稿の順位を除外した、キーワードでランクインしているターゲット URL の数。
type: integer nullable

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

serp_target_positions_count_prev: 比較日における、キーワードでランクインしているターゲット URL の数。
type: integer nullable

status: ページのステータス（新たにランクインし始めたページ: "left"／検索結果から消えたページ: "right"／変化なし: "both"）。
type: string
enum: "left" "right" "both"

sum_paid_traffic (10 units): キーワードの有料検索からターゲットが獲得している推定月間訪問数。
type: integer nullable

sum_paid_traffic_merged (10 units): 並び替えに最適化した有料トラフィックフィールド。
type: integer

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

sum_traffic (10 units): キーワードのオーガニック検索からターゲットが獲得している推定月間訪問者数。
type: integer nullable

sum_traffic_merged (10 units): 並び替えに最適化したトラフィックフィールド。
type: integer

sum_traffic_prev (10 units): 比較日におけるトラフィック。
type: integer nullable

title: キーワードの SERP でページに表示されるタイトル。
type: string

title_prev: 比較日における、キーワードの SERP でページに表示されるタイトル。
type: string

volume (10 units): 直近 1 か月のキーワード検索回数の推定値。
type: integer nullable

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

volume_merged (10 units): 並び替えに最適化した検索ボリュームフィールド。
type: integer nullable

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

volume_prev (10 units): 比較日における検索ボリューム。
type: integer nullable

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

words_merged: 並び替えに最適化したキーワードの単語数。
type: integer

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

work_entities: キーワード内で見つかった作品。
type: array(string)

selectstring必須

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

protocolstring

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

許可される値:bothhttphttps

デフォルト:both

targetstring必須

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

modestring

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

許可される値:exactprefixdomainsubdomains

デフォルト:subdomains

countrystring

2文字の国コード（ISO 3166-1 alpha-2）。

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring

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

datestring必須

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

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

best_position_kind_prevstring or null

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

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

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

best_position_url_prevstring 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

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

last_update_prevstring or null

比較日までの検索エンジン結果を確認した日付。

serp_featuresarray<string>

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

serp_features_countinteger

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

serp_features_count_previnteger or null

比較日の SERP の機能の数。

serp_features_mergedarray<string>

ソート用に最適化された SERP の機能フィールド。

serp_features_prevarray<string>

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

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

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

volume_mergedinteger or null

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

volume_mobile_pctnumber or null

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

volume_previnteger or null

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

wordsinteger or null

キーワードの単語数。

words_mergedinteger

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

words_previnteger or null

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