> ## 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.

# Keyword-Suchvolumen per API (KEYWORD_VOLUME)

> Das monatliche Suchvolumen von bis zu 100 Keywords in einem Land abrufen, mit den letzten 12 Monaten und dem Wettbewerb unter Werbetreibenden.

`KEYWORD_VOLUME` liefert für jedes Keyword die durchschnittlichen monatlichen Suchen der letzten 12 Monate, die 12 Monatswerte und den Wettbewerb unter Werbetreibenden, für ein Land pro Task.

| | |
| - | - |
| `taskType` | `KEYWORD_VOLUME` |
| Eingabe | `keywords` (1-100, Pflicht), `country` (Pflicht) |
| Credits | 3 pro Task, unabhängig von der Zahl der Keywords |
| Land | Pflicht. Nur bediente Länder; siehe unten. |
| Standort | Nicht unterstützt (`422 LOCATION_UNSUPPORTED`). |

## Anfrage

```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" } }'
```

## Parameter

| Feld | Pflicht | Beschreibung |
| - | - | - |
| `keywords` | Ja | Ein Array mit 1 bis 100 Keywords, jedes 1-80 Zeichen nach dem Zusammenfassen von Leerraum. In `KR` enthalten Keywords nur Buchstaben, Ziffern und Leerzeichen. |
| `country` | Ja | Ein zweistelliger Ländercode. Er bestimmt auch die Datenquelle. |

## Datenquellen und Länder

| Land | Quelle (`source`) | Was gezählt wird |
| - | - | - |
| `KR` | Naver (`naver`) | Suchen auf Naver. |
| Jedes andere bediente Land | Google Keyword Planner (`google_ads`) | Alle Google-Suchen in diesem Land, in jeder Sprache. |

Bedient werden `KR` und die Länder-Targets von Google Ads, mit zwei Ausnahmen: `CN` und `RU` liefern `422 REGION_UNSUPPORTED`, weil dort Baidu und Yandex die meisten Suchen bedienen. Ein Land ohne Quelle liefert denselben Fehler. Die genaue Liste erhalten Sie mit [`GET /v1/capabilities?taskType=KEYWORD_VOLUME`](/de/engines/capacity#was-jede-engine-bedient) in `countries.supported`.

## Antwort

Zum Beispiel:

```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"
    }
  ]
}
```

Das Beispiel zeigt zwei der zwölf Monate.

| Feld | Beschreibung |
| - | - |
| `country`, `source` | Das Land und die Datenquelle, die geantwortet hat. |
| `fetchedAt` | Wann die Werte gelesen wurden. |
| `keywords` | Eine Zeile pro angefragtem Keyword, auch bei null Suchen. |
| `keywords[].searchVolume` | Der Durchschnitt von `monthlySearches`. `0` bedeutet keine messbaren Suchen. In `KR` `null`, wenn sich die Monate nicht schätzen ließen (siehe unten). |
| `keywords[].monthlySearches` | Bis zu 12 Einträge `{ month, searchVolume }`, `month` als `YYYY-MM`, ältester zuerst. Leer, wenn die Quelle keine Reihe für das Keyword hat. |
| `keywords[].last30Days` | Nur `KR`: Navers Zählung der letzten 30 Tage. Sonst `null`. |
| `keywords[].competition` | Wettbewerb unter Werbetreibenden: `low`, `medium`, `high` oder `null`, wenn die Quelle keinen angibt. |

In `KR` verteilt jeder Monat Navers 30-Tage-Zählung nach Navers täglichem Suchtrend. Deckt der Trend weniger als 25 dieser 30 Tage ab, ist `searchVolume` `null`, `monthlySearches` leer und `last30Days` enthält weiterhin die Zählung.

## Grenzen und Fehler

* Ein fehlendes oder fehlerhaftes `country`, ein leeres oder zu großes `keywords`-Array oder ein Keyword mit mehr als 80 Zeichen liefert `422 VALIDATION_ERROR` mit dem betroffenen Feld.
* `CN`, `RU` und Länder ohne Quelle liefern `422 REGION_UNSUPPORTED`.
* `KEYWORD_VOLUME` ignoriert `markdown`, `rawResponse` und `searchQueries`. Es lehnt `html` und `analysis` mit `422` und `citationAnalysis` mit `400` ab; siehe [nicht unterstützte Flags](/de/engines/response-options.md#nicht-unterstützte-flags).
* Weitere Anfragefehler stehen unter [Fehler](/de/concepts/errors.md).

## Verwandt

* [Prompt Research](/de/research/prompt-research.md), um aus einem Thema Prompts zum Tracken zu machen
* [Regionen und Standort](/de/engines/capacity.md)


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