Для начала работы с API SEOWORK необходимо обратиться в поддержку по почте help@seowork.ru или в чате на сайте. Для вас будет создан API токен.

В системе SEOWORK должны быть добавлены и настроены проекты в разделе
Конкуренты

Какие данные можно получить по API: 

  • Даты апдейтов по конкуренту в топ-10
  • Получение конкурентов с метриками за последнюю дату по проекту клиента.

Получение дат обновлений по проекту

GET-Запрос

https://seowork.ru/competitors/api/v1/project/{project_id}/updates?search_engine={yandex/google}&token={token}

В заголовках запроса укажите следующие параметры:

Формат ответа

Объект в формате 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 методы для других модулей: 

Вы нашли ответ?