API SerpWatch v1
JSON по HTTPS. Авторизация — заголовок Authorization: Bearer sw_… (токен создаётся в разделе «API» кабинета).
Лимит — 120 запросов в минуту на токен. Ошибки: {"error": "…"} с кодом 4xx.
| Метод | Путь | Что возвращает |
|---|---|---|
| GET | /api/v1/projects | Список проектов. проекты аккаунта и гостевые проекты с регионами и устройствами. |
| GET | /api/v1/projects/{id}/keywords | Запросы проекта. все запросы проекта с группами, тегами, целевыми URL и частотой. |
| POST | /api/v1/projects/{id}/keywords | Добавление запросов. добавить запросы в проект пачкой, сразу в нужную группу. |
| GET | /api/v1/projects/{id}/positions | Позиции по дням. позиции запросов по дням с URL, показами и кликами — до 50 000 строк за вызов. |
| GET | /api/v1/projects/{id}/summary | Сводка по позициям. видимость, топ-3/10/30, средняя и медианная позиция на последнюю дату. |
| GET | /api/v1/projects/{id}/snapshots | Снимок выдачи. топ выдачи Яндекса по запросу — позиции, адреса, домены, заголовки и сниппеты. |
| GET | /api/v1/projects/{id}/audit | Результаты аудита. последний завершённый аудит сайта — оценка здоровья и список проблем по страницам. |
Разделы
- Авторизация и токены API — Как получить токен API SerpWatch, передать его в заголовке Authorization и что делать, если токен утёк.
- Ошибки и лимиты API — Коды ответов API SerpWatch, формат ошибок и лимит 120 запросов в минуту на токен.
- Позиции из API в Google Таблицы и Python — Готовые примеры: выгрузить позиции SerpWatch в Google Таблицы через Apps Script и в CSV на Python.
Пример
curl -H "Authorization: Bearer sw_ваш_токен" https://serpwatch.ru/api/v1/projects