API v2

SMM-HELPER API

Стандартний SMM API v2. Додайте URL і свій ключ до своєї панелі, і послуги, замовлення та статуси підключаться як є.

Базовий URL: https://smm-helper.com/api/v2
Запит: Рекомендовано POST (GET теж працює) · форма (application/x-www-form-urlencoded) або JSON
Авторизація: параметр key у кожному запиті
Відповідь: JSON. Помилки мають вигляд {"error": "message"}
Валюта: USD (списано з вашого балансу)
Ліміт запитів: 300 викликів на хвилину для одного ключа
Баланс: services, deposit, deposit_status і balance працюють до першого поповнення (налаштування панелі, поповнення). Усе інше працює після поповнення
Ключ API: Ключ видається автоматично під час реєстрації

Підключіть свою панель

Будь-яка панель, що підтримує стандартний SMM API v2 (Perfect Panel та інші), може додати нас як постачальника.

1
Додайте постачальника
Admin > Providers > Add. API URL: https://smm-helper.com/api/v2, API key: ваш ключ.
2
Імпортуйте послуги
Завантажте наш список послуг, оберіть послуги та встановіть свою ціну продажу. ID наших послуг не змінюються.
3
Поповніть баланс
Замовлення оплачуються з вашого балансу тут. Поповнюйте в розділі Кабінет > Поповнити баланс.

Приклад коду: додати замовлення

Замовляє 1000 одиниць послуги #2145 (Instagram Real Followers - APP Data - Instant - Speed : 100-300K/D - NoRefill). Замініть YOUR_API_KEY своїм ключем.

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=2145 \
  -d link=https://www.tiktok.com/@yourbrand/video/123 \
  -d quantity=1000

<?php
$ch = curl_init('https://smm-helper.com/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key'      => 'YOUR_API_KEY',
        'action'   => 'add',
        'service'  => 2145,
        'link'     => 'https://www.tiktok.com/@yourbrand/video/123',
        'quantity' => 1000,
    ]),
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $res['order'] ?? $res['error'];

import requests

res = requests.post("https://smm-helper.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2145,
    "link": "https://www.tiktok.com/@yourbrand/video/123",
    "quantity": 1000,
}, timeout=30).json()

print(res.get("order") or res.get("error"))

const res = await fetch("https://smm-helper.com/api/v2", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: process.env.SMM_HELPER_API_KEY,
    action: "add",
    service: 2145,
    link: "https://www.tiktok.com/@yourbrand/video/123",
    quantity: 1000,
  }),
}).then((r) => r.json());

console.log(res.order ?? res.error);

action=services

Список послуг

Усі послуги, які можна замовити. rate: USD за 1000. ID послуг не змінюються, тож ви можете зіставити їх у своїй панелі як є.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"services"

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

Відповідь

[
  {
    "service": 2145,
    "name": "Instagram Real Followers - APP Data - Instant - Speed : 100-300K/D - NoRefill",
    "type": "Default",
    "category": "Instagram - Follower (Working)",
    "rate": "0.308",
    "min": "10",
    "max": "1000000",
    "refill": false,
    "cancel": true
  },
  {
    "service": 2146,
    "name": "Instagram Followers - Old Accounts With Posts - Instant - Speed : 1K/D - NoRefill",
    "type": "Default",
    "category": "Instagram - Follower (Working)",
    "rate": "0.8624",
    "min": "100",
    "max": "10000",
    "refill": false,
    "cancel": true
  },
  …
]

action=add

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

Вартість списується з балансу, і повертається ID замовлення. Якщо частину замовлення неможливо виконати, сума за невиконану кількість повертається на баланс.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"add"
service	Так	ID послуги (service з services)
link	Так	Посилання на профіль, допис, відео або сторінку (або @username для деяких послуг профілю)
quantity	Так	Кількість у межах min і max послуги (не вказуйте для Custom Comments)
comments	Ні	Лише для Custom Comments: коментарі, розділені \n. Кількість рядків дорівнює кількості

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=2145 \
  -d link=https://www.tiktok.com/@yourbrand/video/123 \
  -d quantity=1000

Відповідь

{
  "order": 23501
}

Для послуг Custom Comments (наприклад, #2124) надсилайте коментарі (по одному в рядку) замість кількості.

action=status

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

Прогрес одного замовлення. charge: фактично витрачена сума (після повернень), remains: залишок кількості, progress: відсоток виконання, delivered: виконана кількість. Оновлюється щохвилини.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"status"
order	Так	ID замовлення

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=23501

Відповідь

{
  "charge": "0.31",
  "start_count": "1520",
  "status": "In progress",
  "remains": "240",
  "progress": "76",
  "delivered": "760",
  "currency": "USD"
}

action=status

Статус кількох замовлень

До 100, через кому. Кожне замовлення отримує власний результат; для невідомих ID на їхньому місці повертається помилка.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"status"
orders	Так	ID замовлень через кому (до 100)

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=23501,23502,99999

Відповідь

{
  "23501": {
    "charge": "0.31",
    "start_count": "1520",
    "status": "Completed",
    "remains": "0",
    "progress": "100",
    "delivered": "1000",
    "currency": "USD"
  },
  "23502": {
    "charge": "0.18",
    "start_count": "870",
    "status": "Partial",
    "remains": "400",
    "progress": "60",
    "delivered": "600",
    "currency": "USD"
  },
  "99999": {
    "error": "Incorrect order ID"
  }
}

action=cancel

Скасувати (зупинити) замовлення

Зупиняє замовлення, що виконуються. До запуску: повне повернення; під час виконання: повертається сума за невиконану кількість, і замовлення завершується як Canceled або Partial. Завершені замовлення скасувати неможливо.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"cancel"
orders	Так	ID замовлень через кому (до 100; order також працює для одного)

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=cancel \
  -d orders=23501,23502

Відповідь

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Order is already completed or canceled"
    }
  }
]

action=refill

Поповнення замовлення

Запитує поповнення для виконаного або частково виконаного замовлення на послузі з поповненням. Для одного замовлення може виконуватися одне поповнення, а новий запит можливий через 24 години після попереднього.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"refill"
order	Так	ID замовлення (або orders: до 100 ID через кому)

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill \
  -d order=23501

Відповідь

{
  "refill": 1
}

action=refill_status

Статус поповнення

Статус запитаного поповнення: Pending, In progress, Completed або Rejected.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"refill_status"
refill	Так	ID поповнення (або refills: до 100 ID через кому)

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill_status \
  -d refill=1

Відповідь

{
  "status": "Completed"
}

action=deposit

Створити поповнення балансу

Створює поповнення в USDT (TRC20). Надішліть рівно amount (6 знаків після коми) на address, і кошти буде зараховано автоматично (разом із бонусом, якщо він належить), зазвичай за 1-2 хвилини. Мінімум 25 USD, максимум 5,000 USD, одночасно лише одне поповнення в очікуванні, дійсне до expires_at.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"deposit"
amount	Так	Сума в USD (від 25 до 5,000)

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=deposit \
  -d amount=300

Відповідь

{
  "deposit": "K7Q2M9XD",
  "status": "Pending",
  "currency": "USDT",
  "network": "TRC20",
  "address": "TXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "amount": "300.776583",
  "bonus": "15.03",
  "credited": "0.00",
  "txid": null,
  "created_at": "2026-10-07T06:41:14.203Z",
  "expires_at": "2026-10-07T07:41:14.202Z"
}

action=deposit_status

Статус поповнення балансу

Статус поповнення. Completed означає, що credited і bonus додано на баланс. Pending · Completed · Expired · Canceled · Rejected.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"deposit_status"
deposit	Так	Код поповнення (deposit у відповіді deposit, напр. K7Q2M9XD)

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=deposit_status \
  -d deposit=K7Q2M9XD

Відповідь

{
  "deposit": "K7Q2M9XD",
  "status": "Completed",
  "currency": "USDT",
  "network": "TRC20",
  "address": "TXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "amount": "300.776583",
  "bonus": "15.03",
  "credited": "300.776583",
  "txid": "4c1f…e93a",
  "created_at": "2026-10-07T06:41:14.203Z",
  "expires_at": "2026-10-07T07:41:14.202Z"
}

action=balance

Баланс

Поточний баланс у USD.

Параметр	Обов'язковий	Опис
key	Так	Ваш ключ API
action	Так	"balance"

Запит

curl -X POST https://smm-helper.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

Відповідь

{
  "balance": "1250.40",
  "currency": "USD"
}

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

Pending	Прийнято, скоро запуститься
Processing	Готується
In progress	Виконання триває
Completed	Готово
Partial	Виконано частково; решта повертається на баланс
Canceled	Скасовано; повністю повернуто на баланс

Помилки

Помилки надходять у вигляді {"error": "…"}. Лише помилки ключа та ліміту запитів використовують HTTP 401/429; решта повертають 200.

error	HTTP	Причина
The API is available after your first top-up …	200	До першого поповнення викликано щось інше, ніж services, deposit, deposit_status або balance
Invalid API key	401	Ключ відсутній або неправильний (зокрема старий ключ після перевипуску)
Too many requests	429	Понад 300 викликів на хвилину для одного ключа
Incorrect request	200	action відсутній або невідомий
Incorrect service ID	200	service не є числом
This service is not available.	200	Послуга не продається
Enter the profile, channel or page link, or the @username.	200	link порожній або не є правильним посиланням чи @username (послуги профілю)
Enter the full link to the post, video or page.	200	link порожній або не є правильним посиланням (інші послуги)
Quantity must be between {min} and {max}.	200	quantity поза межами min і max послуги
Please enter at least one comment.	200	Custom Comments без comments
Not enough credit.	200	Недостатньо коштів на балансі (поповніть)
Incorrect order ID	200	Не ваше замовлення або невідомий ID
Order is already completed or canceled	200	cancel: замовлення вже завершено
This order can't be canceled now	200	cancel: система виконання зараз не може його зупинити
Minimum deposit is 25 USDT.	200	deposit: below the minimum
You already have a pending deposit. …	200	deposit: поповнення вже очікує (див. deposit у відповіді)
Incorrect deposit ID	200	deposit_status: не ваш або невідомий код