L'API de SocialBooster
Construisez votre propre panel, votre bot ou votre site de revente sur SocialBooster. Lisez votre solde, passez des commandes et suivez leur avancement en HTTPS et JSON. Les prix que l'API affiche sont les vôtres.
Dernière mise à jour : 19 octobre 2026
- JSON en HTTPS
- REST
- Clé secrète
- Bearer
- Montants entiers
- FCFA
Adresse de base
https://social-booster.online/api/v1
Démarrage rapide
Chaque requête va à l'adresse de base ci-dessus, en HTTPS, avec votre clé dans l'en-tête Authorization.
- Connectez-vous, ouvrez Clés API dans votre compte et créez une clé. Copiez-la : elle n'est affichée qu'une seule fois.
- Rechargez votre solde. Les commandes passées par l'API sont payées avec, exactement comme sur le site.
- Appelez
GET /servicespour choisir un service, puisPOST /orderspour passer une commande.
Authentification
Envoyez votre clé comme jeton « bearer » dans l'en-tête Authorization de chaque requête. Une clé est sbk_ suivi de 40 lettres et chiffres.
Authorization: Bearer sbk_your_key
La clé se place uniquement dans l'en-tête : une clé dans l'adresse est ignorée. Si vous perdez une clé ou soupçonnez une fuite, révoquez-la sur la page Clés API et créez-en une autre. Vous pouvez détenir jusqu'à 5 clés actives à la fois, ce qui permet d'en remplacer une sans interruption.
Une clé absente, mal formée ou révoquée reçoit 401 invalid_api_key. Si l'accès à l'API a été désactivé pour votre compte, vous recevez 403 api_access_disabled.
Conventions
- Tout est en JSON, en UTF-8. Envoyez
Content-Type: application/jsonavec le corps d'unPOST(un corps de formulaire fonctionne aussi). - Un succès est
{"data": …}. Une liste y ajoute{"meta": …}. Un échec est{"error": …}(voir Erreurs). - Les montants sont des nombres entiers de FCFA. Il n'y a aucune décimale nulle part.
- Les dates sont en ISO 8601 UTC, par exemple
2026-10-18T09:30:00Z. - Les messages sont en anglais. Dans votre programme, appuyez-vous sur le
coded'une erreur, jamais sur son message. - Chaque réponse porte un en-tête
X-Request-Id, repris sousrequest_iddans les erreurs. Citez-le si vous contactez le support.
Solde
GET
/balance
Renvoie ce qu'il vous reste à dépenser.
curl https://social-booster.online/api/v1/balance \
-H "Authorization: Bearer sbk_your_key"
{
"data": {
"balance": 12500,
"currency": "FCFA"
}
}
Lister les services
GET
/services
Renvoie tous les services que vous pouvez commander, avec le prix que vous payez : vos prix spéciaux et remises sont déjà appliqués, vous ne voyez jamais le prix public ici.
-
id string
L'identifiant à envoyer comme
servicepour commander. Il ne change pas. -
network string
Le réseau : TikTok, Instagram…
-
category string
Le groupe du service dans le réseau : Followers, Likes…
-
type string
Ce que la commande porte en plus du lien.
standard: unequantity.custom_comments: vos propres commentaires (comments).mentions_custom_list: une liste de noms d'utilisateur à mentionner (usernames). Pour les deux derniers, la quantité est le nombre de lignes de la liste. -
name string
Le nom du service.
-
price_per_1000 integer
Votre prix, en FCFA, pour 1 000 unités.
-
min_quantity integer
La plus petite quantité que vous pouvez commander.
-
max_quantity integer
La plus grande quantité que vous pouvez commander.
| Champ | Type | Signification |
|---|---|---|
| id | string | L'identifiant à envoyer comme service pour commander. Il ne change pas.
|
| network | string | Le réseau : TikTok, Instagram… |
| category | string | Le groupe du service dans le réseau : Followers, Likes… |
| type | string | Ce que la commande porte en plus du lien. standard : une quantity. custom_comments : vos propres commentaires (comments). mentions_custom_list : une liste de noms d'utilisateur à mentionner (usernames). Pour les deux derniers, la quantité est le nombre de lignes de la liste.
|
| name | string | Le nom du service. |
| price_per_1000 | integer | Votre prix, en FCFA, pour 1 000 unités. |
| min_quantity | integer | La plus petite quantité que vous pouvez commander. |
| max_quantity | integer | La plus grande quantité que vous pouvez commander. |
curl https://social-booster.online/api/v1/services \
-H "Authorization: Bearer sbk_your_key"
{
"data": [
{
"id": "tiktok-followers-africa",
"network": "TikTok",
"category": "Followers",
"type": "standard",
"name": "Followers Africa",
"price_per_1000": 2500,
"min_quantity": 100,
"max_quantity": 50000
}
]
}
Passer une commande
POST
/orders
Débite votre solde et envoie la commande à livrer. Les règles sont celles du formulaire de commande du site.
-
service string, requis
L'
idd'un service, tiré deGET /services. -
link string, requis
L'adresse du profil, de la page ou de la publication à booster :
httpouhttps, 500 caractères au plus. Elle doit rester publique jusqu'à la fin de la livraison. -
quantity integer
Requis pour un service
standard: entre lemin_quantityet lemax_quantitydu service, bornes comprises. Facultatif pour un service à liste : si vous l'envoyez, elle doit être égale au nombre de lignes de la liste. -
comments string
Requis pour un service
custom_comments, interdit pour les autres : vos commentaires, un par ligne (lignes séparées par\n). Les lignes vides sont ignorées. Leur nombre doit être compris entre lemin_quantityet lemax_quantitydu service, et chaque commentaire fait 1 000 caractères au plus. -
usernames string
Requis pour un service
mentions_custom_list, interdit pour les autres : les noms d'utilisateur à mentionner, un par ligne (lignes séparées par\n), 100 caractères au plus chacun. Leur nombre est borné comme pourcomments.
| Champ | Type | Signification |
|---|---|---|
| service | string, requis | L'id d'un service, tiré de GET /services.
|
| link | string, requis | L'adresse du profil, de la page ou de la publication à booster : http ou https, 500 caractères au plus. Elle doit rester publique jusqu'à la fin de la livraison.
|
| quantity | integer | Requis pour un service standard : entre le min_quantity et le max_quantity du service, bornes comprises. Facultatif pour un service à liste : si vous l'envoyez, elle doit être égale au nombre de lignes de la liste.
|
| comments | string | Requis pour un service custom_comments, interdit pour les autres : vos commentaires, un par ligne (lignes séparées par \n). Les lignes vides sont ignorées. Leur nombre doit être compris entre le min_quantity et le max_quantity du service, et chaque commentaire fait 1 000 caractères au plus.
|
| usernames | string | Requis pour un service mentions_custom_list, interdit pour les autres : les noms d'utilisateur à mentionner, un par ligne (lignes séparées par \n), 100 caractères au plus chacun. Leur nombre est borné comme pour comments.
|
Envoyez aussi un en-tête Idempotency-Key, pour qu'une relance ne puisse jamais commander deux fois. Voir Relances sans risque plus bas.
Réponses
-
201 —
Commande passée. Son
statusestprocessing, oufailedsi la commande n'a pas pu démarrer : vous êtes alors remboursé en totalité (voirchargeetrefunded). -
200 —
Rejeu : cette
Idempotency-Keya déjà passé une commande. Cette commande est renvoyée, avec l'en-têteIdempotent-Replayed: true, et rien n'est débité de nouveau. -
402 insufficient_balance
Votre solde est trop bas. L'erreur porte
balanceetrequired. Rien n'a été enregistré. -
409 idempotency_key_reused
La clé a servi pour une autre commande (autre service, autre lien, autre quantité ou autre liste).
-
422 validation_failed
Un champ est incorrect.
error.errorsliste les messages par champ. -
429 too_many_requests
Vous dépassez une limite : voir Limites de débit.
| Statut | Code | Signification |
|---|---|---|
| 201 | — | Commande passée. Son status est processing, ou failed si la commande n'a pas pu démarrer : vous êtes alors remboursé en totalité (voir charge et refunded).
|
| 200 | — | Rejeu : cette Idempotency-Key a déjà passé une commande. Cette commande est renvoyée, avec l'en-tête Idempotent-Replayed: true, et rien n'est débité de nouveau.
|
| 402 | insufficient_balance | Votre solde est trop bas. L'erreur porte balance et required. Rien n'a été enregistré.
|
| 409 | idempotency_key_reused | La clé a servi pour une autre commande (autre service, autre lien, autre quantité ou autre liste). |
| 422 | validation_failed | Un champ est incorrect. error.errors liste les messages par champ.
|
| 429 | too_many_requests | Vous dépassez une limite : voir Limites de débit. |
curl https://social-booster.online/api/v1/orders \
-H "Authorization: Bearer sbk_your_key" \
-H "Idempotency-Key: shop-order-48213" \
-H "Content-Type: application/json" \
-d '{"service": "tiktok-followers-africa", "link": "https://www.tiktok.com/@awa", "quantity": 1000}'
curl https://social-booster.online/api/v1/orders \
-H "Authorization: Bearer sbk_your_key" \
-H "Idempotency-Key: shop-order-48214" \
-H "Content-Type: application/json" \
-d '{"service": "facebook-custom-comments", "link": "https://www.facebook.com/awa/posts/123", "comments": "Magnifique !\nBravo pour cette publication\nMerci du partage"}'
{
"data": {
"id": 1207,
"service": "tiktok-followers-africa",
"service_name": "Followers Africa",
"link": "https://www.tiktok.com/@awa",
"quantity": 1000,
"price_per_1000": 2500,
"charge": 2500,
"refunded": 0,
"status": "processing",
"start_count": null,
"remains": null,
"created_at": "2026-10-18T09:30:00Z"
}
}
{
"error": {
"code": "insufficient_balance",
"message": "The balance is too low for this order.",
"balance": 1000,
"required": 2500,
"request_id": "0b8f2f3e-2a0e-4d5b-8f0a-6b6f2c1d9a10"
}
}
{
"error": {
"code": "validation_failed",
"message": "The given data was invalid.",
"errors": {
"quantity": ["The quantity must be between 100 and 50,000."]
},
"request_id": "7c1d0e5a-93b4-4f6e-a2b8-5d41c6f0e9a3"
}
}
Calcul du prix
La commande coûte quantity × price_per_1000 ÷ 1 000, arrondi au FCFA le plus proche (une moitié est arrondie vers le haut) et jamais moins de 1 FCFA.
- 1 500 unités à 2 750 FCFA les 1 000 coûtent 4 125 FCFA.
- 333 unités à 1 500 FCFA les 1 000 font 499,5 et coûtent 500 FCFA.
Le prix est figé au moment où la commande est passée : modifier vos prix plus tard ne change jamais une commande déjà faite.
Lister les commandes
GET
/orders
Renvoie vos commandes, de la plus récente à la plus ancienne. Les commandes des autres membres n'apparaissent jamais.
-
status string
Seulement les commandes dans ce statut :
pending,processing,completed,partialoufailed. -
ids string
Seulement ces commandes : des numéros de commande séparés par des virgules, 100 au plus.
-
per_page integer
Commandes par page, de 1 à 100 (25 par défaut).
-
cursor string
Le
meta.next_cursorde la page précédente, pour obtenir la page suivante.
| Paramètre | Type | Signification |
|---|---|---|
| status | string | Seulement les commandes dans ce statut : pending, processing, completed, partial ou failed.
|
| ids | string | Seulement ces commandes : des numéros de commande séparés par des virgules, 100 au plus. |
| per_page | integer | Commandes par page, de 1 à 100 (25 par défaut). |
| cursor | string | Le meta.next_cursor de la page précédente, pour obtenir la page suivante.
|
curl "https://social-booster.online/api/v1/orders?status=processing&per_page=1" \
-H "Authorization: Bearer sbk_your_key"
{
"data": [
{
"id": 1207,
"service": "tiktok-followers-africa",
"service_name": "Followers Africa",
"link": "https://www.tiktok.com/@awa",
"quantity": 1000,
"price_per_1000": 2500,
"charge": 2500,
"refunded": 0,
"status": "processing",
"start_count": 3572,
"remains": 157,
"created_at": "2026-10-18T09:30:00Z"
}
],
"meta": {
"per_page": 1,
"next_cursor": "1207"
}
}
Quand meta.next_cursor vaut null, il n'y a pas de page après celle-ci. Traitez le curseur comme opaque : renvoyez-le tel que reçu.
curl "https://social-booster.online/api/v1/orders?ids=1207,1206,1205" \
-H "Authorization: Bearer sbk_your_key"
Pour suivre beaucoup de commandes, demandez-les ensemble avec ids : un appel au lieu d'un par commande. Interrogez avec modération : un statut change en minutes ou en heures, pas en secondes.
Lire une commande
GET
/orders/{id}
Renvoie une commande. Une commande qui n'est pas la vôtre répond 404 not_found, exactement comme une commande qui n'existe pas.
curl https://social-booster.online/api/v1/orders/1207 \
-H "Authorization: Bearer sbk_your_key"
La commande
-
id integer
Le numéro de la commande.
-
service string
L'
iddu service. -
service_name string
Le nom du service au moment de la commande.
-
link string
L'adresse visée par la commande.
-
quantity integer
La quantité commandée.
-
price_per_1000 integer
Le prix pour 1 000 unités qui s'est appliqué à cette commande.
-
charge integer
Ce que la commande a coûté, en FCFA.
-
refunded integer
Ce qui a été rendu à votre solde, en FCFA :
0sauf si la commande a échoué ou n'a été livrée qu'en partie. -
status string
Voir Statuts des commandes.
-
start_count integer ou null
Le compteur du profil au début de la livraison, une fois connu.
-
remains integer ou null
La quantité pas encore livrée, une fois connue.
-
created_at string
Le moment de la commande, en ISO 8601 UTC.
| Champ | Type | Signification |
|---|---|---|
| id | integer | Le numéro de la commande. |
| service | string | L'id du service.
|
| service_name | string | Le nom du service au moment de la commande. |
| link | string | L'adresse visée par la commande. |
| quantity | integer | La quantité commandée. |
| price_per_1000 | integer | Le prix pour 1 000 unités qui s'est appliqué à cette commande. |
| charge | integer | Ce que la commande a coûté, en FCFA. |
| refunded | integer | Ce qui a été rendu à votre solde, en FCFA : 0 sauf si la commande a échoué ou n'a été livrée qu'en partie.
|
| status | string | Voir Statuts des commandes. |
| start_count | integer ou null | Le compteur du profil au début de la livraison, une fois connu. |
| remains | integer ou null | La quantité pas encore livrée, une fois connue. |
| created_at | string | Le moment de la commande, en ISO 8601 UTC. |
Statuts des commandes
Une commande passe de pending à processing, puis se termine dans l'un de trois statuts finaux.
-
pending
Enregistrée et sur le point d'être envoyée.
-
processing
Acceptée et en cours de livraison. Une commande qui attend une vérification de notre côté affiche aussi
processing. -
completed
Livrée en totalité. Final.
-
partial
Livrée en partie : la part non livrée a été remboursée (voir
refunded). Final. -
failed
Non livrée : remboursée en totalité. Final.
| Statut | Signification |
|---|---|
| pending | Enregistrée et sur le point d'être envoyée. |
| processing | Acceptée et en cours de livraison. Une commande qui attend une vérification de notre côté affiche aussi processing.
|
| completed | Livrée en totalité. Final. |
| partial | Livrée en partie : la part non livrée a été remboursée (voir refunded). Final.
|
| failed | Non livrée : remboursée en totalité. Final. |
Une fois qu'une commande est completed, partial ou failed, elle ne change plus jamais : vous pouvez arrêter de la suivre.
Relances sans risque
Un réseau peut tomber après que nous avons reçu votre requête mais avant que vous ayez la réponse. Relancer à l'aveugle pourrait commander deux fois et vous débiter deux fois. Pour qu'une relance soit sans risque, envoyez un en-tête Idempotency-Key avec POST /orders : toute chaîne de 255 caractères au plus, propre à la commande, par exemple son numéro dans votre système ou un UUID.
- Le premier appel avec une clé passe la commande (
201). La même clé renvoie cette même commande (200,Idempotent-Replayed: true) : pas de seconde commande ni de second débit, même si votre solde a changé entre-temps. - Réutiliser une clé pour une autre commande est refusé (
409) : une erreur dans votre code ne peut pas passer pour un succès. - Les clés sont à vous seul : un autre compte peut utiliser la même chaîne.
- Sans l'en-tête, chaque appel passe une nouvelle commande.
- Quand vous n'avez aucune réponse, ou un
5xx, l'issue est inconnue : renvoyez le même appel avec la même clé.
Erreurs
Une requête en échec répond avec un statut HTTP et un corps JSON, {"error": {"code": …, "message": …, "request_id": …}}, plus les champs propres à l'erreur. Testez le code, jamais le message.
-
invalid_api_key 401
La clé est absente, mal formée, inconnue ou révoquée.
-
insufficient_balance 402
Votre solde est trop bas. Porte
balanceetrequired. -
api_access_disabled 403
L'accès à l'API est désactivé pour votre compte.
-
not_found 404
Adresse inconnue, ou commande qui n'est pas la vôtre.
-
method_not_allowed 405
Mauvaise méthode HTTP pour cette adresse ; l'en-tête
Allowliste les bonnes. -
idempotency_key_reused 409
La clé a servi pour une autre commande.
-
validation_failed 422
Porte
errors, les messages par champ. -
too_many_requests 429
Porte
retry_after, en secondes. -
server_error 500
Un problème de notre côté. Réessayez plus tard et citez le
request_idsi cela persiste. -
service_unavailable 503
Maintenance, ou API désactivée. Réessayez plus tard.
-
http_error autre
Toute autre erreur HTTP, par exemple
413quand une requête est trop volumineuse.
| Code | Statut | Signification |
|---|---|---|
| invalid_api_key | 401 | La clé est absente, mal formée, inconnue ou révoquée. |
| insufficient_balance | 402 | Votre solde est trop bas. Porte balance et required.
|
| api_access_disabled | 403 | L'accès à l'API est désactivé pour votre compte. |
| not_found | 404 | Adresse inconnue, ou commande qui n'est pas la vôtre. |
| method_not_allowed | 405 | Mauvaise méthode HTTP pour cette adresse ; l'en-tête Allow liste les bonnes.
|
| idempotency_key_reused | 409 | La clé a servi pour une autre commande. |
| validation_failed | 422 | Porte errors, les messages par champ.
|
| too_many_requests | 429 | Porte retry_after, en secondes.
|
| server_error | 500 | Un problème de notre côté. Réessayez plus tard et citez le request_id si cela persiste.
|
| service_unavailable | 503 | Maintenance, ou API désactivée. Réessayez plus tard. |
| http_error | autre | Toute autre erreur HTTP, par exemple 413 quand une requête est trop volumineuse.
|
Limites de débit
- 120 requêtes par minute par compte, quelle que soit la clé qui les envoie : créer plus de clés ne relève pas la limite.
- Passer des commandes : 30 par minute et 600 par heure par compte.
- Requêtes portant une clé inconnue ou révoquée : 30 par minute par adresse IP, au-delà de quoi cette adresse est refusée jusqu'à la fin de la minute.
Au-delà d'une limite, vous recevez 429 too_many_requests avec un en-tête Retry-After, en secondes. Attendez ce délai puis réessayez ; ne relancez pas en boucle.
Exemples
Le même parcours en deux langages : lire les services, passer une commande sans risque, la consulter plus tard. Des exemples cURL accompagnent chaque point d'accès plus haut.
<?php
$base = 'https://social-booster.online/api/v1';
$key = getenv('SOCIALBOOSTER_KEY'); // read it from the environment, never write it in the code
function call(string $method, string $path, ?array $body = null, array $headers = []): array
{
global $base, $key;
$curl = curl_init($base.$path);
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => array_merge([
'Authorization: Bearer '.$key,
'Accept: application/json',
'Content-Type: application/json',
], $headers),
CURLOPT_POSTFIELDS => $body === null ? null : json_encode($body),
]);
$text = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE); // 0 when there was no answer at all
return [$status, json_decode((string) $text, true)];
}
// 1. Read the services you may order, and what you pay for each.
[, $services] = call('GET', '/services');
// 2. Place an order. Keep the Idempotency-Key with the order in your own database:
// if anything fails on the way, send the very same call again with the very same key.
[$status, $reply] = call('POST', '/orders', [
'service' => 'tiktok-followers-africa',
'link' => 'https://www.tiktok.com/@awa',
'quantity' => 1000,
], ['Idempotency-Key: shop-order-48213']);
if ($status === 201 || $status === 200) {
$order = $reply['data'];
} elseif ($status === 402) {
// Not enough balance: $reply['error']['required'] FCFA are needed. Top up, then place the order again.
} elseif ($status === 0 || $status >= 500) {
// The outcome is unknown: do not place a new order, retry the same call with the same key.
}
// 3. Check on it later.
[, $reply] = call('GET', '/orders/'.$order['id']);
echo $reply['data']['status'];
const base = 'https://social-booster.online/api/v1';
const key = process.env.SOCIALBOOSTER_KEY; // read it from the environment, never write it in the code
async function call(method, path, body, headers = {}) {
const response = await fetch(base + path, {
method,
headers: {
Authorization: `Bearer ${key}`,
Accept: 'application/json',
'Content-Type': 'application/json',
...headers,
},
body: body ? JSON.stringify(body) : undefined,
signal: AbortSignal.timeout(60_000),
});
return { status: response.status, body: await response.json() };
}
// 1. Read the services you may order, and what you pay for each.
const services = (await call('GET', '/services')).body.data;
// 2. Place an order. Keep the Idempotency-Key with the order in your own database:
// if anything fails on the way, send the very same call again with the very same key.
let order;
try {
const { status, body } = await call('POST', '/orders', {
service: 'tiktok-followers-africa',
link: 'https://www.tiktok.com/@awa',
quantity: 1000,
}, { 'Idempotency-Key': 'shop-order-48213' });
if (status === 201 || status === 200) {
order = body.data;
} else if (status === 402) {
// Not enough balance: body.error.required FCFA are needed. Top up, then place the order again.
} else if (status >= 500) {
// The outcome is unknown: retry the same call with the same key.
}
} catch {
// No answer (network, timeout): the outcome is unknown. Retry the same call with the same key.
}
// 3. Check on it later.
console.log((await call('GET', `/orders/${order.id}`)).body.data.status);
Bonnes pratiques
- N'appelez l'API que depuis votre serveur, et gardez la clé dans l'environnement, pas dans votre code.
- Envoyez toujours une
Idempotency-Key, et conservez-la avec la commande dans votre propre base pour qu'une relance la réutilise. - Lisez les prix dans
GET /servicesplutôt que de les écrire dans votre code, et comparezchargeà ce que vous attendiez. - Répondez à un
402en rechargeant, pas en réessayant. - Traitez les délais dépassés et les
5xxcomme des issues inconnues : renvoyez le même appel avec la même clé. - Révoquez une clé dès que vous soupçonnez une fuite.
Aide
Une question, des prix spéciaux pour votre volume, ou une limite plus haute ? Écrivez à support@social-booster.online.