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

検索候補(サジェスト)

API + MCP
GET/v3/keywords-explorer/search-suggestions

クエリパラメータ

timeoutinteger

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

limitinteger

返す結果数です。

デフォルト:1000
order_bystring

結果の並び替えに使用する列。使用可能な列IDはレスポンスのスキーマを参照してください。ただし、このエンドポイントでは order_byvolume_monthly はサポートされません。

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

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

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

cps: 検索あたりのクリック数(CPS)は、検索ボリュームに対するクリックの割合です。これは、ある国で対象キーワードが検索された際に、平均して何件の異なる検索結果がクリックされたかを示します。
type: float nullable

difficulty (10 units): 100点満点の指標で、キーワードのオーガニック検索結果上位10件にランクインする難易度の推定値。
type: integer nullable

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

global_volume (10 units): 当社データベース内のすべての国における、対象キーワードの月間平均検索回数。
type: integer nullable

intents (10 units): ユーザーの検索クエリの意図を示します。オブジェクトのフィールド:informationalnavigationalcommercialtransactionalbrandedlocal。すべてのフィールドの型は bool で、値は true または false です。
type: object nullable

keyword:
type: string

parent_topic: 親トピックは、より一般的なトピックをページで狙いながら、対象キーワードでもランクインできるかどうかを示します。親トピックを特定するために、対象キーワードで1位のページを取り、そのページに最も多くのトラフィックを送っているキーワードを抽出します。
type: string nullable

serp_domain_rating_top10_min: DR がこの値以下のサイトでも、上位10件に少なくとも1つ順位がある必要があります。
type: float nullable

serp_domain_rating_top5_min: DR がこの値以下のサイトでも、上位5件に少なくとも1つ順位がある必要があります。
type: float nullable

serp_features: 検索結果ページ(SERP)に表示される、通常のオーガニック結果以外の強調表示(SERP機能)。
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"

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

traffic_potential (10 units): 対象キーワードで1位のページが、ランクインしているすべてのキーワードから獲得しているオーガニックトラフィックの合計。
type: integer nullable

volume (10 units): 最新の既知データ(直近12か月)に基づく、キーワードの月間平均検索数の推定値。
type: integer nullable

volume_desktop_pct: デスクトップ端末で行われたキーワード検索の割合。
type: float nullable

volume_mobile_pct: モバイル端末で行われたキーワード検索の割合。
type: float nullable

word_count:
type: integer

selectstring必須

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

countrystring必須

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

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
search_enginestring

[2024年8月5日付で非推奨]。

許可される値:google
デフォルト:google
keywordsstring

指標を表示するキーワードのカンマ区切りリスト。

keyword_list_idinteger

指標を表示する既存のキーワードリストのID。

outputstring

出力形式。

許可される値:jsoncsvxmlphp

応答

keywordsarray<object>
cpcinteger or null

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

cpsnumber or null

検索あたりのクリック数(CPS)は、検索ボリュームに対するクリックの割合です。これは、ある国で対象キーワードが検索された際に、平均して何件の異なる検索結果がクリックされたかを示します。

difficultyinteger or null

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

first_seenstring or null

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

global_volumeinteger or null

(10 units)当社データベース内のすべての国において、対象キーワードが月に平均何回検索されているかを示します。

intentsobject or null

(10 units) ユーザーの検索クエリの背後にある目的を示します。オブジェクトのフィールド: informationalnavigationalcommercialtransactionalbranded または local。すべてのフィールドは bool 型で、取り得る値は true または false です。

keywordstring
parent_topicstring or null

親トピックは、ページでより一般的なトピックをターゲットにしながら、ターゲットキーワードでランクインできるかどうかを判断します。親トピックを特定するには、キーワードのランキング1位のページを取り上げ、そのページに最も多くのトラフィックを送っているキーワードを見つけます。

serp_featuresarray<string>

検索エンジンの結果ページ(SERP)で表示される、従来のオーガニック結果ではない、より充実した結果のことです。

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping
serp_last_updatestring or null

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

traffic_potentialinteger or null

(10 units) ターゲットキーワードでランキング 1 位のページが、ランクインしているすべてのキーワードから獲得しているオーガニックトラフィックの合計。

volumeinteger or null

(10 units) キーワードの月間平均検索回数を、直近の判明している 12 か月間のデータから推計したものです。

volume_desktop_pctnumber or null

キーワードの検索のうち、デスクトップデバイスで行われた割合。

volume_mobile_pctnumber or null

キーワードの検索のうち、モバイルデバイスで行われた割合。

volume_monthlyinteger or null

(10 units) 直近1か月間におけるキーワード検索回数の推定値。このフィールドは order_by パラメータに含められない場合があります。