API

HTTP MethodPOST
API URLhttps://smmuzi.ru/api/v2
Data formatJSON
Service listaction = services
Parameter Explanation
key Your API key
action services
Sample return
[
  {
    "service": 1,
    "name": "Followers",
    "type": "Default",
    "category": "First Category",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  },
  {
    "service": 2,
    "name": "Comments",
    "type": "Custom Comments",
    "category": "Second Category",
    "rate": "8",
    "min": "10",
    "max": "1500",
    "refill": false,
    "cancel": false
  }
]
New orderaction = add
Parameter Explanation
key Your API key
action add
service Service ID
link Link to page
quantity Needed quantity
runs (optional) Runs
interval (optional) Interval in minutes
Sample return
{
  "order": 23501
}
Retry without a duplicate order (Idempotency-Key)action = add
You can attach a key to action=add — the Idempotency-Key header or the idempotency_key field: a string of up to 128 Latin letters, digits and symbols without spaces, new for every order. If the response is lost and you repeat the request with the same key and the same parameters within 24 hours, you get the same order ID: no second order and no second charge.
Parameter Explanation
Idempotency-Key / idempotency_key Key of this order (header or field), up to 128 characters
HTTP 200 a repeat with the same key and parameters gets the same response (the same order ID) and the Idempotent-Replayed: true header
status 122 the key was already used for a request with different parameters — no order is created
HTTP 429, status 123 the first request with this key is still running — retry after Retry-After seconds
HTTP 500, status 124 the result of the first request is unknown — check your orders before sending a new one
HTTP 500, status 125 the first request may have charged money without an order — manual check via support; send a new order with a new key
Request rate limit
Up to 600 requests per minute per key, of which up to 30 action=services requests. Above the limit the response is HTTP 429, the Retry-After header (seconds to wait) and JSON with status 120. After 30 invalid keys per minute from one IP, further invalid keys from it also get 429; requests with a valid key are not affected by this count.
Response above the limit — HTTP 429, Retry-After
{
  "error": "…",
  "status": "120"
}
Order statusaction = status
Parameter Explanation
key Your API key
action status
order Order ID
Sample return
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "USD"
}
Multiple orders statusaction = status
Parameter Explanation
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)
Sample return
{
  "1": {
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
  },
  "10": {
    "error": "Incorrect order ID"
  },
  "100": {
    "charge": "1.44219",
    "start_count": "234",
    "status": "In progress",
    "remains": "10",
    "currency": "USD"
  }
}
Create refillaction = refill
For completed orders of services with refill (refill: true in the service list), within the guarantee period, no more than once a day. Returns the refill ID.
Parameter Explanation
key Your API key
action refill
order Order ID
orders Use instead of order: up to 100 order IDs as a comma-separated string or JSON array. External calls share a 30-second budget. The response contains one result per ID.
Sample return
{
  "refill": 1
}
Refill statusaction = refill_status
Possible statuses: Pending, Accepted, In progress, Completed, Rejected.
Parameter Explanation
key Your API key
action refill_status
refill Refill ID (returned by refill)
refills Use instead of refill: up to 100 refill request IDs as a comma-separated string or JSON array. Unknown or foreign IDs return not_found individually.
Sample return
{
  "status": "Completed"
}
Create cancelaction = cancel
For services with cancellation (cancel: true in the service list) and orders in Pending, In progress or Processing status. The request is reviewed by the administration; the outcome is shown in the order status: Canceled means the funds were returned to the balance. A repeated request for the same order does not create a new request and returns the same ID.
Parameter Explanation
key Your API key
action cancel
order Order ID
Sample return
{
  "cancel": 1
}
Cancel multiple ordersaction = cancel
One entry per order: the cancellation request ID or an error.
Parameter Explanation
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)
Sample return
[
  {
    "order": 9,
    "cancel": {"error": "Incorrect order ID"}
  },
  {
    "order": 2,
    "cancel": 1
  }
]
User balanceaction = balance
Parameter Explanation
key Your API key
action balance
Sample return
{
  "balance": "100.84292",
  "currency": "USD"
}