Снимок выдачи

Метод API SerpWatch: топ выдачи Яндекса по запросу — позиции, адреса, домены, заголовки и сниппеты.

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

Возвращает сохранённый снимок выдачи по одному запросу: кто стоит в топе, с какими заголовками и описаниями. Без параметра day — последний снимок.

Параметры

Параметр	Где	Что значит
`id`	в пути	id проекта
`keyword_id`	обязательно	id запроса
`region_id`	необязательно	id региона
`day`	необязательно	дата снимка, ГГГГ-ММ-ДД

Ответ

Поле	Что значит
`date`	дата снимка
`top[]`	rank, url, domain, title, snippet

{
  "date": "2026-10-05",
  "top": [
    {
      "rank": 1,
      "url": "https://example.ru/remont-akpp",
      "domain": "example.ru",
      "title": "Ремонт АКПП в Калининграде",
      "snippet": "Диагностика бесплатно…"
    }
  ]
}

Примеры

curl

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

Python

import requests

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

Ошибки

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

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

Разбор конкурентов в своей аналитике
Мониторинг сниппетов конкурентов