API-ключ
Войдите в аккаунт, чтобы получить API-ключ.
Для активации реселлер-API напишите в службу поддержки. На балансе должно быть не менее 100 долларов.
URL
https://mrpopular.net/api/v3.php
Запрос
POST / GET / JSON
Ответ
JSON
Авторизация
username
password
key = API-ключ со страницы документации в аккаунте (вместо username и password)
Получить баланс
action = balance
{"balance":123.456}
Статус заказа
action = status
order = (Order id)
{"order":{"status":"2","completed":"0","quantity":"250","date":"2018-09-27 17:34:49"}}
order = 142058,142059 (несколько номеров через запятую, до 100 за запрос; ответ по каждому номеру в поле orders)
{"orders":{"142058":{"status":"2","completed":"250","quantity":"250","date":"2026-10-01 12:00:00"},"142059":{"error":"wrong ORDER"}}}
Отменить заказ
action = cancel
order = номер заказа
{"cancel":{"order":142058,"cancelled":true,"delivered":40,"refund":12.5,"currency":"RUB"}}
Доступно для части услуг (в v3 почти для всех), пока заказ выполняется: возвращается стоимость невыполненной части. Если для услуги отмена недоступна, ответ errorcode 13; для завершённых или ещё не запущенных заказов errorcode 14.
Восполнение (рефилл)
action = refill
order = номер заказа
{"refill":{"order":142058,"status":"requested","message":"refill requested"}}
Только услуги с восполнением, то же, что кнопка в истории заказов. status: requested запущено, in_progress уже идёт, wait_24h не чаще раза в сутки, expired срок вышел, queued в очереди оператору. Без восполнения errorcode 16.
Дополнительное поле услуги
action = options
service = ID услуги
{"service_id":6671,"option_type":"rating","option_label":"...","comment_label":"...","options":{"201":"5","202":"4-5"}}
option_type: none (поля нет), text (свободный текст в option), select, geo, rating, topic (в option id из options; для topic значение 0 = своя тема текстом в comment). Те же option_type, option_label и comment_label есть в ответе action=service.
Спор по выполнению
action = dispute
order = номер заказа (позиции) из истории заказов
execution = id выполнения из action=executions
reason = причина, от 5 символов: что не так на скриншоте (не тот пост, не тот текст, действие не показано)
{"status":"pending","dispute":{"id":12,"status":"pending","created":"2026-10-24 12:00:00","decided":null},"execution":34099021,"order":594181140,"dispute_budget":{"turnover_rub":50659.56,"limit_rub":10131.91,"used_rub":29.8,"available_rub":10102.11,"min_per_dispute_rub":5,"percent":20,"days":90,"window_days":30}}
Только для заказов, выполняемых реальными исполнителями, и только для принятых выполнений не старше 30 дней. Спор разбирает арбитраж, обычно в течение суток; результат виден в action=executions, поле dispute.status: pending (на разборе), confirmed (брак подтверждён: выполнение снято и будет сделано заново), rejected (выполнение соответствует заданию), neutral (без изменений). Лимит: оспорить можно выполнения на сумму до 20% ваших оплаченных заказов за 90 дней; каждый спор бронирует из лимита цену единицы заказа, но не меньше 5 руб; confirmed бронь возвращает, rejected и neutral тратят. Остаток лимита в dispute_budget.
errorcode 21 заказ выполняется не реальными исполнителями (спор недоступен), errorcode 23 wrong EXECUTION (нет в этом заказе), 24 выполнение не принято, 25 срок оспаривания истёк, 26 уже оспорено, 27 REASON короче 5 символов, 28 лимит исчерпан (dispute_budget в ответе).
Выполнения заказа (скриншоты)
action = executions
order = (Order id)
offset = (optional, default 0)
limit = (optional, default 100, max 500)
{"total":3,"count":1,"offset":0,"executions":[{"id":34099021,"executor":"ID972036","date":"2026-06-25 20:32:40","screenshots":["https://mrpopular.net/etask/includes/img/...jpg"],"links":[],"dispute":null}],"dispute_budget":{"limit_rub":10131.91,"used_rub":29.8,"available_rub":10102.11}}
id выполнения нужен для action=dispute; dispute: состояние спора по выполнению или null; dispute_budget: лимит споров аккаунта.
Только для заказов, выполненных живыми исполнителями. В "links" - ссылки, которые исполнители оставили в отчётах (беклинк-задания).
Список услуг
action = service
{"service":{"1":{"social_network":"Facebook","service":"page likes","quality":"medium quality","id":"1","price":0.0149,"currency":"USD","min":"100","max":"900000","start":"30 min.","speed":"100/day","description":"HQ never drop"},...}}
Расшифровка статусов заказа
0 : Pending / Processing
1 : Processing
2 : Completed
3 : Error
4 : In queue
5 : Returned
Новый заказ
action = order
service = (Service ID)
quantity
option = дополнительное поле услуги: id из action=options (тема комментариев, оценка отзыва, гео, вариант опроса) или текст (ник автора комментария, поисковый запрос); какое поле у услуги, видно в option_type и option_label
comment = тексты комментариев или отзывов (каждый с новой строки), либо ТЗ для ИИ-отзыва, либо своя тема для тематических комментариев (при option=0); что ждут от поля, видно в comment_label
link
lang = язык исполнителя для части услуг: any, ru или en (по умолчанию любой)
gender = пол автора отзыва для части услуг: any, m, f (по умолчанию любой)
day_limit = лимит выполнений в день для части услуг, 0 = без лимита
{"order":"142058"}
Ошибки
{"errorcode":0} API is not activated
{"errorcode":1} USERNAME or PASSWORD is empty
{"errorcode":2} ACTION is empty
{"errorcode":4} ORDER is empty
{"errorcode":5} wrong ORDER
{"errorcode":6} SERVICE is empty
{"errorcode":7} QUANTITY is empty
{"errorcode":8} LINK is empty
{"errorcode":9} Not enough funds on balance
{"errorcode":10} Quantity less than minimum
Пример кода на PHP
class Api
{
public $api_url = 'https://mrpopular.net/api/v3.php';
public $username = ''; // your username
public $password = ''; // your password
public function order($data) {
return json_decode($this->connect(array_merge(array(
'username' => $this->username,
'password' => $this->password,
'action' => 'order'
), $data)));
}
public function status($order) {
return json_decode($this->connect(array(
'username' => $this->username, 'password' => $this->password,
'action' => 'status', 'order' => $order)));
}
public function executions($order, $offset = 0, $limit = 100) {
return json_decode($this->connect(array(
'username' => $this->username, 'password' => $this->password,
'action' => 'executions', 'order' => $order,
'offset' => $offset, 'limit' => $limit)));
}
public function service() {
return json_decode($this->connect(array(
'username' => $this->username, 'password' => $this->password,
'action' => 'service')));
}
public function balance() {
return json_decode($this->connect(array(
'username' => $this->username, 'password' => $this->password,
'action' => 'balance')));
}
function connect($post) {
$ch = curl_init($this->api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$result = curl_exec($ch);
return $result === false ? false : $result;
}
}
$api = new Api();
// $balance = $api->balance();
// $order = $api->order(array('service' => 462, 'quantity' => 100, 'link' => 'https://...'));
// $status = $api->status(142058);
// $shots = $api->executions(142058);
// $services = $api->service();