SerpWatch
Меню

План работ

Метод 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 запросов в минуту — в разделе ошибки и лимиты.

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

  • Задачи по сайту — в свой таск-трекер
  • Отчёт клиенту о сделанной работе