SerpWatch
Меню

Заметки проекта

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

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

Возвращает заметки, которые показываются на графиках позиций и трафика. Без параметров — за год назад и вперёд от сегодняшнего дня, свежие сверху.

Параметры

ПараметрГдеЧто значит
idв путиid проекта
date_fromнеобязательноначало периода, ГГГГ-ММ-ДД
date_toнеобязательноконец периода, ГГГГ-ММ-ДД

Ответ

ПолеЧто значит
idid заметки
dateдата события
kindsite — правка сайта, links — ссылки, ads — реклама, update — апдейт поисковика, other — другое
textтекст заметки
urlстраница или null
[
  {
    "id": 7,
    "date": "2026-10-01",
    "kind": "links",
    "text": "Закупили 5 ссылок с авто-форумов",
    "url": null
  }
]

Примеры

curl

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

Python

import requests

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

Ошибки

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

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

  • Подписи к графикам в своём отчёте
  • Журнал работ по сайту для клиента