Keyword-Suchvolumen per API (KEYWORD_VOLUME)

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

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 in countries.supported.

Antwort

Zum Beispiel:

{
  "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.
Weitere Anfragefehler stehen unter Fehler.

Verwandt

Prompt Research, um aus einem Thema Prompts zum Tracken zu machen
Regionen und Standort

Erste Schritte

Grundlagen

Antwort-Engines

Suche und Webdaten

Anfrageoptionen

Recherche

GEO-Monitoring

Konto und Daten

Keyword-Suchvolumen per API (KEYWORD_VOLUME)

Anfrage

Parameter

Datenquellen und Länder

Antwort

Grenzen und Fehler

Verwandt

​Anfrage

​Parameter

​Datenquellen und Länder

​Antwort

​Grenzen und Fehler

​Verwandt

Anfrage

Parameter

Datenquellen und Länder

Antwort

Grenzen und Fehler

Verwandt