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_28d | impressions, 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 в своём дашборде рядом с поиском
- Оповещение редакции о статьях, выпавших из ленты