> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 1つの国でキーワード最大100件の月間検索ボリュームを、直近12か月の推移と広告の競合度とともに取得します。

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

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

## リクエスト

```bash theme={"theme":"css-variables"}
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`](/ja/engines/capacity#各エンジンの提供内容を確認する) を呼び出し、`countries.supported` を読んでください。

## レスポンス

例:

```json theme={"theme":"css-variables"}
{
  "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` で拒否します。[未対応のフラグ](/ja/engines/response-options.md#未対応のフラグ)を参照してください。
* その他のリクエストエラーは[エラー](/ja/concepts/errors.md)に記載しています。

## 関連

* [Prompt Research](/ja/research/prompt-research.md): トピックから追跡するプロンプトを作る
* [地域と位置](/ja/engines/capacity.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.