Для начала работы с API SEOWORK необходимо обратиться в поддержку по почте help@seowork.ru или в чате на сайте. Для вас будет создан API токен.
В системе SEOWORK должны быть добавлены и настроены проекты в разделе
Конкуренты
Какие данные можно получить по API:
- Даты апдейтов по конкуренту в топ-10
- Получение конкурентов с метриками за последнюю дату по проекту клиента.
Получение дат обновлений по проекту
GET-Запрос
В заголовках запроса укажите следующие параметры:
Формат ответа
Объект в формате json, в котором содержится список доступных проектов с перечислением их свойств:
{
"data": {
"items": [
{
"date": "2020-02-22",
"competition_count": 22673,
"count": 22673,
"finished": 22673,
"ws_count": 22673,
"ws1": 30074073,
"ws2": 1486984,
"ws3": 890483,
"ptraf": 490713
},
{
"date": "2020-02-19",
"competition_count": 22673,
"count": 22673,
"finished": 22673,
"ws_count": 22673,
"ws1": 30073723,
"ws2": 1486926,
"ws3": 890432,
"ptraf": 490700
},
{
"date": "2020-02-16",
"competition_count": 22673,
"count": 22673,
"finished": 22673,
"ws_count": 22673,
"ws1": 26024134,
"ws2": 1271302,
"ws3": 756821,
"ptraf": 419534
}Получение конкурентов с метриками за последнюю дату по проекту клиента
GET-Запрос
https://seowork.ru/competitors/api/v1/project/{project}?token={token}&top=10&date={date}
В заголовках запроса укажите следующие параметры:
Формат ответа
Объект в формате json, в котором содержится список доступных проектов с перечислением их свойств:
{
"data": {
"items": [
{
"host": "*.ru",
"count": 279,
"ws1": 407022,
"ws2": 21810,
"ws3": 12180,
"ptraf": 974.33,
"count_%": 41.03,
"ws1_%": 83.2,
"ws2_%": 94.77,
"ws3_%": 96.16,
"ptraf_%": 42.33
},
{
"host": "*.ru",
"count": 259,
"ws1": 148925,
"ws2": 8766,
"ws3": 5779,
"ptraf": 374.57,
"count_%": 38.09,
"ws1_%": 30.44,
"ws2_%": 38.09,
"ws3_%": 45.63,
"ptraf_%": 16.25
},
{
"host": "*.ru",
"count": 256,
"ws1": 363900,
"ws2": 19670,
"ws3": 10425,
"ptraf": 422.77,
"count_%": 37.65,
"ws1_%": 74.39,
"ws2_%": 85.47,
"ws3_%": 82.31,
"ptraf_%": 18.34
},
{
"host": "*.ru",
"count": 239,
"ws1": 153051,
"ws2": 7967,
"ws3": 4624,
"ptraf": 178.77,
"count_%": 35.15,
"ws1_%": 31.29,
"ws2_%": 34.62,
"ws3_%": 36.51,
"ptraf_%": 7.74
}
API методы для других модулей:
- Модуль Видимость
- Модуль Отчет-Позиции