Добавление заметки
Метод API SerpWatch: добавить заметку на графики проекта — например, из своей системы задач после релиза.
POST/api/v1/projects/{id}/notes
Создаёт заметку от имени владельца токена. Текст — до 300 знаков, дата — в формате ГГГГ-ММ-ДД. Неизвестный тип превращается в other.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
date | в теле, обязательно | дата события |
text | в теле, обязательно | что сделали |
kind | в теле | site, links, ads, update или other |
url | в теле | адрес страницы, http:// или https:// |
Тело запроса
{
"date": "2026-10-01",
"text": "Обновили цены на странице услуг",
"kind": "site",
"url": "https://site.ru/uslugi"
}
Ответ
| Поле | Что значит |
|---|---|
id | id новой заметки |
{
"id": 8
}
Примеры
curl
curl -X POST -H "Authorization: Bearer sw_ваш_токен" -H "Content-Type: application/json" \
-d '{"date": "2026-10-01", "text": "Обновили цены на странице услуг", "kind": "site", "url": "https://site.ru/uslugi"}' \
https://serpwatch.ru/api/v1/projects/12/notes
Python
import requests
r = requests.post("https://serpwatch.ru/api/v1/projects/12/notes", json={"date": "2026-10-01", "text": "Обновили цены на странице услуг", "kind": "site", "url": "https://site.ru/uslugi"},
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
403 — гостевой доступ только для просмотра; 400 — пустой текст, длинный текст или неверная дата. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Ставить отметку о релизе автоматически из CI
- Отмечать запуск рекламных кампаний