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

国別ボリューム

API + MCP
GET/v3/keywords-explorer/volume-by-country

クエリパラメータ

selectstring

返すフィールドをカンマ区切りで指定します。

order_bystring

結果を並び替えるフィールド（任意で方向も指定可）。形式: field_name:asc または field_name:desc（デフォルトは desc）。

利用可能なフィールド:
  • cpc
  • difficulty（10 units）
  • growth_rate_12m
  • traffic_potential（10 units）
  • volume（10 units）
limitinteger

返す結果の数です。

offsetinteger

スキップする結果の件数。

デフォルト:0
keyword_list_idinteger

既存のキーワードリストのID。

keywordstring

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

countriesstring

2文字の国コード（ISO 3166-1 alpha-2）のカンマ区切りリスト。

許可される値:adaeafagaialamaoarasatauawazba…
volume_monthly_date_fromstring (date)

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

volume_monthly_date_tostring (date)

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

outputstring

出力形式。

許可される値:jsonphp

応答

countriesarray<object>
countrystring

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

cpcinteger or null

top_keyword のクリック単価（CPC）（USセント）。

difficultyinteger or null

（10 units）top_keyword のキーワード難易度。

growth_rate_12mnumber (float) or null

12か月間の検索ボリューム成長率。単一キーワードのシードで利用できます。

has_serpboolean or null

top_keyword のSERPデータが利用可能かどうか。

top_keywordstring or null

この国で検索ボリュームが最も高いシードキーワード。

top_pagestring or null

top_keyword の上位オーガニックページ。

top_page_titlestring or null

top_page のタイトル。

traffic_potentialinteger or null

（10 units）top_keyword のトラフィックポテンシャル。

volumeinteger

(10 units) 特定の国におけるキーワードの月間平均検索回数の推定値。

volume_monthly_historyarray<object>

（50 units）この国における、シードキーワードの月間検索ボリュームの合計。

datestring (date)
volumeinteger