SMM World — Social Media Marketing

SMM Panel API Documentation

A single REST endpoint to place orders, check status, pull balance and browse services — built for resellers, agencies, and developers automating growth across every platform SMM World supports.

HTTP Method
POST
API URL
https://my.smmworld.org/api/v2
Response Format
JSON

Authentication

Every request is authenticated with your personal API key, found in your dashboard under Account → API. Send it as a key field in the POST body — never as a URL query parameter.

All requests are POST, all bodies and responses are application/json. Keep your API key secret — regenerate it immediately from your dashboard if it's ever exposed.

POST

Add Order

Place a new order. Parameters vary by order type — select a type below.

Parameters
keyYour API key
actionadd
serviceService ID
linkLink to page
quantityNeeded quantity
runs (optional)Runs to deliver
interval (optional)Interval in minutes
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "add",
6    "service": 1,
7    "link": "https://example.com/username",
8    "quantity": 1000
9  }'
Example Response
1{
2  "order": 23501
3}
POST

Service List

Pull the full, current list of services, categories, rates, and min/max limits.

Parameters
keyYour API key
actionservices
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "services"
6  }'
Example Response
1[
2  {
3    "service": 1,
4    "name": "Followers",
5    "type": "Default",
6    "category": "First Category",
7    "rate": "0.90",
8    "min": "50",
9    "max": "10000",
10    "refill": true,
11    "cancel": true
12  },
13  {
14    "service": 2,
15    "name": "Comments",
16    "type": "Custom Comments",
17    "category": "Second Category",
18    "rate": "8",
19    "min": "10",
20    "max": "1500",
21    "refill": false,
22    "cancel": true
23  }
24]
POST

Order Status

Check the delivery status and remaining quantity for a single order.

Parameters
keyYour API key
actionstatus
orderOrder ID
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "status",
6    "order": 23501
7  }'
Example Response
1{
2  "charge": "0.27819",
3  "start_count": "3572",
4  "status": "Partial",
5  "remains": "157",
6  "currency": "USD"
7}
POST

Multiple Orders Status

Check the status of up to 100 orders in a single call.

Parameters
keyYour API key
actionstatus
ordersOrder IDs (separated by a comma, up to 100 IDs)
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "status",
6    "orders": "1,10,100"
7  }'
Example Response
1{
2  "1": {
3    "charge": "0.27819",
4    "start_count": "3572",
5    "status": "Partial",
6    "remains": "157",
7    "currency": "USD"
8  },
9  "10": {
10    "error": "Incorrect order ID"
11  },
12  "100": {
13    "charge": "1.44219",
14    "start_count": "234",
15    "status": "In progress",
16    "remains": "10",
17    "currency": "USD"
18  }
19}
POST

Create Refill

Submit a refill request for an eligible order (see Terms of Service for eligibility).

Parameters
keyYour API key
actionrefill
orderOrder ID
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "refill",
6    "order": 23501
7  }'
Example Response
1{
2  "refill": "1"
3}
POST

Create Multiple Refill

Submit refill requests for up to 100 eligible orders in a single call.

Parameters
keyYour API key
actionrefill
ordersOrder IDs (separated by a comma, up to 100 IDs)
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "refill",
6    "orders": "1,2,3"
7  }'
Example Response
1[
2  {
3    "order": 1,
4    "refill": 1
5  },
6  {
7    "order": 2,
8    "refill": 2
9  },
10  {
11    "order": 3,
12    "refill": {
13      "error": "Incorrect order ID"
14    }
15  }
16]
POST

Get Refill Status

Check the status of a previously submitted refill request.

Parameters
keyYour API key
actionrefill_status
refillRefill ID
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "refill_status",
6    "refill": 9814
7  }'
Example Response
1{
2  "status": "Completed"
3}
POST

Get Multiple Refill Status

Check the status of up to 100 refill requests in a single call.

Parameters
keyYour API key
actionrefill_status
refillsRefill IDs (separated by a comma, up to 100 IDs)
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "refill_status",
6    "refills": "1,2,3"
7  }'
Example Response
1[
2  {
3    "refill": 1,
4    "status": "Completed"
5  },
6  {
7    "refill": 2,
8    "status": "Rejected"
9  },
10  {
11    "refill": 3,
12    "status": {
13      "error": "Refill not found"
14    }
15  }
16]
POST

Create Cancel

Request cancellation of one or more orders that support cancellation.

Parameters
keyYour API key
actioncancel
ordersOrder IDs (separated by a comma, up to 100 IDs)
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "cancel",
6    "orders": "9,2"
7  }'
Example Response
1[
2  {
3    "order": 9,
4    "cancel": {
5      "error": "Incorrect order ID"
6    }
7  },
8  {
9    "order": 2,
10    "cancel": 1
11  }
12]
POST

User Balance

Retrieve your current account balance and currency.

Parameters
keyYour API key
actionbalance
1curl -X POST https://my.smmworld.org/api/v2 \
2  -H "Content-Type: application/json" \
3  -d '{
4    "key": "YOUR_API_KEY",
5    "action": "balance"
6  }'
Example Response
1{
2  "balance": "100.84292",
3  "currency": "USD"
4}

Error Handling

Errors return HTTP 200 with an error field in the JSON body so client integrations can parse failures consistently, without relying on HTTP status codes alone.

ErrorMeaning
Incorrect API keyThe key field is missing, malformed, or doesn't match an active account.
Not enough fundsYour account balance is lower than the order's total charge.
Invalid linkThe submitted link doesn't match the expected format for the selected service's platform.
Min amount is XThe requested quantity is below the service's minimum order size.
Max amount is XThe requested quantity is above the service's maximum order size.
Service not foundThe service ID doesn't exist or has been removed — refresh your services list.

Notes for Integrators

  • Poll order status sparingly — every few minutes is plenty. Excess polling on the same order provides no faster resolution.
  • Store the numeric service ID from the services list rather than hardcoding names, since listings and IDs can change.
  • Always validate the submitted link format client-side before calling add — invalid links are the most common cause of failed orders.
  • Treat your API key like a password. Rotate it immediately from your dashboard if you suspect it has leaked.