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

Метод
POST
Формат запроса
JSON
Регистр
Все методы чувствительны к регистру.
URL
https://appinstalls.ru/api
Формат ответа
JSON

В ответе для каждого метода есть error_code - код ошибки и дополнительные параметры. В случае ошибки дополнительные параметры не присутствуют в ответе.

Авторизация

При регистрации каждый пользователь получает уникальные значения userid и secretkey.
Ваши значения userid и secretkey:

userid
secretkey

Внимание! Не сообщайте никому ваши значения userid и secretkey!
Если кто-то узнал эти данные, немедленно смените secretkey, нажав эту ссылку.

Для авторизации необходимо к каждому запросу добавлять параметры userid и secretkey.

Добавление задания

Метод
POST
URL
https://appinstalls.ru/api/addtask

Выполнение данного запрос занимает 5-10 секунд, так как одновременно с ним производится валидация задания. При добавлении в работу последовательно двух одинаковых приложений создадутся два раздельных задания.

Параметр
Описание
Пример
link
Ссылка на задание
https://play.google.com/store/apps/details?id=ru.yandex.taxi
keywords
Поисковый запрос при установке через поиск по ключевой фразе. Если фраза не задана, то null
такси
tracking
Трекинговая ссылка при установке с ее использованием
https://redirect.appmetrica.yandex.com/serve/241305794123973331
targeting.devices
Настройки таргетинга по устройствам. Массив с возможными элементами "phones" - телефоны и "tablets" - планшеты
["phones", "tablets"]
modules.installs
Кол-во заказанных установок
100
modules.launches
Кол-во заказанных дней запуска каждым пользователем, не менее 1
5
modules.reviews
Кол-во заказанных отзывов
100
modules.speed
Ограничение на кол-во установок в день
100
id = 100
id добавленного задания
status = ok
статус после добавления
error_code = 100
auth_error (ошибка авторизации)
error_code = 101
not_found (такое приложение не найдено)
error_code = 102
price_limit (превышен лимит цены приложения 15 руб)
error_code = 103
unknown_error (неизвестная ошибка)
error_code = 104
invalid link (некорректная ссылка)
error_code = 105
invalid params (некорректные параметры задания)
error_code = 106
not enough installs (количество установок меньше минимального)

Возможные статусы задания после добавления

Статус
Описание
ok
Задание добавлено и начало выполняться
notpaid
Задание добавлено, но не начало выполняться (недостаточно средств)
curl \
--data '{"userid" : 123, "secretkey" : "XXXXXXXXXXX", "link" : "https://itunes.apple.com/bestgameever", "keywords" : "game", "tracking" : null, "targeting" : {"devices" : ["phones", "tablets"]}, "modules" : {"installs" : 100, "launches" : 5, "reviews" : 100, "speed" : 100}}' \
--header 'Content-Type: application/json' \
--url https://appinstalls.ru/api/addtask
{
"error_code" : 0,
"id" : 142,
"status" : "ok",
}

Просмотр статуса задания

Метод
POST
URL
https://appinstalls.ru/api/gettask
Параметр
Описание
Пример
id
id задания
142
status = ok
статус задания
progress.installs.done = 100
сделано установок
progress.installs.total = 100
всего заказано установок
progress.launches.done_actual = 100
сделано запусков
progress.launches.total_actual = 700
всего заказано запусков
progress.reviews.done = 30
сделано отзывов
progress.reviews.total = 100
всего заказано отзывов
error_code = 100
auth_error (ошибка авторизации)
error_code = 101
not_found (такое приложение не найдено)
error_code = 103
unknown_error (неизвестная ошибка)

Возможные статусы задания

Статус
Описание
ok
Задание добавлено и начало выполняться
notpaid
Задание добавлено, но не начало выполняться (недостаточно средств)
stopped
Задание остановлено (либо вручную, либо была изменена цена на приложение)
blocked
Приложение исчезло из магазина
Задание завершается, время завершения в формате timestamp, возвращено рублей, заблокировано рублей
Задание завершено, кол-во возвращённых средств
curl \
--data '{"userid" : 123, "secretkey" : "XXXXXXXXXXX", "id" : 142 }' \
--header 'Content-Type: application/json' \
--url https://appinstalls.ru/api/gettask
{
"error_code": 0,
"id": 142,
"status": "ok",
"progress": {
"installs": { "done": 100,
"total": 100,
},
"launches": { "done_days": 1,
"total_days": 7,
"done_actual": 100,
"total_actual": 700
},
"reviews": { "done": 30,
"total": 100,
}
}
}

Удаление задания

Метод
POST
URL
https://appinstalls.ru/api/deletetask
Параметр
Описание
Пример
id
id задания для удаления
142
статус задания после удаления
error_code = 100
auth_error (ошибка авторизации)
error_code = 101
not_found (такое приложение не найдено)
error_code = 103
unknown_error (неизвестная ошибка)

Возможные статусы задания после удаления

Статус
Описание
Задание завершается, время завершения в формате timestamp, возвращено рублей, заблокировано рублей
Задание завершено, кол-во возвращённых средств
curl \
--data '{"userid" : 123, "secretkey" : "XXXXXXXXXXX", "id" : 142 }' \
--header 'Content-Type: application/json' \
--url https://appinstalls.ru/api/deletetask
{ "error_code": 0,
"id": 142,
"status": "[email protected]",
}

Получение стоимости отзывов

Метод
POST
URL
https://appinstalls.ru/api/getreviewprice
Параметр
Описание
Пример
link
Ссылка на задание
https://play.google.com/store/apps/details?id=ru.yandex.taxi
keywords
Поисковый запрос при установке через поиск по ключевой фразе. Если фраза не задана, то null
такси
tracking
Трекинговая ссылка при установке с ее использованием. Если ссылка не задана, то null
https://redirect.appmetrica.yandex.com/serve/241305794123973331
targeting.devices
Настройки таргетинга по устройствам. Массив с возможными элементами "phones" - телефоны и "tablets" - планшеты
["phones", "tablets"]
modules.launches
Количество заказанных дней запуска каждым пользователем. Если параметр не указан, то 1
5
modules.reviews
Количество заказанных отзывов. В соответствии с этим количествовом будет автоматически рассчитано количество установок. Если параметр не указан, то 1
2
cost = 1000
стоимость задания с указанными параметрами
error_code = 100
auth_error (ошибка авторизации)
error_code = 101
not_found (такое приложение не найдено)
error_code = 102
price_limit (превышен лимит цены приложения 15 руб)
error_code = 103
unknown_error (неизвестная ошибка)
error_code = 104
invalid link (некорректная ссылка)
error_code = 105
invalid params (некорректные параметры задания)
curl \
--data '{"userid" : 123, "secretkey" : "XXXXXXXXXXX", "link" : "https://itunes.apple.com/bestgameever", "keywords": "game", "tracking": null, "targeting": { "devices": ["phones", "tablets"] }, "modules": { "launches": 5, "reviews": 100 } }' \
--header 'Content-Type: application/json' \
--url https://appinstalls.ru/api/getreviewprice
{ "cost": 150,
}

Добавления задания на отзывы

Метод
POST
URL
https://appinstalls.ru/api/addreviewtask
Параметр
Описание
Пример
link
Ссылка на задание
https://play.google.com/store/apps/details?id=ru.yandex.taxi
keywords
Поисковый запрос при установке через поиск по ключевой фразе. Если фраза не задана, то null
такси
tracking
Трекинговая ссылка при установке с ее использованием. Если ссылка не задана, то null
https://redirect.appmetrica.yandex.com/serve/241305794123973331
targeting.devices
Настройки таргетинга по устройствам. Массив с возможными элементами "phones" - телефоны и "tablets" - планшеты
["phones", "tablets"]
modules.launches
Количество заказанных дней запуска каждым пользователем. Если параметр не указан, то 1
5
modules.reviews
Количество заказанных отзывов. В соответствии с этим количествовом будет автоматически рассчитано количество установок. Если параметр не указан, то 1
2
id = 100
id добавленного задания
status = ok
статус после добавления
error_code = 100
auth_error (ошибка авторизации)
error_code = 101
not_found (такое приложение не найдено)
error_code = 102
price_limit (превышен лимит цены приложения 15 руб)
error_code = 103
unknown_error (неизвестная ошибка)
error_code = 104
invalid link (некорректная ссылка)
error_code = 105
invalid params (некорректные параметры задания)

Возможные статусы задания после добавления

Статус
Описание
ok
Задание добавлено и начало выполняться
notpaid
Задание добавлено, но не начало выполняться (недостаточно средств)
curl \
--data '{"userid" : 123, "secretkey" : "XXXXXXXXXXX", "link" : "https://itunes.apple.com/bestgameever", "keywords": "game", "tracking": null, "targeting": { "devices": ["phones", "tablets"] }, "modules": { "launches": 5, "reviews": 100 } }' \
--header 'Content-Type: application/json' \
--url https://appinstalls.ru/api/addreviewtask
{ "error_code": 0,
"id": 142,
"status": "ok",
}
AppInstalls

ПРОДВИЖЕНИЕ
МОБИЛЬНЫХ ПРИЛОЖЕНИЙ