SerpWatch
Меню

Низкий CTR

Метод API SerpWatch: запросы и страницы с низким CTR — сколько кликов сайт недополучает при своих позициях.

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

Берёт показы, клики и среднюю позицию из Вебмастера или Search Console за период и сравнивает фактический CTR с ожидаемым для позиции. Недобор = показы × (ожидаемый CTR − фактический). Запросы сгруппированы по странице; для страницы — title и description из последнего аудита и подсказки. status = nodata, если данных о показах нет.

Параметры

ПараметрГдеЧто значит
idв путиid проекта
daysнеобязательнопериод: 7, 28 (по умолчанию) или 90
engineнеобязательноyandex или google; по умолчанию первый подключённый
region_idнеобязательноid региона проекта

Ответ

ПолеЧто значит
statusok или nodata
engine, region_id, days, date_from, date_toчто посчитано
missed_clicks_monthсколько кликов в месяц недополучено
queries, pagesсколько запросов и страниц
items[]url, title, description, title_length, description_length, query_in_title, missed_clicks_month, hints[], queries[] (keyword_id, keyword, position, impressions, clicks, ctr, expected_ctr — в процентах, missed_clicks, missed_clicks_month)
{
  "status": "ok",
  "engine": "yandex",
  "region_id": 1,
  "days": 28,
  "date_from": "2026-09-13",
  "date_to": "2026-10-10",
  "missed_clicks_month": 214,
  "queries": 9,
  "pages": 4,
  "items": [
    {
      "url": "https://site.ru/uslugi/zamena-masla",
      "title": "Услуги автосервиса",
      "description": "",
      "title_length": 18,
      "description_length": 0,
      "query_in_title": false,
      "missed_clicks_month": 108.0,
      "hints": [
        "Запроса «замена масла» нет в title — добавьте его ближе к началу."
      ],
      "queries": [
        {
          "keyword_id": 12,
          "keyword": "замена масла",
          "position": 2.4,
          "impressions": 1200,
          "clicks": 60,
          "ctr": 5.0,
          "expected_ctr": 13.4,
          "missed_clicks": 100.8,
          "missed_clicks_month": 108.0
        }
      ]
    }
  ]
}

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects/12/ctr"

Python

import requests

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

Ошибки

400 — неверный days или engine; 404 — проект или регион не найден. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

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

  • Список страниц, где переписать сниппет, — в таск-трекер
  • Отчёт клиенту: сколько кликов можно вернуть