API для SMM-панелей — підключення за 5 хвилин

Швидкий старт

1

Отримайте ключ

Зареєструйтеся й натисніть «Отримати ключ» у кабінеті, вкладка API. Ключ видається одразу.

2

Поповніть баланс

Замовлення оплачуються з балансу. Якщо коштів бракує, API поверне зрозумілу помилку, а не мовчазну відмову.

3

Зробіть перший запит

Почніть з balance — він нічого не витрачає й одразу показує, що ключ працює.

Загальні правила

Адреса: https://smm-hub.com/api/v2
Метод: POST
Тіло запиту: application/x-www-form-urlencoded
Відповідь: application/json
Авторизація: параметр key у кожному запиті
Валюта: UAH
Одиниця ціни: rate — ціна за 1000 одиниць

Зверніть увагу: на вітрині сайту ціна показана за 1 штуку, а в API — за 1000, як вимагає стандарт. Не переплутайте: різниця в тисячу разів.

Дії

Усі дії розрізняються одним параметром action. Адреса й метод завжди однакові.

action=balance

Поточний баланс і валюта. Нічого не витрачає — зручно для перевірки ключа.

Параметри

key обов'язковий

action обов'язковий

curl -X POST https://smm-hub.com/api/v2 \
  -d "key=YOUR_KEY" \
  -d "action=balance"

$ch = curl_init('https://smm-hub.com/api/v2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => 'YOUR_KEY',
    'action' => 'balance',
]));
$res = json_decode(curl_exec($ch), true);

import requests

r = requests.post('https://smm-hub.com/api/v2', data={
    'key': 'YOUR_KEY',
    'action': 'balance',
})
print(r.json())

Відповідь

{"balance":"100.00","currency":"UAH"}

action=services

Повний перелік послуг із цінами й лімітами. Оновлюйте його раз на добу: ціни й ліміти змінюються.

Параметри

key обов'язковий

action обов'язковий

curl -X POST https://smm-hub.com/api/v2 \
  -d "key=YOUR_KEY" \
  -d "action=services"

$ch = curl_init('https://smm-hub.com/api/v2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => 'YOUR_KEY',
    'action' => 'services',
]));
$res = json_decode(curl_exec($ch), true);

import requests

r = requests.post('https://smm-hub.com/api/v2', data={
    'key': 'YOUR_KEY',
    'action': 'services',
})
print(r.json())

Відповідь

[
  {
    "service": 210,
    "name": "Facebook - Likes on Post (Live)",
    "type": "Default",
    "category": "FaceBook - Likes on a Post",
    "rate": "200.0000",
    "min": "10",
    "max": "500000",
    "refill": true,
    "cancel": false
  }
]

action=add

Створює замовлення й одразу відправляє його в роботу. Гроші списуються з балансу в момент створення.

Параметри

key обов'язковий

action обов'язковий

service обов'язковий

link обов'язковий

quantity обов'язковий

external_id необов'язковий

curl -X POST https://smm-hub.com/api/v2 \
  -d "key=YOUR_KEY" \
  -d "action=add" \
  -d "service=120" \
  -d "link=https://t.me/yourchannel/1" \
  -d "quantity=100" \
  -d "external_id=your-ref-1"

$ch = curl_init('https://smm-hub.com/api/v2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => 'YOUR_KEY',
    'action' => 'add',
    'service' => '120',
    'link' => 'https://t.me/yourchannel/1',
    'quantity' => '100',
    'external_id' => 'your-ref-1',
]));
$res = json_decode(curl_exec($ch), true);

import requests

r = requests.post('https://smm-hub.com/api/v2', data={
    'key': 'YOUR_KEY',
    'action': 'add',
    'service': '120',
    'link': 'https://t.me/yourchannel/1',
    'quantity': '100',
    'external_id': 'your-ref-1',
})
print(r.json())

Відповідь

{"order":106490}

action=status

Стан замовлення. Можна передати до 100 номерів через кому в параметрі orders.

Параметри

key обов'язковий

action обов'язковий

order необов'язковий

orders необов'язковий

curl -X POST https://smm-hub.com/api/v2 \
  -d "key=YOUR_KEY" \
  -d "action=status" \
  -d "order=106490" \
  -d "orders=106490,106491"

$ch = curl_init('https://smm-hub.com/api/v2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => 'YOUR_KEY',
    'action' => 'status',
    'order' => '106490',
    'orders' => '106490,106491',
]));
$res = json_decode(curl_exec($ch), true);

import requests

r = requests.post('https://smm-hub.com/api/v2', data={
    'key': 'YOUR_KEY',
    'action': 'status',
    'order': '106490',
    'orders': '106490,106491',
})
print(r.json())

Відповідь

{
  "charge": "0.86",
  "start_count": "0",
  "status": "Pending",
  "remains": "100",
  "currency": "UAH"
}

action=refill

Заявка на докрутку. Доступна для послуг із гарантією та завершених замовлень.

Параметри

key обов'язковий

action обов'язковий

order обов'язковий

curl -X POST https://smm-hub.com/api/v2 \
  -d "key=YOUR_KEY" \
  -d "action=refill" \
  -d "order=106490"

$ch = curl_init('https://smm-hub.com/api/v2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => 'YOUR_KEY',
    'action' => 'refill',
    'order' => '106490',
]));
$res = json_decode(curl_exec($ch), true);

import requests

r = requests.post('https://smm-hub.com/api/v2', data={
    'key': 'YOUR_KEY',
    'action': 'refill',
    'order': '106490',
})
print(r.json())

Відповідь

{"refill":106490}

action=cancel

Скасування опрацьовує підтримка — напишіть нам, ми повернемо кошти на баланс.

Параметри

key обов'язковий

action обов'язковий

orders обов'язковий

curl -X POST https://smm-hub.com/api/v2 \
  -d "key=YOUR_KEY" \
  -d "action=cancel" \
  -d "orders=106490,106491"

$ch = curl_init('https://smm-hub.com/api/v2');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => 'YOUR_KEY',
    'action' => 'cancel',
    'orders' => '106490,106491',
]));
$res = json_decode(curl_exec($ch), true);

import requests

r = requests.post('https://smm-hub.com/api/v2', data={
    'key': 'YOUR_KEY',
    'action': 'cancel',
    'orders': '106490,106491',
})
print(r.json())

Відповідь

[{"order":106490,"cancel":{"error":"Cancel is processed by support, contact us"}}]

Захист від подвійного замовлення

Передайте свій номер у полі external_id. Якщо зв'язок обірветься і ви повторите запит, ми повернемо те саме замовлення й не спишемо гроші вдруге.

Статуси замовлень

Pendingприйнято, очікує старту

In progressвиконується

Completedвиконано повністю

Partialвиконано частково, різницю повернуто

Canceledскасовано, кошти повернуто

Помилки

Помилка завжди приходить одним полем error. Код відповіді залишається 200 — так вимагає стандарт.

Incorrect API keyключ невірний, вимкнений або акаунт заблоковано

Incorrect service IDпослуги не існує або вона недоступна в API

The minimum quantity is Nкількість поза межами min/max

Not enough funds on balanceне вистачає коштів на балансі

Incorrect requestневідоме значення action

Що ми свідомо не віддаємо

Безкоштовні послуги

Пробники доступні лише на сайті — це наша фішка для нових клієнтів.

Послуги з ручним запуском

Їх запускає людина, і миттєвого старту ми обіцяти не можемо. Замовляйте їх на сайті — там ми чесно показуємо строки.

Пакетні позиції

У них ціна за пакет цілком, а не за 1000 — у стандарті такого поняття немає, тож ми їх не показуємо, щоб не було плутанини з цінами.

Щось не працює

Останні помилки за вашим ключем видно у кабінеті, вкладка API — там же статистика запитів. Якщо не розібралися, напишіть нам.

Написати в Telegram Відкрити вкладку API

Підключіть нас як постачальника

Швидкий старт

Отримайте ключ

Поповніть баланс

Зробіть перший запит

Загальні правила

Дії

Параметри

Параметри

Параметри

Параметри

Параметри

Параметри

Захист від подвійного замовлення

Статуси замовлень

Помилки

Що ми свідомо не віддаємо

Безкоштовні послуги

Послуги з ручним запуском

Пакетні позиції

Щось не працює

Кошик