Aller au contenu
SocialBooster
fr en
Se connecter S'inscrire

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.

  1. 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.
  2. Rechargez votre solde. Les commandes passées par l'API sont payées avec, exactement comme sur le site.
  3. Appelez GET /services pour choisir un service, puis POST /orders pour passer une commande.

Créer un compte

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
Gardez votre clé sur votre serveur. Ne la mettez jamais dans une application mobile, une page web ou un dépôt public : qui la détient peut dépenser votre solde. L'API n'envoie aucun en-tête CORS, un navigateur ne peut donc pas l'appeler avec votre clé. C'est voulu.

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/json avec le corps d'un POST (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 code d'une erreur, jamais sur son message.
  • Chaque réponse porte un en-tête X-Request-Id, repris sous request_id dans les erreurs. Citez-le si vous contactez le support.

Solde

GET /balance

Renvoie ce qu'il vous reste à dépenser.

Requête
curl https://social-booster.online/api/v1/balance \
  -H "Authorization: Bearer sbk_your_key"
Réponse
{
  "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 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.

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.
Requête
curl https://social-booster.online/api/v1/services \
  -H "Authorization: Bearer sbk_your_key"
Réponse
{
  "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'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.

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 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.

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.
Requête
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}'
Exemple : un service à commentaires, 3 lignes = quantité 3
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"}'
Réponse 201
{
  "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"
  }
}
Réponse 402
{
  "error": {
    "code": "insufficient_balance",
    "message": "The balance is too low for this order.",
    "balance": 1000,
    "required": 2500,
    "request_id": "0b8f2f3e-2a0e-4d5b-8f0a-6b6f2c1d9a10"
  }
}
Réponse 422
{
  "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, 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.

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.
Requête
curl "https://social-booster.online/api/v1/orders?status=processing&per_page=1" \
  -H "Authorization: Bearer sbk_your_key"
Réponse
{
  "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.

Plusieurs commandes en un appel
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.

Requête
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'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.

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 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.

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
<?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'];
Node.js
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 /services plutôt que de les écrire dans votre code, et comparez charge à ce que vous attendiez.
  • Répondez à un 402 en rechargeant, pas en réessayant.
  • Traitez les délais dépassés et les 5xx comme 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.