SerpWatch
Меню

Google Discover

Метод API SerpWatch: показы и клики из ленты Google Discover по дням и по страницам — новые и выпавшие страницы.

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

Возвращает последний отчёт раздела «Google Discover»: показы, клики и CTR из ленты рекомендаций Google по данным Search Console — по дням за 90 дней и по страницам за последние 28 дней в сравнении с 28 днями до них. У Discover нет запросов и позиции. Search Console отдаёт этот отчёт только сайтам, набравшим минимальный порог показов в ленте, поэтому у небольших сайтов days и pages пустые — это не ошибка. Данные обновляются раз в неделю и при открытии раздела; метод отдаёт сохранённый отчёт и в Google не ходит.

Параметры

ПараметрГдеЧто значит
idв путиid проекта

Ответ

ПолеЧто значит
linkedпривязан ли сайт Search Console
siteресурс Search Console или null
checked_atкогда данные получены из Search Console, или null
period_endпоследний день данных (Search Console отдаёт их с задержкой 2–3 дня)
errorпоследняя ошибка обновления или null
totals_28dimpressions, clicks, ctr за 28 дней; prev_impressions, prev_clicks — за 28 дней до них; impressions_change, clicks_change — изменение, %
days[]date, impressions, clicks, ctr — по дням за 90 дней
pages[]url, impressions, clicks, ctr, prev_impressions, prev_clicks, impressions_change (%), clicks_change (разница кликов), status: active, new (новая в Discover) или dropped (выпала)
{
  "linked": true,
  "site": "sc-domain:site.ru",
  "checked_at": "2026-10-12T04:30:00",
  "period_end": "2026-10-10",
  "error": null,
  "totals_28d": {
    "impressions": 18240,
    "clicks": 912,
    "ctr": 5.0,
    "prev_impressions": 12100,
    "prev_clicks": 590,
    "impressions_change": 51,
    "clicks_change": 55
  },
  "days": [
    {
      "date": "2026-10-10",
      "impressions": 702,
      "clicks": 38,
      "ctr": 5.4
    }
  ],
  "pages": [
    {
      "url": "https://site.ru/blog/zimnie-shiny",
      "impressions": 6400,
      "clicks": 352,
      "ctr": 5.5,
      "prev_impressions": 0,
      "prev_clicks": 0,
      "impressions_change": null,
      "clicks_change": 352,
      "status": "new"
    },
    {
      "url": "https://site.ru/blog/arhiv",
      "impressions": 0,
      "clicks": 0,
      "ctr": null,
      "prev_impressions": 2100,
      "prev_clicks": 95,
      "impressions_change": -100,
      "clicks_change": -95,
      "status": "dropped"
    }
  ]
}

Примеры

curl

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

Python

import requests

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

Ошибки

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

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

  • Трафик из Discover в своём дашборде рядом с поиском
  • Оповещение редакции о статьях, выпавших из ленты