Для начала работы с API SEOWORK необходимо обратиться в поддержку по почте help@seowork.ru или в чате на сайте. Для вас будет создан API токен.
https://api.seowork.ru/semantics/api/v5/dashboard/group
Для получения используется GET-запрос со следующими параметрами:
Имя | Обязательный | Тип | Значение по умолчанию | Описание |
| Да |
| id проекта | |
| Да |
| Токен авторизации | |
| Нет |
| Последняя дата апдейта | Дата в формате yyyy-mm-dd |
| Нет |
| yandex - для проектов seowork.ru google - для проектов seowork.io | Поисковая система |
| Нет |
| Количество записей на странице | |
| Нет |
| Пропуск записей для пагинации | |
| Нет |
| Страница |
Для получения даты апдейта используйте отдельный API запрос.
Например:
https://api.seowork.ru/semantics/api/v5/dashboard/group?token=...&project_id=123&date=2019-12-20&search_engine=yandex
Объект в формате json, в котором содержится список доступных проектов с перечислением их свойств:
Имя | Описание |
| Дата апдейта |
| id группы страниц |
| Название группы страниц |
| Количество запросов в группе страниц |
| Количество страниц в группе страниц |
| Средняя позиция |
| Количество запросов на нулевой позиции |
| Количество запросов в топ-1 |
| Количество запросов в топ-3 |
| Количество запросов в топ-5 |
| Количество запросов в топ-10 |
| Количество запросов в топ-30 |
| Процент запросов на нулевой позиции |
| Процент запросов в топ-1 |
| Процент запросов в топ-3 |
| Процент запросов в топ-5 |
| Процент запросов в топ-10 |
| Процент запросов в топ-30 |
| Сумма частотности WS1 всех запросов |
| Сумма частотности WS2 всех запросов |
| Сумма частотности WS1 всех запросов на нулевой позиции |
| Сумма частотности WS2 всех запросов на нулевой позиции |
| Сумма частотности WS1 всех запросов в топ-1 |
| Сумма частотности WS2 всех запросов в топ-1 |
| Сумма частотности WS1 всех запросов в топ-3 |
| Сумма частотности WS2 всех запросов в топ-3 |
| Сумма частотности WS1 всех запросов в топ-5 |
| Сумма частотности WS2 всех запросов в топ-5 |
| Сумма частотности WS1 всех запросов в топ-10 |
| Сумма частотности WS2 всех запросов в топ-10 |
| %WS1 всех запросов на нулевой позиции от суммы частотности всех запросов группы страниц |
| %WS2 всех запросов на нулевой позиции от суммы частотности всех запросов группы страниц |
| %WS1 всех запросов в топ-1 от суммы частотности всех запросов группы страниц |
| %WS2 всех запросов в топ-1 от суммы частотности всех запросов группы страниц |
| %WS1 всех запросов в топ-3 от суммы частотности всех запросов группы страниц |
| %WS2 всех запросов в топ-3 от суммы частотности всех запросов группы страниц |
| %WS1 всех запросов в топ-5 от суммы частотности всех запросов группы страниц |
| %WS2 всех запросов в топ-5 от суммы частотности всех запросов группы страниц |
| %WS1 всех запросов в топ-10 от суммы частотности всех запросов группы страниц |
| %WS2 всех запросов в топ-10 от суммы частотности всех запросов группы страниц |
| Потенциальный трафик |
| Процентный показатель потенциального трафика |
| Органический трафик |
| Процент органического трафика из поисковой системы Яндекс |
| Процент органического трафика из поисковой системы Google |
{
"has_data": true,
"data": {
"items": [
{
"date": "2024-03-15",
"id": 131131,
"name": "группа страниц",
"queries_count": 29758,
"documents_count": 653,
"position_avg": 11.18,
"top0_count": 0,
"top1_count": 986,
"top3_count": 4190,
"top5_count": 10165,
"top10_count": 20552,
"top30_count": 24887,
"top0_prc": 0,
"top1_prc": 3.31,
"top3_prc": 14.08,
"top5_prc": 34.16,
"top10_prc": 69.06,
"top30_prc": 83.63,
"ws1": 34447759,
"ws2": 938374,
"ws1_top0_count": 0,
"ws2_top0_count": 0,
"ws1_top1_count": 953116,
"ws2_top1_count": 41280,
"ws1_top3_count": 5039830,
"ws2_top3_count": 163274,
"ws1_top5_count": 10735232,
"ws2_top5_count": 343851,
"ws1_top10_count": 24933508,
"ws2_top10_count": 675824,
"ws1_top0_prc": 0,
"ws2_top0_prc": 0,
"ws1_top1_prc": 2.77,
"ws2_top1_prc": 4.4,
"ws1_top3_prc": 14.63,
"ws2_top3_prc": 17.4,
"ws1_top5_prc": 31.16,
"ws2_top5_prc": 36.64,
"ws1_top10_prc": 72.38,
"ws2_top10_prc": 72.02,
"p_traf": 24108.77,
"p_traf_prc": 25.69,
"traffic_organic": 103818,
"traffic_yandex_prc": 58607,
"traffic_google_prc": 44646
},
...
],
"count": 9,
"total": 9,
"limit": 100,
"page": 1
},
"version": 1,
"status": 200,
"error": 0,
"error_messages": [],
"response_time": 0.0000000000000001,
"server_timestamp": "2023-05-26 00:00:00",
"server_unixtimestamp": 1685059200
}