キーワード検索ボリューム API (KEYWORD_VOLUME)

KEYWORD_VOLUME は、キーワードごとに直近12か月の平均月間検索数、12か月分の月別の値、広告の競合度を返します。1タスクにつき1つの国です。


`taskType`	`KEYWORD_VOLUME`
入力	`keywords`(1〜100件、必須)、`country`(必須)
クレジット	タスクあたり3、キーワード数に関係なく
国	必須。対応国のみ。下記を参照してください。
位置	非対応(`422 LOCATION_UNSUPPORTED`)。

リクエスト

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "KEYWORD_VOLUME", "payload": { "keywords": ["sunscreen", "mineral sunscreen"], "country": "US" } }'

パラメータ

フィールド	必須	説明
`keywords`	はい	1〜100件のキーワードの配列。空白をまとめた後でそれぞれ1〜80文字。`KR` では文字、数字、スペースのみを含められます。
`country`	はい	2文字の国コード。データソースもこれで決まります。

データソースと国

国	ソース(`source`)	数える対象
`KR`	Naver(`naver`)	Naver での検索。
その他の対応国	Google キーワードプランナー(`google_ads`)	その国で行われたすべての Google 検索(言語を問わず)。

対応国は KR と Google 広告のターゲット国ですが、例外が2つあります。CN と RU は、検索の大半を Baidu と Yandex が担っているため 422 REGION_UNSUPPORTED を返します。ソースのない国も同じエラーを返します。正確な一覧は GET /v1/capabilities?taskType=KEYWORD_VOLUME を呼び出し、countries.supported を読んでください。

レスポンス

例:

{
  "country": "US",
  "source": "google_ads",
  "fetchedAt": "2026-10-09T13:05:12.000Z",
  "keywords": [
    {
      "keyword": "sunscreen",
      "searchVolume": 110000,
      "monthlySearches": [
        { "month": "2025-09", "searchVolume": 74000 },
        { "month": "2026-08", "searchVolume": 135000 }
      ],
      "last30Days": null,
      "competition": "high"
    }
  ]
}

例では12か月のうち2か月だけを示しています。

フィールド	説明
`country`、`source`	回答した国とデータソース。
`fetchedAt`	値を読んだ時刻。
`keywords`	リクエストしたキーワードごとに1行。0のキーワードも含みます。
`keywords[].searchVolume`	`monthlySearches` の平均。`0` は測定できる検索がないことを意味します。`KR` で月別の値を推定できなかった場合は `null`(下記参照)。
`keywords[].monthlySearches`	最大12件の `{ month, searchVolume }`。`month` は `YYYY-MM` 形式で、古い月から並びます。ソースにそのキーワードの系列がなければ空です。
`keywords[].last30Days`	`KR` のみ: Naver が数えた直近30日の検索数。それ以外では `null`。
`keywords[].competition`	広告の競合度: `low`、`medium`、`high`。ソースが示さなければ `null`。

KR の各月の値は、Naver の30日間の検索数を Naver の日別検索トレンドで配分したものです。トレンドがその30日のうち25日未満しかカバーしない場合、searchVolume は null、monthlySearches は空になり、last30Days には検索数がそのまま入ります。

制限とエラー

country がない、または不正な場合、keywords 配列が空または上限超過の場合、80文字を超えるキーワードがある場合は、フィールドを示した 422 VALIDATION_ERROR を返します。
CN、RU、ソースのない国は 422 REGION_UNSUPPORTED を返します。
KEYWORD_VOLUME は markdown、rawResponse、searchQueries を無視します。html と analysis は 422、citationAnalysis は 400 で拒否します。未対応のフラグを参照してください。
その他のリクエストエラーはエラーに記載しています。

はじめに

基本概念

回答エンジン

検索とウェブデータ

リクエストオプション

リサーチ

GEOモニタリング

アカウントとデータ

キーワード検索ボリューム API (KEYWORD_VOLUME)

リクエスト

パラメータ

データソースと国

レスポンス

制限とエラー

関連

​リクエスト

​パラメータ

​データソースと国

​レスポンス

​制限とエラー

​関連

リクエスト

パラメータ

データソースと国

レスポンス

制限とエラー

関連