SerpWatch
Меню

Прогноз трафика

Метод API SerpWatch: прогноз кликов и ценности в рублях, если запросы выйдут в топ‑3, топ‑5, топ‑10.

GET/api/v1/projects/{id}/forecast

Сценарий «что, если»: сколько кликов в месяц даст выход запросов на целевые позиции за 3, 6 или 12 месяцев. Клики = частота × CTR позиции, прогноз учитывает вероятность дойти до цели (расстояние и сложность выдачи), рост по месяцам — S-кривая. Это оценка, а не обещание. Запросы без частоты или без позиции за 30 дней пропускаются — их число в поле skipped.

Параметры

ПараметрГдеЧто значит
idв путиid проекта
region_idнеобязательноid региона (Яндекс или Google), по умолчанию первый
targetнеобязательноtop3 (по умолчанию), top5, top10 или plus
nнеобязательнона сколько позиций подняться при target=plus, 1–50, по умолчанию 5
horizonнеобязательносрок в месяцах: 3, 6 (по умолчанию) или 12
group_idнеобязательнотолько запросы группы
tag_idнеобязательнотолько запросы с тегом
kdнеобязательнотолько запросы со сложностью не выше, 0–99

Ответ

ПолеЧто значит
regionрегион: id, name, engine, device
scenarioразобранные параметры сценария
summaryclicks_now, clicks_forecast, clicks_optimistic, gain, value_gain (₽ в месяц), extra_clicks_total и extra_value_total — накопленно за срок
skippedсколько запросов не учтено: no_frequency, no_position, over_kd, no_kd
months[]label, clicks — ожидаемые клики в месяц, optimistic — если все дойдут до цели
rows[]keyword_id, text, frequency, position, target, probability, clicks_now, clicks_forecast, clicks_target, gain, difficulty, cpc, value — по убыванию прироста
{
  "region": {
    "id": 31,
    "name": "Калининград",
    "engine": "yandex",
    "device": "ALL"
  },
  "scenario": {
    "target": "top3",
    "n": null,
    "horizon": 6,
    "scope": null,
    "kd_max": null
  },
  "summary": {
    "keywords": 42,
    "clicks_now": 1180,
    "clicks_forecast": 1720,
    "clicks_optimistic": 2650,
    "gain": 540,
    "value_gain": 21600
  },
  "skipped": {
    "no_frequency": 3,
    "no_position": 5,
    "over_kd": 0,
    "no_kd": 0
  },
  "months": [
    {
      "label": "сейчас",
      "clicks": 1180,
      "optimistic": 1180
    }
  ],
  "rows": [
    {
      "keyword_id": 501,
      "text": "ремонт акпп калининград",
      "frequency": 880,
      "position": 6,
      "target": 3,
      "probability": 0.74,
      "clicks_now": 44,
      "clicks_forecast": 83.1,
      "clicks_target": 96.8,
      "gain": 39.1,
      "difficulty": 34,
      "cpc": 40.0,
      "value": 1564
    }
  ]
}

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects/12/forecast?target=top3&horizon=6"

Python

import requests

r = requests.get("https://serpwatch.ru/api/v1/projects/12/forecast",
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

400 — неизвестное значение target. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

Для чего пригодится

  • Обоснование бюджета на SEO в коммерческом предложении
  • План роста трафика по группам услуг