All Tools

  1. SEORCH
  2. SEO API
  3. Search Volume Forecast API

Search Volume Forecast API

Request

Expected Google search volume for the next 12 months with range, seasonal factors and the date by which content should be online, for up to 100 keywords. The same data as in the Search Volume Forecast.

https://seorch.net/api/forecast/?key=YOUR_KEY&keywords=patio%20furniture,bike%20helmet&country=us

Parameters

ParametersRequiredMeaning
keyyesYour API key, alternatively in the X-API-Key header
keywordsyesUp to 100 keywords, separated by comma or line break
countrynoCountry code, xx (default) means worldwide

Response

FieldMeaning
forecast_fromFirst month of the forecast
resultsFor each keyword search_volume, avg_last_12_months, yoy (change vs. last year in percent), cpc, cpc_high, cpc_low, competition (0 to 100), competition_level and monthly (48 months, oldest first)
forecastThe next 12 months with search_volume and the range low to high. The total equals the past 12 months: the forecast distributes the yearly volume by the seasonal pattern and does not extend a trend.
seasonalityindex per month (1 = average), peak_month and low_month (1 to 12), seasonal (highest factor of 1.3 or more), peak_expected, rise_month (from here demand is above average) and publish_by: two months before the rise of the next season. publish_now is true if that date has already been reached.
reliabilitylevel (high, medium, low), avg_deviation (average deviation per month in percent, tested against the past), year_error and basis_months
skippedKeywords with special characters or over 55 characters that the service cannot query
Sample response, shortened
{
  "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": []
}

Errors

Errors are returned as JSON with a fixed code. All APIs use missing_key and invalid_key (401), rate_limited (429) and missing or invalid parameters (400). Additionally for this API: invalid_keywords, too_many_keywords, upstream_error.

Limits

Each key allows 10 requests per minute and 500 per day. Higher limits are available on request.