SerpWatch
Меню

Добавление заметки

Метод 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"
}

Ответ

ПолеЧто значит
idid новой заметки
{
  "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
  • Отмечать запуск рекламных кампаний