Suchvolumen-Prognose API
Aufruf
Erwartetes Google-Suchvolumen der nächsten 12 Monate mit Spanne, Saisonfaktoren und dem Termin, bis wann Inhalte online sein sollten, für bis zu 100 Keywords. Dieselben Daten wie in der Suchvolumen-Prognose.
https://seorch.de/api/forecast/?key=DEIN_KEY&keywords=gartenm%C3%B6bel,fahrradhelm&country=de
Parameter
| Parameter | Pflicht | Bedeutung |
|---|---|---|
key | ja | Dein API Key, alternativ im Header X-API-Key |
keywords | ja | Bis zu 100 Keywords, getrennt durch Komma oder Zeilenumbruch |
country | nein | Land als Kürzel, xx (Standard) steht für weltweit |
Antwort
| Feld | Bedeutung |
|---|---|
forecast_from | Erster Monat der Prognose |
results | Je Keyword search_volume, avg_last_12_months, yoy (Veränderung zum Vorjahr in Prozent), cpc, cpc_high, cpc_low, competition (0 bis 100), competition_level und monthly (48 Monate, älteste zuerst) |
forecast | Die nächsten 12 Monate mit search_volume und der Spanne low bis high. Die Summe entspricht den letzten 12 Monaten: Die Prognose verteilt das Jahresvolumen nach dem Saisonmuster, einen Trend schreibt sie nicht fort. |
seasonality | index je Monat (1 = Durchschnitt), peak_month und low_month (1 bis 12), seasonal (höchster Faktor ab 1,3), peak_expected, rise_month (ab hier liegt die Nachfrage über dem Durchschnitt) und publish_by: zwei Monate vor dem Anstieg der nächsten Saison. publish_now ist true, wenn der Termin schon erreicht ist. |
reliability | level (high, medium, low), avg_deviation (mittlere Abweichung pro Monat in Prozent im Test an der Vergangenheit), year_error und basis_months |
skipped | Keywords mit Sonderzeichen oder über 55 Zeichen, die der Dienst nicht abfragen kann |
{
"api_version": 1,
"country": "de",
"forecast_from": "2026-11",
"results": [
{
"keyword": "gartenmöbel",
"search_volume": 110000,
"avg_last_12_months": 106242,
"yoy": -14,
"cpc": 0.86,
"cpc_high": 1.02,
"cpc_low": 0.21,
"competition": 100,
"competition_level": "high",
"forecast": [
{
"month": "2026-11",
"search_volume": 27838,
"low": 22437,
"high": 33239
},
{
"month": "2027-03",
"search_volume": 237528,
"low": 191448,
"high": 283608
}
],
"seasonality": {
"seasonal": true,
"index": {
"01": 0.51,
"02": 1,
"03": 2.24,
"12": 0.21
},
"peak_month": 3,
"low_month": 12,
"peak_expected": 237528,
"rise_month": 2,
"publish_by": "2026-12",
"publish_now": false
},
"reliability": {
"level": "high",
"avg_deviation": 19.4,
"year_error": 16.3,
"basis_months": 36
},
"monthly": {
"2022-11": 49500,
"2026-10": 33100
}
}
],
"skipped": []
}
Fehler
Fehler kommen als JSON mit festem Code. Für alle APIs gelten missing_key und invalid_key (401), rate_limited (429) und fehlende oder ungültige Parameter (400). Außerdem bei dieser API: invalid_keywords, too_many_keywords, upstream_error.
Limits
Pro Key gelten 10 Anfragen pro Minute und 500 pro Tag. Höhere Limits sind auf Anfrage möglich.