Заметки проекта
Метод API SerpWatch: заметки проекта — что и когда делали на сайте: правки, ссылки, реклама, апдейты.
GET/api/v1/projects/{id}/notes
Возвращает заметки, которые показываются на графиках позиций и трафика. Без параметров — за год назад и вперёд от сегодняшнего дня, свежие сверху.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
date_from | необязательно | начало периода, ГГГГ-ММ-ДД |
date_to | необязательно | конец периода, ГГГГ-ММ-ДД |
Ответ
| Поле | Что значит |
|---|---|
id | id заметки |
date | дата события |
kind | site — правка сайта, 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 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Подписи к графикам в своём отчёте
- Журнал работ по сайту для клиента