API Documentation
Connect your own panel, site or bot to the SosyalBurada infrastructure. We use the standard SMM Panel API v2 contract — an integration that works on another panel works here too.
| HTTP method | POST |
|---|---|
| API URL | https://sosyalburada.com/api/v2 |
| Response format | JSON |
| Currency | TRY |
Your API key is ready in your account. Sign in — so your key appears on this page and the examples run as-is.
Service list
Every service on sale, with prices and limits. You show this list in your own panel.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | services |
Example response
[
{
"service": "12",
"name": "Instagram Türk Takipçi",
"type": "Default",
"category": "Instagram Takipçi",
"rate": "9.9000",
"min": "50",
"max": "100000",
"refill": true,
"cancel": true,
"dripfeed": true
}
]
Add order
The amount is deducted from your balance. If funds are short, no order is created and an error is returned.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | add |
| service | Service ID (the service field from the service list) |
| link | Link or username |
| quantity | Quantity |
| runs | (optional) Number of runs — drip-feed |
| interval | (optional) Interval in minutes, 5–1440 |
Example response
{
"order": 23501
}
Order status
Use order for a single order, orders for up to 100 orders.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | status |
| order | Order ID |
Example response
{
"charge": "9.9000",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "TRY"
}
Multiple order status
Up to 100 IDs, comma separated. A missing ID returns an error on its own row — the request as a whole does not fail.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | status |
| orders | Order IDs, comma separated (max 100) |
Example response
{
"1": {
"charge": "9.9000",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "TRY"
},
"10": {
"error": "Incorrect order ID"
}
}
Create refill
Only for refill-capable services and completed/partial orders. If an open request already exists for the order, no new one is created and the existing ID is returned.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | refill |
| order | Order ID |
| orders | (alternative) Order IDs, comma separated |
Example response
{
"refill": "1"
}
Refill status
Shows whether the refill request has reached the provider.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | refill_status |
| refill | Refill ID |
| refills | (alternative) Refill IDs, comma separated |
Example response
{
"status": "Completed"
}
Cancel order
Only orders that have not started can be cancelled; the amount is refunded to your balance.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | cancel |
| orders | Order IDs, comma separated (max 100) |
Example response
[
{ "order": 2, "cancel": 1 },
{ "order": 9, "cancel": { "error": "Incorrect order ID" } }
]
User balance
Available balance in your account.
| Parameter | Description |
|---|---|
| key | Your API key |
| action | balance |
Example response
{
"balance": "1250.4200",
"currency": "TRY"
}
PHP example
Copy it, add your key, run it. No library needed.
<?php
function sbApi(array $veri) {
$ch = curl_init('https://sosyalburada.com/api/v2');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($veri),
CURLOPT_TIMEOUT => 30,
]);
$yanit = curl_exec($ch);
curl_close($ch);
return json_decode($yanit, true);
}
// Servis listesi
$servisler = sbApi([
'key' => 'API_ANAHTARIN',
'action' => 'services',
]);
// Sipariş aç
$siparis = sbApi([
'key' => 'API_ANAHTARIN',
'action' => 'add',
'service' => 1,
'link' => 'https://instagram.com/kullaniciadi',
'quantity' => 1000,
]);
// HER YANITTA HATA KONTROLÜ: `order` yoksa sipariş AÇILMAMIŞTIR.
// Kontrol etmezsen bakiyen bitmiş olsa bile "sipariş verdim" sanırsın.
if (isset($siparis['error'])) {
exit('Hata: ' . $siparis['error']);
}
echo 'Sipariş no: ' . $siparis['order'];
Error messages
On error the HTTP code is still 200 and the body contains an error field — that is the industry standard. Check that field, not the HTTP code.
| Message | Meaning |
|---|---|
| Invalid API key | Wrong key, or the account is suspended |
| Incorrect request | Unrecognised action value |
| Invalid service | Service not found or not on sale |
| Not enough funds | Insufficient balance |
| Incorrect order ID | The order is not yours or does not exist |
| Incorrect order status | The order is not in a valid state for this action |
| Refill not supported | The service does not support refill |
| Refill not found | Refill request not found |
| Dripfeed is not supported for this service | The service does not support drip-feed |