Прогноз трафика
Метод 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 | разобранные параметры сценария |
summary | clicks_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 в коммерческом предложении
- План роста трафика по группам услуг