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

検索候補(サジェスト)

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

クエリパラメータ

timeoutinteger

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

limitinteger

返される結果の数。最大: 150000

デフォルト:1000
order_bystring

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

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

フィルター式です。以下の列識別子を使用できます(select パラメータで使用できる識別子とは異なります)。

selectstring必須

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

countrystring必須

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

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordsstring

指標を表示するキーワードをカンマ区切りで指定します。

keyword_list_idinteger

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

outputstring

出力形式。

許可される値:jsonphpxml

応答

keywordsarray<object>
cpcinteger or null

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

cpsnumber (float) or null

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

difficultyinteger or null

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

first_seenstring (date-time) 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 (date-time) or null

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

traffic_potentialinteger or null

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

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

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

volume_mobile_pctnumber (float) or null

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

volume_monthlyinteger or null

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