API ключ доступен только после авторизации

Авторизация


Документация API

Общая информация

Все запросы необходимо направлять по адресу:
https://livesurf.ru:8183/api/client/{method}
где {method} — название одного из доступных методов.

API принимает все параметры в теле запроса в формате JSON и возвращает ответ в формате JSON.
У заголовка Accept должно быть установлено значение application/json.
Для авторизации в API необходимо передать заголовок Authorization с вашим API-ключом.

Примеры запросов к API

GET

curl --location 'https://livesurf.ru:8183/api/{method}/' --header 'Authorization: Your Api-key' --header 'Accept: application/json'

POST

curl --location --request POST 'https://livesurf.ru:8183/api/{method}/' --header 'Authorization: Your Api-key' --header 'Accept: application/json' --data '{"YourJsonParam": 1}'

PATCH

curl --location --request PATCH 'https://livesurf.ru:8183/api/{method}/' --header 'Authorization: Your Api-key' --header 'Accept: application/json' --data '{"YourJsonParam": 1}'

DELETE

curl --location --request DELETE 'https://livesurf.ru:8183/api/{method}/' --header 'Authorization: Your Api-key' --header 'Accept: application/json'

ВНИМАНИЕ: К API разрешено делать не более 10 запросов в секунду. При превышении лимита излишние запросы не будут обработаны.


Доступные методы

  • GET /categories/ - Список возможных категорий.
  • GET /countries/ - Список возможных стран.
  • GET /languages/ - Список доступных языков.
  • GET /sources/ad/ - Список рекламных площадок.
  • GET /sources/messengers/ - Список мессенджеров.
  • GET /sources/search/ - Список поисковых систем.
  • GET /sources/social/ - Список социальных сетей.
  • GET /user/ - Получение информации о пользователе.
  • POST /user/automode/ - Включение режима АРК (Автоматическая рекламная кампания).
  • POST /user/manualmode/ - Включение ручного режима работы.
  • GET /group/all/ - Информация о добавленных группах.
  • GET /group/{group_id} - Информация о конкретной группе.
  • PATCH /group/{group_id} - Изменение настроек группы.
  • DELETE /group/{group_id} - Удаление группы.
  • POST /group/create - Создание новой группы.
  • POST /group/{group_id}/clone - Клонирование группы.
  • POST /group/{group_id}/add_credits - Зачисление кредитов посещений на счёт группы в ручном режиме работы.
  • GET /page/{page_id} - Информация о конкретной странице.
  • PATCH /page/{page_id} - Изменение настроек страницы.
  • DELETE /page/{page_id} - Удаление страницы.
  • POST /page/create - Создание новой страницы.
  • POST /page/{page_id}/clone - Клонирование страницы.
  • POST /page/{page_id}/up - Перемещение страницы на позицию вверх.
  • POST /page/{page_id}/down - Перемещение страницы на позицию вниз.
  • POST /page/{page_id}/start - Запуск страницы в работу.
  • POST /page/{page_id}/stop - Остановка работы страницы.
  • GET /pages-compiled-stats/ - Статистика показа страницы.

Описание методов

Метод /categories/

GET запрос

Описание:
Возвращает список возможных категорий, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "id": 2147483647,
          "name": "string",
          "parent": 2147483647,
          "active": true
      }
  ]
  

Метод /countries/

GET запрос

Описание:
Возвращает список возможных стран для геотаргетинга, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "id": 0,
          "country": "string",
          "region": "string",
          "city": "string",
          "name": "string"
      }
  ]
  

Метод /languages/

GET запрос

Описание:
Возвращает список возможных языков, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "id": 0,
          "name": "string",
          "translate_name": "string"
      }
  ]
  

Метод /sources/ad/

GET запрос

Описание:
Возвращает список возможных рекламных систем для настройки источников, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "name": "string",
          "default": true,
          "payload": "string",
          "enable": true
      }
  ]
  

Метод /sources/messengers/

GET запрос

Описание:
Возвращает список возможных мессенджеров для настройки источников, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "name": "string",
          "default": true,
          "payload": "string",
          "enable": true
      }
  ]
  

Метод /sources/search/

GET запрос

Описание:
Возвращает список возможных поисковых систем для настройки источников, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "id": 0,
          "name": "string",
          "default": "0.1",
          "payload": "string",
          "enable": true
      }
  ]
  

Метод /sources/social/

GET запрос

Описание:
Возвращает список возможных социальных сетей для настройки источников, которые можно указать при добавлении или редактировании группы.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "name": "string",
          "default": true,
          "payload": "string",
          "enable": true
      }
  ]
  

Метод /user/

GET запрос

Описание:
Возвращает информацию о пользователе: баланс, количество опыта, тип аккаунта, режим работы.

Параметры метода:
нет

Пример ответа:

  
  {
      "user_id": 2147483647,
      "credits": "1.00001",
      "workmode": 32767,
      "type": 32767,
      "experience": 9223372036854776000,
      "token": "string"
  }
  

Метод /user/automode/

POST запрос

Описание:
Устанавливает режим АРК (Автоматическая рекламная кампания) для аккаунта.

Параметры метода:
нет

Пример ответа:
1


Метод /user/manualmode/

POST запрос

Описание:
Устанавливает ручной режим работы для аккаунта.

Параметры метода:
нет

Пример ответа:
1


Метод /group/all/

GET запрос

Описание:
Возвращает список всех групп аккаунта и их настройки, за исключением страниц, входящих в группу.

Параметры метода:
нет

Пример ответа:

  
  [
      {
          "name": "string",
          "hour_limit": 0,
          "day_limit": 0,
          "uniq_ip": 0,
          "moby_ratio": 50,
          "geo": "string",
          "stopping_hours": [
              168
          ],
          "autocalc_visits": false,
          "use_profiles": true,
          "timezone": "Africa/Abidjan",
          "category": 0,
          "language": 0,
          "bookmarks": [
              99,
              99
          ],
          "users": {
              "global": 1,
              "current": 1
          }
      }
  ]
  

Метод /group/{group_id}/

GET запрос

Описание:
Возвращает настройки конкретной группы, где {group_id} - идентификатор группы. Включает страницы, входящие в эту группу. Список идентификаторов групп можно получить GET методом /group/all/

Параметры метода:
нет

Пример ответа:

  
  {
      "name": "string",
      "hour_limit": 0,
      "day_limit": 0,
      "uniq_ip": 0,
      "moby_ratio": 50,
      "geo": "string",
      "stopping_hours": [
          168
      ],
      "autocalc_visits": false,
      "use_profiles": true,
      "timezone": "Africa/Abidjan",
      "category": 0,
      "language": 0,
      "bookmarks": [
          99,
          99
      ],
      "users": {
          "global": 1,
          "current": 1
      }
  }
  

Метод /group/{group_id}/

PATCH запрос

Описание:
Метод редактирует настройки конкретной группы.

 

Параметры метода:

  • name (string): Название группы. Максимальная длина — 255 символов.
  • hour_limit (integer): Часовой лимит.
    • Значение 0 означает, что настройка отключена.
    • Максимальное значение зависит от типа аккаунта.
  • day_limit (integer): Суточный лимит.
    • Значение 0 означает, что настройка отключена.
    • Максимальное значение — 10,000.
  • uniq_ip (integer): Уникальность IP, значение в часах.
    • Значение 0 означает, что настройка отключена.
    • Максимальное значение — 168.
  • moby_ratio (integer): Процентное соотношение типов устройств (0 - 100).
    • 0 означает только ПК, 100 означает только мобильные устройства.
  • geo (array[integer]): Список идентификаторов стран для геотаргетинга.
    • Доступные идентификаторы можно получить с помощью метода /countries/.
  • autocalc_visits (bool): Автоматический расчет часового лимита и интервалов между показами на основе дневного лимита.
  • use_profiles (bool): Профили посетителей с активной поисковой историей, для улучшения поведенческих факторов.
  • retention (bool): Удержание.
  • description (string): Описание группы. Максимальная длина — 100 символов.
  • timezone (string): Часовой пояс в формате TZID (например, "Europe/Moscow").
  • stopping_hours (array[integer]): Часы недели для приостановки показа (от 1 до 168).
  • category (integer): Идентификатор категории.
    • Доступные идентификаторы можно получить с помощью метода /categories/.
  • language (integer): Идентификатор языка сайта.
    • Доступные идентификаторы можно получить с помощью метода /languages/.
  • bookmarks (array[integer]): Процентный диапазон переходов из закладок [от, до].
  • autolimit (array[integer]): Диапазон суточного автоизменения лимита [от, до].
    • Возможные значения от -500 до 500.
  • low_pf (bool): Использовать трафик с низкими поведенческими факторами.
    • Смешанный трафик низкого качества со скидкой 70%.
  • schedules (object): Расписание показа.
    • Включение, или отключение показа страниц группы по расписанию
  • sources (object): Источники посещений.
    • Смешанный трафик низкого качества со скидкой 70%.

 

Параметр schedules (только для VIP аккаунтов):

  • schedules (array): Планировщик заданий. Каждый элемент представляет собой массив, содержащий:
    • Статус (integer):
      • 0 — пауза
      • 1 — возобновить показ.
    • Время срабатывания (string): Время в формате "дд.мм.гггг чч:мм".
    Пример структуры:
            
            "schedules": [
                [
                    1,
                    "07.02.2026 14:17"
                ],
                [
                    0,
                    "08.02.2026 10:00"
                ]
            ]
            
          

Параметр sources (object): Источники посещений

  • Настройки источников посещений. Может содержать следующие элементы:
  1. keywords (object): Переходы из поисковых систем.

    • value (integer): Процент переходов из поисковых систем.
    • enabled (boolean): Использовать источник поисковых систем.
    • settings (object): Дополнительные настройки.
      • list (array[string]): Список ключевых фраз.
      • search_engines (object): Настройки поисковых систем, где:
        • ключ (string): Идентификатор поисковой системы. Список идентификаторов можно получить методом /sources/search/.
        • значение (float): Соотношение использования от 0 до 1.
      Пример структуры:
                    
                    "keywords": {
                        "value": 50,
                        "enabled": true,
                        "settings": {
                            "list": [
                                "example keyword"
                            ],
                            "search_engines": {
                                "1": 0.7,
                                "2": 0.3
                            }
                        }
                    }
                    
                  
  2. adsystems (object): Переходы из рекламных систем.

    • value (integer): Процент переходов из рекламных систем.
    • enabled (boolean): Использовать рекламные системы.
    • settings (array[string]): Список рекламных систем. Полный список рекламных систем можно получить методом /sources/ad/.

    Пример структуры:

            
            "adsystems": {
                "value": 20,
                "enabled": true,
                "settings": [
                    "B2BContext"
                ]
            }
            
          
  3. backlinks (object): Переходы по прямым ссылкам с сайтов.

    • value (integer): Процент переходов по прямым ссылкам.
    • enabled (boolean): Использовать прямые ссылки.
    • settings (object): Дополнительные настройки.
      • list (array[string]): Список обратных ссылок.

    Пример структуры:

            
            "backlinks": {
                "value": 20,
                "enabled": true,
                "settings": {
                    "list": [
                        "https://example.com"
                    ]
                }
            }
            
          
  4. messengers (object): Переходы из мессенджеров.

    • value (integer): Процент переходов из мессенджеров.
    • enabled (boolean): Использовать переходы из мессенджеров.
    • settings (array[string]): Список мессенджеров. Полный список мессенджеров можно получить методом /sources/messengers/.

    Пример структуры:

            
            "messengers": {
                "value": 20,
                "enabled": true,
                "settings": [
                    "telegram"
                ]
            }
            
          
  5. clickunders (object): Переходы с кликандеров и попандеров.

    • value (integer): Процент переходов с кликандеров.
    • enabled (boolean): Использовать кликандеры.

    Пример структуры:

            
            "clickunders": {
                "value": 20,
                "enabled": true
            }
            
          
  6. emailanalytics (object): Переходы с почтовых рассылок.

    • value (integer): Процент переходов из почтовых рассылок.
    • enabled (boolean): Использовать почтовые рассылки.

    Пример структуры:

            
            "emailanalytics": {
                "value": 20,
                "enabled": true
            }
            
          
  7. socialanalytics (object): Переходы из социальных сетей.

    • value (integer): Процент переходов из социальных сетей.
    • enabled (boolean): Использовать социальные сети.
    • settings (array[string]): Список социальных сетей. Полный список можно получить методом /sources/social/.

    Пример структуры:

            
            "socialanalytics": {
                "value": 20,
                "enabled": true,
                "settings": [
                    "pinterest"
                ]
            }
            
          

Пример полного JSON-запроса:

  
  {
      "hour_limit": 100,
      "day_limit": 10000,
      "uniq_ip": 11,
      "moby_ratio": 50,
      "autocalc_visits": true,
      "use_profiles": true,
      "geo": [
          1,
          2,
          3
      ],
      "timezone": "Europe/Moscow",
      "stopping_hours": [
          1,
          2,
          4,
          5,
          7,
          9
      ],
      "category": 1,
      "language": 1,
      "bookmarks": [
          10,
          40
      ],
      "autolimit": [
          -10,
          10
      ],
      "schedules": [
          [
              1,
              "07.02.2026 14:17"
          ],
          [
              0,
              "07.02.2026 15:17"
          ]
      ],
      "sources": {
          "keywords": {
              "value": 50,
              "enabled": true,
              "settings": {
                  "list": [
                      "Поисковая фраза"
                  ],
                  "search_engines": {
                      "1": 1
                  }
              }
          },
          "adsystems": {
              "value": 50,
              "enabled": true,
              "settings": [
                  "B2BContext"
              ]
          }
      }
  }
  

Пример ответа:

  
  {
      "name": "string",
      "hour_limit": 0,
      "day_limit": 0,
      "uniq_ip": 0,
      "moby_ratio": 50,
      "geo": "string",
      "stopping_hours": [
          168
      ],
      "autocalc_visits": true,
      "use_profiles": true,
      "timezone": "Africa/Abidjan",
      "category": 0,
      "language": 0,
      "bookmarks": [
          99,
          99
      ],
      "autolimit": [
          500,
          500
      ],
      "schedules": [
          [
              0,
              "string"
          ]
      ],
      "only_proxy": false,
      "low_pf": false,
      "sources": {
          "keywords": {
              "value": 0,
              "enabled": true,
              "settings": {
                  "list": [
                      "string"
                  ],
                  "search_engines": {
                      "additionalProp1": "string",
                      "additionalProp2": "string",
                      "additionalProp3": "string"
                  }
              }
          },
          "adsystems": {
              "value": 0,
              "enabled": true,
              "settings": [
                  "string"
              ]
          },
          "backlinks": {
              "value": 0,
              "enabled": true,
              "settings": {
                  "list": [
                      "string"
                  ]
              }
          },
          "messengers": {
              "value": 0,
              "enabled": true,
              "settings": [
                  "string"
              ]
          },
          "clickunders": {
              "value": 0,
              "enabled": true
          },
          "emailanalytics": {
              "value": 0,
              "enabled": true
          },
          "socialanalytics": {
              "value": 0,
              "enabled": true,
              "settings": [
                  "string"
              ]
          }
      },
      "interval": [
          10800,
          10800
      ],
      "retention": true,
      "description": "string",
      "pages": [
          {
              "id": 0,
              "state": 0,
              "url": [
                  "string"
              ],
              "showtime": [
                  0
              ],
              "break_chain": 0,
              "adult": true,
              "group_id": 0,
              "behavior": {}
          }
      ],
      "credits": 0,
      "user_id": 1,
      "id": 0
  }
  

Метод /group/{group_id}/

DELETE запрос

Описание:
Удаляет группу и все вложенные страницы.

Параметры метода:
нет

Пример ответа:
1


Метод /group/{group_id}/clone

POST запрос

Описание:
Клонирует группу и все вложенные страницы.

 

Параметры метода:

  • name (string): Название группы. Максимальная длина — 255 символов.

 

Пример ответа:

  
    {
      "name": "string",
      "hour_limit": 0,
      "day_limit": 0,
      "uniq_ip": 0,
      "moby_ratio": 50,
      "geo": "string",
      "stopping_hours": [
        168
      ],
      "autocalc_visits": false,
      "use_profiles": true,
      "timezone": "Africa/Abidjan",
      "category": 0,
      "language": 0,
      "bookmarks": [
        99,
        99
      ],
      "autolimit": [
        500,
        500
      ],
      "schedules": [
        [
          0,
          "string"
        ]
      ],
      "only_proxy": false,
      "low_pf": false,
      "sources": {
        "keywords": {
          "value": 0,
          "enabled": true,
          "settings": {
            "list": [
              "string"
            ],
            "search_engines": {
              "additionalProp1": "string",
              "additionalProp2": "string",
              "additionalProp3": "string"
            }
          }
        },
        "adsystems": {
          "value": 0,
          "enabled": true,
          "settings": [
            "string"
          ]
        },
        "backlinks": {
          "value": 0,
          "enabled": true,
          "settings": {
            "list": [
              "string"
            ]
          }
        },
        "messengers": {
          "value": 0,
          "enabled": true,
          "settings": [
            "string"
          ]
        },
        "clickunders": {
          "value": 0,
          "enabled": true
        },
        "emailanalytics": {
          "value": 0,
          "enabled": true
        },
        "socialanalytics": {
          "value": 0,
          "enabled": true,
          "settings": [
            "string"
          ]
        }
      },
      "interval": [
        10800,
        10800
      ],
      "retention": true,
      "description": "string",
      "pages": [
        {
          "id": 0,
          "state": 0,
          "url": [
            "string"
          ],
          "showtime": [
            0
          ],
          "behavior": false,
          "elements": [
            "string"
          ],
          "clicks": false,
          "break_chain": 0,
          "adult": true,
          "behavior": {},
          "group_id": 0
        }
      ],
      "credits": 0,
      "user_id": 1,
      "id": 0
  }
  

Метод /group/{group_id}/add_credits

POST запрос

Описание:
Зачисляет, или списывает кредиты посещений с баланса оссновного аккаунта на баланс группы. Только в ручном режиме работы.

 

Параметры метода:

  • credits (integer): Количество зачисляемых кредитов посещений. Возможны отрицательные и положительные значения.

 

Пример ответа:
1


Метод /group/create

POST запрос

Описание:
Создаёт новую группу с вложенными страницами

 

Параметры метода:

  • name (string): Название группы. Максимальная длина — 255 символов.
  • hour_limit (integer): Часовой лимит.
    • Значение 0 означает, что настройка отключена.
    • Максимальное значение зависит от типа аккаунта.
  • day_limit (integer): Суточный лимит.
    • Значение 0 означает, что настройка отключена.
    • Максимальное значение — 10,000.
  • uniq_ip (integer): Уникальность IP, значение в часах.
    • Значение 0 означает, что настройка отключена.
    • Максимальное значение — 168.
  • moby_ratio (integer): Процентное соотношение типов устройств (0 - 100).
    • 0 означает только ПК, 100 означает только мобильные устройства.
  • geo (array[integer]): Список идентификаторов стран для геотаргетинга.
    • Доступные идентификаторы можно получить с помощью метода /countries/.
  • autocalc_visits (bool): Автоматический расчет часового лимита и интервалов между показами на основе дневного лимита.
  • use_profiles (bool): Профили посетителей с активной поисковой историей, для улучшения поведенческих факторов.
  • retention (bool): Удержание.
  • description (string): Описание группы. Максимальная длина — 100 символов.
  • timezone (string): Часовой пояс в формате TZID (например, "Europe/Moscow").
  • stopping_hours (array[integer]): Часы недели для приостановки показа (от 1 до 168).
  • category (integer): Идентификатор категории.
    • Доступные идентификаторы можно получить с помощью метода /categories/.
  • language (integer): Идентификатор языка сайта.
    • Доступные идентификаторы можно получить с помощью метода /languages/.
  • bookmarks (array[integer]): Процентный диапазон переходов из закладок [от, до].
  • autolimit (array[integer]): Диапазон суточного автоизменения лимита [от, до].
    • Возможные значения от -500 до 500.
  • low_pf (bool): Использовать трафик с низкими поведенческими факторами.
    • Смешанный трафик низкого качества со скидкой 70%.
  • use_profiles (bool): Использовать профили с активной поисковой историей
  • schedules (object): Расписание показа.
    • Включение, или отключение показа страниц группы по расписанию
  • sources (object): Источники посещений.
  • pages (array): Список вложенных в группу страниц.
    • Описания параматров страницы см. в методе /pages/create/

 

Пример данных:

  
    {
      "name": "Группа 27",
      "hour_limit": 50,
      "day_limit": 10000,
      "uniq_ip": 11,
      "moby_ratio": 50,
      "geo": [1, 2],
      "stopping_hours": [1, 2, 4, 5, 7, 9],
      "autocalc_visits": false,
      "use_profiles": true,
      "timezone": "Europe/Moscow",
      "category": 1,
      "language": 1,
      "schedules": [[1, "07.02.2026 14:17"],[0, "07.02.2026 15:17"]],
      "bookmarks": [10, 40],
      "autolimit": [-10, 10],
      "pages":[{
          "url": ["https://example.com/", "https://example.com/page2"]
      }],
      "sources": {
          "keywords": {
              "value": 1,
              "enabled": true,
              "settings": {
                  "list": ["ключевая фраза 1", "ключевая фраза 2"],
                  "search_engines": {"1": 1.0, "2": 0.5, "3": 0.5}
              }
          },
          "adsystems": {
              "value": 1,
              "enabled": true,
              "settings": ["B2BContext"]
          },
          "backlinks": {
              "value": 1,
              "enabled": true,
              "settings": {
                  "list": ["https://test.com"]
              }
          },
          "messengers": {
              "value": 1,
              "enabled": true,
              "settings": ["telegram","whatsapp"]
          },
          "clickunders": {
              "value": 1,
              "enabled": true
          },
          "emailanalytics": {
              "value": 1,
              "enabled": true
          },
          "socialanalytics": {
              "value": 1,
              "enabled": true,
              "settings": [
                  "instagram",
                  "tiktok",
                  "pinterest"
              ]
          }
      }
  }
  

Метод /page/{page_id}/

GET запрос

Описание:
Возвращает настройки конкретной страницы в группе, где {page_id} - идентификатор страницы. Список идентификаторов страниц в группе можно получить GET методом /group/{group_id}/

Параметры метода:
нет

Пример ответа:

  
    {
      "id": 0,
      "state": 0,
      "url": [
        "string"
      ],
      "showtime": [
        0
      ],
      "break_chain": 0,
      "adult": true,
      "group_id": 0,
      "behavior": {
        "mode": "string",
        "settings": {
            "reading_up": true,
            "clicks": { "list": ["string"] },
            "manual": { "actions": object }
        }
      }
    }
  

Метод /page/{page_id}/

PATCH запрос

Описание:
Редактирует настройки конкретной страницы.

 

Параметры метода:

  • state (integer): Состояние страницы: 0 - на паузе; 1 - в работе.
  • break_chain (integer): Процент вероятности прервать показ на этой странице.
  • url (array string): Список url. Один из них будет выбран случайным образом при показе страницы. Все url должны быть на одном домене.
  • showtime (array integer): Время показа страницы [от, до] в секундах. Минимальное значение - 15 секунд. Максимальное значение зависит от типа аккаунта.
  • behavior (object): Настройка поведения на странице

Параметр behavior (object): Поведение

  • Настройки поведения на странице. Может содержать следующие элементы:
  1. mode (string): Один из возможных режимов поведения

    • disabled: Поведение отключено
    • clicks: Клик по конкретному элементу страницы. Для работы требует настройку в settings
    • fixation: Фиксация посетителя кликом в конце посещения по странице сайта
    • neural: Поведение на странице генерируется нейросетью. Происходит просмотр страниц и перемещение по ссылкам сайта
  2. settings (object): Настройки поведения

    • reading_up (boolean): Дочитывание. Даная настройка добавляет поведение доскролла до нижней части страницы в любом режиме, кроме режима ручной настройки поведения
    • clicks (object): Настройка режима кликов по конкретным элементам
      • list (array[string]): Список CSS-селекторов элементов для клика. Клик будет произведён по одному из селекторов, выбранным из списка случайным образом в начале посещения. Максимальное количество элементов зависит от вашего типа аккаунта.

 

Пример структуры:

 

        "behavior": {
          "mode": "neural",
          "settings": {
              "reading_up": true,
              "clicks": { "list": ["a", ".css-class", "#css-id"] },
          }
        }
        
    

Пример ответа:

  
  {
    "id": 1
  }
  

Метод /page/{page_id}/

DELETE запрос

Описание:
Удаляет страницу.

Параметры метода:
нет

Пример ответа:
1


Метод /page/create

POST запрос

Описание:
Создаёт новую страницу.

 

Параметры метода:

  • group_id (integer): Идентификатор группы, в конец которой будет добавлена страница
  • state (integer): Состояние страницы: 0 - на паузе; 1 - в работе.
  • break_chain (integer): Процент вероятности прервать показ на этой странице.
  • url (array string): Список url. Один из них будет выбран случайным образом при показе страницы. Все url должны быть на одном домене.
  • showtime (array integer): Время показа страницы [от, до] в секундах. Минимальное значение - 15 секунд. Максимальное значение зависит от типа аккаунта.
  • behavior (object): Настройка поведения на странице

 

Пример ответа:

  
  {
      ...
  }
  

Метод /page/{page_id}/clone

POST запрос

Описание:
Копирует страницу внутри группы и помещает новую страницу в конец списка страниц.

Параметры метода:
нет

Пример ответа:
1


Метод /page/{page_id}/up

POST запрос

Описание:
Поднимает страницу на одну позицию вверх в списке страниц группы

Параметры метода:
нет

Пример ответа:
1


Метод /page/{page_id}/down

POST запрос

Описание:
Опускает страницу на одну позицию вниз в списке страниц группы

Параметры метода:
нет

Пример ответа:
1


Метод /page/{page_id}/start

POST запрос

Описание:
Запускает страницу в работу.

Параметры метода:
нет

Пример ответа:
1


Метод /page/{page_id}/stop

POST запрос

Описание:
Останавливает работу страницы.

Параметры метода:
нет

Пример ответа:
1


Метод /pages-compiled-stats/

GET запрос

Описание:
Возвращает статистику показа страницы, или страниц в группе за определённую дату, или за диапазон дат.

Параметры метода:

  • page_id (integer) — ID страницы или
  • group_id (integer) — ID группы.
  • date (string) — Дата в формате ГГГГ-ММ-ДД или
  • date_from (string) — Дата в формате ГГГГ-ММ-ДД и
  • date_to (string) — Дата в формате ГГГГ-ММ-ДД.

Пример ответа:

  
  [
      {
          "page_id": 0,
          "count": 1
      }
  ]