General information

Method
POST
Request format
JSON
Case
All methods are case sensitive.
URL
https://appinstalls.ru/api
Response format
JSON

The response for each method contains error_code - the error code and additional parameters. In case of an error, additional parameters are not present in the response.

Authorization

Upon registration, each user receives a unique userid and secretkey.
Your userid and secretkey values:

userid
secretkey

Attention! Don't share your userid and secretkey values with anyone!
If someone found out this data, immediately change the secretkey by clicking this link.

For authorization, you need to add the userid and secretkey parameters to each request.

Adding a task

Method
POST
URL
https://appinstalls.ru/api/addtask

The execution of this request takes 5-10 seconds, since the task is validated simultaneously with it. When two identical applications are added for work in succession, two separate tasks will be created.

Parameter
Description
Example
link
Link to the task
https://play.google.com/store/apps/details?id=ru.yandex.taxi
keywords
Search query when installing through a keyword search. If the keyword is not specified, then null
taxi
tracking
Tracking link when installing using it
https://redirect.appmetrica.yandex.com/serve/241305794123973331
targeting.devices
Device targeting settings. Array with possible elements "phones" - phones and "tablets" - tablets
["phones", "tablets"]
modules.installs
Number of ordered installs
100
modules.launches
Number of launch days by each user ordered, not less than 1
5
modules.reviews
Number of ordered reviews
100
modules.speed
Limit on the number of installs per day
100
id = 100
id of the added task
status = ok
status after adding
error_code = 100
auth_error (authorization error)
error_code = 101
not_found (no such application found)
error_code = 102
price_limit (the app price limit of 15 rubles has been exceeded)
error_code = 103
unknown_error (unknown error)
error_code = 104
invalid link (invalid link)
error_code = 105
invalid params (invalid task parameters)
error_code = 106
not enough installs (the number of installations is less than the minimum)

Possible task statuses after adding

Status
Description
ok
The task has been added and started to run
notpaid
The task was added, but not started (insufficient funds)
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",
}

View task status

Method
POST
URL
https://appinstalls.ru/api/gettask
Parameter
Description
Example
id
task id
142
status = ok
task status
progress.installs.done = 100
installs done
progress.installs.total = 100
total ordered installs
progress.launches.done_actual = 100
launches done
progress.launches.total_actual = 700
total ordered launches
progress.reviews.done = 30
reviews done
progress.reviews.total = 100
total ordered reviews
error_code = 100
auth_error (authorization error)
error_code = 101
not_found (no such application found)
error_code = 103
unknown_error (unknown error)

Possible task statuses

Status
Description
ok
The task has been added and started to run
notpaid
The task was added, but not started (insufficient funds)
stopped
The task was stopped (either manually or the price of the application was changed)
blocked
The app has disappeared from the store
The task ends, the completion time is in timestamp format, rubles are returned, rubles are blocked
The task is completed, the amount of returned funds
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,
}
}
}

Delete task

Method
POST
URL
https://appinstalls.ru/api/deletetask
Parameter
Description
Example
id
id of the task to delete
142
task status after deletion
error_code = 100
auth_error (authorization error)
error_code = 101
not_found (no such application found)
error_code = 103
unknown_error (unknown error)

Possible task statuses after deletion

Status
Description
The task ends, the completion time is in timestamp format, rubles are returned, rubles are blocked
The task is completed, the amount of returned funds
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]",
}

Getting reviews prices

Method
POST
URL
https://appinstalls.ru/api/getreviewprice
Parameter
Description
Example
link
Link to the task
https://play.google.com/store/apps/details?id=ru.yandex.taxi
keywords
Search query when installing through a keyword search. If the keyword is not specified, then null
taxi
tracking
Tracking link when installing using it. If the link is not specified, then null
https://redirect.appmetrica.yandex.com/serve/241305794123973331
targeting.devices
Device targeting settings. Array with possible elements "phones" - phones and "tablets" - tablets
["phones", "tablets"]
modules.launches
The number of launch days by each user ordered. If the parameter is not specified, then 1
5
modules.reviews
The number of reviews ordered. According to this number, the number of installations will be automatically calculated. If the parameter is not specified, then 1
2
cost = 1000
cost of the task with the specified parameters
error_code = 100
auth_error (authorization error)
error_code = 101
not_found (no such application found)
error_code = 102
price_limit (the app price limit of 15 rubles has been exceeded)
error_code = 103
unknown_error (unknown error)
error_code = 104
invalid link (invalid link)
error_code = 105
invalid params (invalid task parameters)
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,
}

Adding a task for reviews

Method
POST
URL
https://appinstalls.ru/api/addreviewtask
Parameter
Description
Example
link
Link to the task
https://play.google.com/store/apps/details?id=ru.yandex.taxi
keywords
Search query when installing through a keyword search. If the keyword is not specified, then null
taxi
tracking
Tracking link when installing using it. If the link is not specified, then null
https://redirect.appmetrica.yandex.com/serve/241305794123973331
targeting.devices
Device targeting settings. Array with possible elements "phones" - phones and "tablets" - tablets
["phones", "tablets"]
modules.launches
The number of ordered launch days by each user. If the parameter is not specified, then 1
5
modules.reviews
The number of reviews ordered. According to this number, the number of installations will be automatically calculated. If the parameter is not specified, then 1
2
id = 100
id of the added task
status = ok
status after adding
error_code = 100
auth_error (authorization error)
error_code = 101
not_found (no such application found)
error_code = 102
price_limit (the app price limit of 15 rubles has been exceeded)
error_code = 103
unknown_error (unknown error)
error_code = 104
invalid link (invalid link)
error_code = 105
invalid params (invalid task parameters)

Possible task statuses after adding

Status
Description
ok
The task has been added and started to run
notpaid
The task was added, but not started (insufficient funds)
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

PROMOTION
OF MOBILE APPS