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

概要

API + MCP
GET/v3/keywords-explorer/overview

このリクエストで regex フィルターを使用する場合、機能は限定的で、構文も他のリクエストとは異なります。ワイルドカードとしてアスタリスク(*)記号を使用します。

クエリパラメータ

timeoutinteger

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

limitinteger

返す結果数です。

デフォルト:1000
order_bystring

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

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

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

selectstring必須

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

volume_monthly_date_tostring (date)

volume_monthly_history フィールドで過去の月別検索ボリュームを取得するための終了日(YYYY-MM-DD形式)。volume_monthly_history をリクエストした場合にのみ必須です。

volume_monthly_date_fromstring (date)

volume_monthly_history フィールドで過去の月別検索ボリュームを取得するための開始日(YYYY-MM-DD形式)。volume_monthly_history をリクエストした場合にのみ必須です。

target_modestring

指定したターゲットURLのスコープ。

許可される値:exactprefixdomainsubdomains
targetstring (url)

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

target_positionstring

指定した target の順位に基づいてキーワードをフィルタリングします。

許可される値:in_top10in_top100
countrystring必須

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

許可される値:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordsstring

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

keyword_list_idinteger

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

outputstring

The output format.

許可される値:jsonphpxml

応答

keywordsarray<object>
clicksinteger or null

対象キーワードで検索したときの検索結果に対する、月間平均クリック数。

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位のページを取り上げ、そのページに最も多くのトラフィックを送っているキーワードを見つけます。

parent_volumeinteger or null

(10 units) 親トピックの検索ボリューム。

searches_pct_clicks_organic_and_paidnumber (float) or null

ターゲットキーワードを検索した人のうち、オーガニック結果と有料結果の両方をクリックした人の月間平均割合。

searches_pct_clicks_organic_onlynumber (float) or null

ターゲットキーワードを検索した人のうち、オーガニック結果のみをクリックした人の月間平均割合。

searches_pct_clicks_paid_onlynumber (float) or null

ターゲットキーワードを検索した人のうち、有料結果のみをクリックした人の月間平均割合。

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 パラメータに含められない場合があります。

volume_monthly_historyarray<object>

(2 units per historical month, with a minimum of 50 units) volume_monthly_date_from および volume_monthly_date_to パラメータで設定した期間における、キーワードの過去の月間検索ボリューム推定値。