Developer API v2

Public API reference

IntegrateSmmfree : #No1 Smm Panel in India with your tools, bots and reseller panels. Read the full reference below — no sign-up required to explore.

Want to start sending requests? Create a free account to get your personal YOUR_API_KEY.
Get API key

Connection

FieldValue
HTTP MethodPOST
Endpointhttps://smmfree.com/api/v2
API KeyYOUR_API_KEY
Response formatJSON

Endpoints

ActionDescription
servicesList all available services with rate, min, max
addPlace a new order (service, link, quantity)
statusCheck status of one or multiple orders
balanceGet current account balance
refillRequest a refill for an existing order
cancelCancel a pending order

Quick start

curl -X POSThttps://smmfree.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"
$post = http_build_query([
  'key'    => 'YOUR_API_KEY',
  'action' => 'add',
  'service'=> 1,
  'link'   => 'https://example.com/profile',
  'quantity' => 1000
]);
$ch = curl_init('https://smmfree.com/api/v2');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
echo $res;
import requests
r = requests.post('https://smmfree.com/api/v2', data={
    'key': 'YOUR_API_KEY',
    'action': 'add',
    'service': 1,
    'link': 'https://example.com/profile',
    'quantity': 1000,
})
print(r.json())

Example: Service list response

[
  {
    "service": 1,
    "name": "Followers",
    "type": "Default",
    "category": "First Category",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true
  }
]

Add order parameters

ParameterDescription
keyYour API key
actionadd
serviceService ID
linkTarget link
quantityNeeded quantity

Some services support extra fields (comments, runs, interval, username, min, max, posts, delay, expiry, hashtag). See the in-app docs after sign-up for full details.

Order status response

{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "USD"
}

User balance response

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

All requests require a key parameter. Responses are JSON. Errors return an error field.