Документация
Запросы: HTTP GET или POST на https://smm-ua.pro/api/v2, параметры формой. Обязательные в каждом запросе: key (ваш ключ) и action. Ответ: JSON.
Баланс
Параметр Описание
keyВаш API-ключ
actionbalance
Ответ
{
"balance": "100.8400",
"currency": "USD"
}
Список услуг
Параметр Описание
keyВаш API-ключ
actionservices
Ответ
[
{
"service": 1,
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "0.9000",
"min": "50",
"max": "10000",
"refill": true,
"cancel": false,
"dripfeed": true
}
]
Создать заказ
Drip-feed: передайте runs (≥2) и interval - заказ выдаётся порциями. quantity при этом трактуется как объём на один прогон, общий объём = quantity × runs; размер порции должен быть в пределах min-max услуги.
Набор параметров зависит от типа услуги: он приходит полем type в списке услуг.
Default - Обычный
Custom Comments - Свои комментарии
SEO - SEO
Mentions Hashtag - Упоминания по хэштегу
Web Traffic - Трафик на сайт
Package - Пакет
Custom Comments Package - Пакет своих комментариев
Mentions - Упоминания
Mentions Custom List - Упоминания по списку аккаунтов
Mentions User Followers - Упоминания подписчиков аккаунта
Mentions with Hashtags - Упоминания по аккаунтам и хэштегам
Mentions Media Likers - Упоминания лайкнувших медиа
Comment Likes - Лайки на комментарий
Comment Replies - Ответы на комментарии
Poll - Голоса в опросе
Invites from Groups - Приглашения из групп
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
runs
Число прогонов (необязательно)
Нет
interval
Интервал в минутах (необязательно)
Нет
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
comments
По одному комментарию в строке. Количество заказа равно числу строк. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
keywords
По одному ключевому слову в строке. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
hashtag
Хэштег, из которого провайдер соберёт аудиторию.
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
country
Код или название страны: US или United States.
Да
device
Устройство. Возможные значения: 1 - Десктоп, 2 - Мобильные (Android), 3 - Мобильные (iOS), 4 - Смешанно (мобильные), 5 - Смешанно (мобильные и десктоп).
Да
type_of_traffic
Тип трафика. Возможные значения: 1 - Ключевое слово Google, 2 - Свой реферер, 3 - Без реферера.
Да
google_keyword
Ключевое слово. Обязателен при type_of_traffic = 1.
Нет
referring_url
Реферер. Обязателен при type_of_traffic = 2.
Нет
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
comments
По одному комментарию в строке. Количество равно числу строк. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
usernames
По одному аккаунту в строке. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
usernames
По одному аккаунту в строке. Количество равно числу строк. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
username
Аккаунт, из подписчиков которого провайдер соберёт аудиторию.
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
usernames
По одному аккаунту в строке. Разделитель - перевод строки (\r\n или \n).
Да
hashtags
По одному хэштегу в строке. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
media
Медиа, из лайкнувших которое провайдер соберёт аудиторию.
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
username
Аккаунт автора комментария, которому ставят лайки.
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
username
Аккаунт, от чьего имени оставляют ответы.
Да
comments
По одному ответу в строке. Количество равно числу строк. Разделитель - перевод строки (\r\n или \n).
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
answer_number
Порядковый номер варианта ответа в опросе.
Да
Параметр Описание Обяз.
key
Ваш API-ключ
Да
action
add
Да
service
ID услуги
Да
link
Ссылка на страницу
Да
quantity
Нужное количество
Да
groups
По одной группе в строке. Разделитель - перевод строки (\r\n или \n).
Да
Ошибка
{
"error": "Not enough funds on balance"
}
Статус заказа
Можно передать order (один заказ) или orders - через запятую (пакетно). При пакетном запросе ответ: объект вида «номер → результат».
Параметр Описание
keyВаш API-ключ
actionstatus
orderID заказа (один)
ordersID заказов через запятую, напр. 1,2,3
Ответ (один заказ)
{
"charge": "0.27",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
}
Ответ (несколько)
{
"1": {
"charge": "0.27",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"2": { "error": "Incorrect order ID" }
}
Возможные статусы заказа
Pending
In progress
Completed
Partial
Canceled
Отмена заказа
Параметр Описание
keyВаш API-ключ
actioncancel
orderID заказа (один)
ordersID заказов через запятую, напр. 1,2,3
Ответ (несколько)
[
{ "order": 1, "cancel": 1 },
{ "order": 2, "cancel": { "error": "Order is already completed" } }
]
Рефилл (докрутка)
Параметр Описание
keyВаш API-ключ
actionrefill
orderID заказа (один)
ordersID заказов через запятую, напр. 1,2,3
Ответ (несколько)
[
{ "order": 1, "refill": 2 },
{ "order": 2, "refill": { "error": "Incorrect order ID" } }
]
Статус рефилла
Параметр Описание
keyВаш API-ключ
actionrefill_status
refillID рефилла (один) - тот, что вернул action=refill
refillsID рефиллов через запятую, напр. 1,2,3
orderID заказа - вернёт статус последнего рефилла по нему
ordersID заказов через запятую - по последнему рефиллу на каждый
Ответ
{
"status": "Completed"
}
Ответ (несколько)
[
{ "refill": 1, "status": "Completed" },
{ "refill": 2, "status": { "error": "Refill not found" } }
]
Возможные ошибки
Сообщение Причина
Incorrect API keyКлюч не найден или неверный
Incorrect actionНеизвестное значение action
Incorrect parametersНе передан service или link
Incorrect service IDУслуга не найдена или отключена
Incorrect order IDЗаказ не найден или принадлежит другому пользователю
Not enough funds on balanceНедостаточно средств на балансе
No refill for this orderПо заказу не запрашивался рефилл
Refill not foundРефилла с таким ID нет или он не ваш
Пример (cURL)
curl -X POST https://smm-ua.pro/api/v2 \
-d key=YOUR_API_KEY \
-d action=add \
-d service=1 \
-d link=https://instagram.com/username \
-d quantity=1000