SerpWatch
Меню

Расширенные результаты в 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
periodstart, end — текущие 28 дней; prev_start, prev_end — предыдущие
types[]code — код Google, name — название по-русски, clicks, impressions, ctr (в процентах), position, previous (те же поля за прошлый период или null), lost — вид пропал, pages[] — url, clicks, impressions, ctr, position
markupnull или 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 в выдаче
  • Контроль после правок разметки: не пропал ли расширенный вид