План работ
Метод API SerpWatch: план SEO-работ проекта — задачи из аудита, позиций и мониторинга плюс свои, со статусами.
GET/api/v1/projects/{id}/plan
Возвращает задачи раздела «План работ». Задачи из отчётов пересобираются при запросе: исправленная проблема получает статус done и resolved = true. Свои задачи пользователей идут с source = manual.
Параметры
| Параметр | Где | Что значит |
|---|---|---|
id | в пути | id проекта |
status | необязательно | todo, doing, done или later |
Ответ
| Поле | Что значит |
|---|---|
total | всего задач |
done | из них готово |
tasks[] | id, key (ключ задачи из отчёта или null для своей), source, title, detail, priority (high, medium, low), status (todo, doing, done, later), resolved, count, unit (pages, queries, links), link, due, assignee, created_at, done_at |
{
"total": 2,
"done": 1,
"tasks": [
{
"id": 3,
"key": "audit:no_title",
"source": "audit",
"title": "Нет title",
"detail": null,
"priority": "high",
"status": "todo",
"resolved": false,
"count": 12,
"unit": "pages",
"link": "/projects/1/audit?code=no_title",
"due": "2026-10-20",
"assignee": "Иван",
"created_at": "2026-10-12T08:00:00",
"done_at": null
},
{
"id": 4,
"key": null,
"source": "manual",
"title": "Обновить цены на странице услуг",
"detail": null,
"priority": "medium",
"status": "done",
"resolved": false,
"count": 0,
"unit": null,
"link": null,
"due": null,
"assignee": null,
"created_at": "2026-10-10T09:30:00",
"done_at": "2026-10-11T15:12:00"
}
]
}
Примеры
curl
curl -H "Authorization: Bearer sw_ваш_токен" \ "https://serpwatch.ru/api/v1/projects/12/plan"
Python
import requests
r = requests.get("https://serpwatch.ru/api/v1/projects/12/plan",
headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())
Ошибки
400 — неизвестный status. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.
Для чего пригодится
- Задачи по сайту — в свой таск-трекер
- Отчёт клиенту о сделанной работе