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

Формат запроса

Все запросы выполняются на URL: https://seo-task.com/api/v1/ (GET, POST, JSON), в каждом запросе должны присутствовать обязательные 2 параметра api_key и method. По их содержимому производится авторизация и вызов метода.

Параметр Требуется Тип Описание
api_key Да string API ключ (получить)
method Да string Метод API

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

В ответ выдаётся JSON строка, содержащая массив в котором всегда будет присутствовать как минимум 1 элемент.

Параметр Тип Описание
success bool true - запрос успешно выполнен.
false - ошибка выполнения запроса.
error->code int Код ошибки, если success отличен от true
1хx - ошибка на этапе авторизации.
2хх - ошибка на этапе выполнения API метода.
error->message string Текст поясняющий ошибку, если success отличен от true
Пример ответа с ошибкой
{
    "success":false,
    "error":{
        "code":101,
        "message":"Описание ошибки"
    }
}

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

method Описание
getAccount Информация о владельце API ключа
create Создание компании
edit Редактирование компании
getInfo Информация о компании
getInfoList Информация о компании (массовая)
addBalance Добавить выполнения
changeStatus Изменить статус компании
refundBalance Возврат остатка средств
delete Удаление компании

Метод getAccount

Описание: выдаёт базовую информацию о владельце API ключа.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: getAccount
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"getAccount"
}
Пример успешного ответа
{
    "success":true,
    "balance":13948.1,
    "currency":"RUB"
}
Параметры ответа
Параметр Тип Описание
balance float Баланс в рублях
currency string Валюта RUB

Метод create

Описание: создание новой рекламной компании.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: create
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
amount Да int Количество выполнений
link Да string Ссылка на рекланую компанию (Сайт, Youtube, Rutube)
timer Нет int Таймер для типа serf, view_youtube, viewjump_youtube, view_rutube (в секундах), без установки назначается оптимальный.

Доступные значение:
5, 10, 15, 20, 25, 30, 35, 40, 50, 60, 90, 120, 180, 240, 300
5 - (по умолчанию)
title Нет string Краткое описание компании
source Нет int Источник трафика для типа serf, view_youtube, view_rutube (подробнее)
texno Нет int Технология просмотра для типа serf, view_youtube, viewjump_youtube, view_rutube

Доступные значение:
1 - раз в 1 час
6 - раз в 6 часов
12 - раз в 12 часов
24 - раз в 24 часа (по умолчанию)
proxy Нет int Запретить Proxy и VPN

Доступные значение:
0 - Нет (по умолчанию)
1 - Да
device Нет int Показ только для устройств

Доступные значение:
0 - отключено (по умолчанию)
1 - ПК / Ноутбук
2 - Мобильный телефон / Планшет
target Нет int Ограничение по геотаргетингу

Доступные значение:
0 - отключено (по умолчанию)
1 - все кроме указанных стран
2 - только указанные страны
target_code Нет string Список стран. Указываются текстовые значения в формате ISO, разделенные знаком запятой (пример ru,ua,ge)
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"create",
    "type":"view_youtube",
    "link":"https://www.youtube.com/shorts/QRYjCEIDMkk",
    "title":"Test",
    "amount":1000,
    "timer":10
}
Пример успешного ответа
{
    "success":true,
    "id":1,
    "type":"view_youtube",
    "balance":25,
    "startCount":100
}
Параметры ответа
Параметр Тип Описание
id int ID компании
type string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
balance float Баланс компании (в рублях)
startCount int Количества действий на момент создания компании. Для типа view_youtube, viewjump_youtube, sub_youtube, like_youtube, в остальных типах будет показан 0

Метод edit

Описание: редактирование компании.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: edit
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id Да int ID компании
title Нет string Краткое описание компании
source Нет int Источник трафика (подробнее)
texno Нет int Технология просмотра для типа serf, view_youtube, view_rutube

Доступные значение:
1 - раз в 1 час
6 - раз в 6 часов
12 - раз в 12 часов
24 - раз в 24 часа (по умолчанию)
device Нет int Показ только для устройств

Доступные значение:
0 - отключено (по умолчанию)
1 - ПК / Ноутбук
2 - Мобильный телефон / Планшет
target Нет int Ограничение по геотаргетингу

Доступные значение:
0 - отключено (по умолчанию)
1 - все кроме указанных стран
2 - только указанные страны
target_code Нет string Список стран. Указываются текстовые значения в формате ISO, разделенные знаком запятой (пример ru,ua,ge)
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"edit",
    "type":"view_youtube",
    "id":1,
    "title":"Test new",
    "device":1
}
Пример успешного ответа
{
    "success":true
}

Метод getInfo

Описание: вывод информацию о компании, если не указывать id выведет список существующих компаний.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: getInfo
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id Да int ID компании
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"getInfo",
    "type":"view_youtube",
    "id":1
}
Пример успешного ответа
{
    "success":true,
    "list":[
        {
            "id":1,
            "status":0,
            "status_msg":"active",
            "type":"view_youtube",
            "amount":999,
            "amountDone":1,
            "balance":29.97,
            "link":"gFn434YBq7k",
            "title":"Test",
            "timer":10,
            "price_u":0.02,
            "price_r":0.03,
            "status_ban":false,
            "startCount": 100,
            "source": 0,
            "texno": 0,
            "proxy": 0,
            "device": 0,
            "inter":0,
            "inter_data":"",
            "target":0,
            "target_code":""
        }
    ]
}
Параметры ответа
Параметр Тип Описание
list array Массив списка компаний
Параметры в массиве list
id int ID компании
status int 0 - компания остановлена, не активна
1 - компания активная, в работе
2 - компания заблокирована
status_msgstring active - компания активная, в работе
completed - компания остановлена, не активна
ban - компания остановлена, заблокирована
typestring serf - просмотр сайтов
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
amount int Осталось выполнений компании
amountDone int Сколько исполнений компании уже было
balance float Баланс компании (в рублях)
link string Ссылка на рекланую компанию
title string Заголовок компании
timer int Таймер для типа serf, view_youtube, view_rutube (в секундах)
price_ufloat Цена оплаты исполнителю
price_r float Цена оплаты за одно действие компании
status_ban bool Компания заблокирована
true - да false - нет
startCountint Количества действий на момент создания компании. Для типа view_youtube, sub_youtube, like_youtube, в остальных типах будет показан 0
source int Источник трафика (подробнее)
texno int Технология просмотра для типа serf, view_youtube, view_rutube

Доступные значение:
1 - раз в 1 час
6 - раз в 6 часов
12 - раз в 12 часов
24 - раз в 24 часа
proxy int Запретить Proxy и VPN

Доступные значение:
0 - Нет
1 - Да
device int Показ только для устройств

Доступные значение:
0 - отключено
1 - ПК / Ноутбук
2 - Мобильный телефон / Планшет
inter int Интервал раздачи

Доступные значение:
0 - отключено
1 - фиксированный интервал
2 - по каждому часу
inter_data int
string
Настроки интервала (подробнее)
target int Ограничение по геотаргетингу

Доступные значение:
0 - отключено
1 - все кроме указанных стран
2 - только указанные страны
target_code string Список стран. Указываются текстовые значения в формате ISO, разделенные знаком запятой (пример ru,ua,ge)

Метод getInfoList

Описание: вывод информацию о нескольких компаниях.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: getInfoList
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id_list Да string ID компаний через запятую (до 100 ID компаний)
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"getInfoList",
    "type":"view_youtube",
    "id_list":"1,2"
}
Пример успешного ответа
{
    "success":true,
    "list":[
        "1": {
            "id":1,
            "status":0,
            "status_msg":"active",
            "type":"view_youtube",
            "amount":999,
            "amountDone":1,
            "balance":29.97,
            "link":"gFn434YBq7k",
            "title":"Test",
            "timer":10,
            "price_u":0.02,
            "price_r":0.03,
            "status_ban":false,
            "startCount": 100,
            "source": 0,
            "texno": 0,
            "proxy": 0,
            "device": 0,
            "inter":0,
            "inter_data":"",
            "target":0,
            "target_code":""
        },
        "2": {
            "id":2,
            "status":0,
            "status_msg":"active",
            "type":"view_youtube",
            "amount":999,
            "amountDone":1,
            "balance":29.97,
            "link":"gFn434YBq7k",
            "title":"Test",
            "timer":10,
            "price_u":0.02,
            "price_r":0.03,
            "status_ban":false,
            "startCount": 100,
            "source": 0,
            "texno": 0,
            "proxy": 0,
            "device": 0,
            "inter":0,
            "inter_data":"",
            "target":0,
            "target_code":""
        }
    ]
}
Параметры ответа
Параметр Тип Описание
list array Массив списка компаний
Параметры в массиве list описаны в методе getInfo

Метод addBalance

Описание: пополнение баланса компании.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: addBalance
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id Да int ID компании
amount Да int Количество выполнений компании
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"addBalance",
    "type":"view_youtube",
    "id":1,
    "amount":1000
}
Пример успешного ответа
{
    "success":true,
    "balance":25.43
}
Параметры ответа
Параметр Тип Описание
balance float Сумма в рублях которая была внесена на баланс компании

Метод changeStatus

Описание: управление компанией (остановка, запуск)

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: changeStatus
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id Да int ID компании
status Да int Запустить или остановить компанию

Доступные значение:
0 - Остановить
1 - Запустить
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"changeStatus",
    "type":"view_youtube",
    "id":1,
    "status":1
}
Пример успешного ответа
{
    "success":true,
    "status":"active"
}
Параметры ответа
Параметр Тип Описание
status string Статус компании:
active - компания активная, в работе
completed - компания остановлена, не активна

Метод refundBalance

Описание: возврат неизрасходованных средств, на рекламный счет.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: refundBalance
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id Да int ID компании
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"refundBalance",
    "type":"view_youtube",
    "id":1
}
Пример успешного ответа
{
    "success":true,
    "balance":21.35
}
Параметры ответа
Параметр Тип Описание
balance float Сумма в рублях которая была возвращена на рекламный счет

Метод delete

Описание: удаление компании. Перед удаление рекламную компанию нужно остановить и подождать 10 минут.

Параметры для запроса
Параметр Требуется Тип Описание
api_key Да string API ключ
method Да string Метод API: delete
type Да string Тип рекламной компании

Доступные значение:
serf - просмотр сайтов (по умолчанию)
view_youtube - просмотр видео Youtube
viewjump_youtube - переход на Youtube test
view_rutube - просмотр видео Rutube
id Да int ID компании
Пример запроса
{
    "api_key":"00000000-04567f3f4a06359xxxxx",
    "method":"delete",
    "type":"view_youtube",
    "id":1
}
Пример успешного ответа
{
    "success":true,
    "balance":0
}
Параметры ответа
Параметр Тип Описание
balance float Сумма в рублях которая была возвращена на рекламный счет
seo-task.com использует файлы Cookie с целью персонализации сервисов и повышения удобства пользования веб-сайтом. Подробности в политике конфиденциальности.
×