Расширенные результаты в Google
Метод API SerpWatch: в каком виде страницы сайта показываются в Google — показы, клики, CTR и позиция по видам выдачи.
GET/api/v1/projects/{id}/rich-results
Возвращает последний отчёт раздела «Расширенные результаты в Google»: виды выдачи из Search Console (сниппеты товаров, отзывы, FAQ, видео и другие) за 28 дней с показами, кликами, CTR и средней позицией, те же цифры за предыдущие 28 дней и топ страниц по каждому виду. Отчёт обновляется раз в неделю. Если в последнем аудите есть ошибки микроразметки, в markup — страницы с разметкой, у которых нет показов в расширенном виде. Нужен привязанный сайт Search Console, иначе linked = false и types пуст.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
Ответ
| Поле | Что значит |
|---|---|
linked | привязан ли сайт Search Console |
site | ресурс Search Console или null |
checked_at | последнее обновление или null |
error | последняя ошибка Google или null |
period | start, end — текущие 28 дней; prev_start, prev_end — предыдущие |
types[] | code — код Google, name — название по-русски, clicks, impressions, ctr (в процентах), position, previous (те же поля за прошлый период или null), lost — вид пропал, pages[] — url, clicks, impressions, ctr, position |
markup | null или audit_id, error_pages — страниц с ошибками разметки, without_rich_total, without_rich[] — url, schema_types[], errors[] (code, detail) |
{
"linked": true,
"site": "sc-domain:site.ru",
"checked_at": "2026-10-12T04:31:08",
"error": null,
"period": {
"start": "2026-09-14",
"end": "2026-10-11",
"prev_start": "2026-08-17",
"prev_end": "2026-09-13"
},
"types": [
{
"code": "REVIEW_SNIPPET",
"name": "Отзывы и рейтинг (звёзды)",
"clicks": 212,
"impressions": 6840,
"ctr": 3.1,
"position": 6.4,
"previous": {
"clicks": 180,
"impressions": 6120,
"ctr": 2.94,
"position": 7.1
},
"lost": false,
"pages": [
{
"url": "https://site.ru/uslugi/remont",
"clicks": 96,
"impressions": 2410,
"ctr": 3.98,
"position": 4.8
}
]
}
],
"markup": {
"audit_id": 41,
"error_pages": 2,
"without_rich_total": 1,
"without_rich": [
{
"url": "https://site.ru/ceny",
"schema_types": [
"Product"
],
"errors": [
{
"code": "schema_missing_required",
"detail": "Product: нет offers, review или aggregateRating"
}
]
}
]
}
}
Примеры
curl
curl -H "Authorization: Bearer sw_ваш_токен" \ "https://serpwatch.ru/api/v1/projects/12/rich-results"
Python
import requests
r = requests.get("https://serpwatch.ru/api/v1/projects/12/rich-results",
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Отчёт клиенту: сколько показов и кликов дают звёзды и FAQ в выдаче
- Контроль после правок разметки: не пропал ли расширенный вид