Сводка по позициям

Метод API SerpWatch: видимость, топ-3/10/30, средняя и медианная позиция на последнюю дату.

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

Одна строка с главными цифрами проекта на последнюю дату проверки — удобно для виджетов и ежедневных сообщений.

Параметры

Параметр	Где	Что значит
`id`	в пути	id проекта
`region_id`	необязательно	id региона, по умолчанию первый

Ответ

Поле	Что значит
`date`	дата последней проверки
`region`	регион
`top3, top10, top30`	сколько запросов в топе
`avg, median`	средняя и медианная позиция
`visibility`	видимость, %
`weighted`	true, если видимость взвешена по частоте запросов

{
  "date": "2026-10-05",
  "region": "Калининград",
  "top3": 12,
  "top10": 41,
  "top30": 77,
  "avg": 14.2,
  "median": 9.0,
  "visibility": 23.5,
  "weighted": true
}

Примеры

curl

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

Python

import requests

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

Ошибки

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

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

Виджет на сайте агентства
Ежедневное сообщение в рабочий чат