API documentation

Our API follows the industry-standard format: every call is a POST to a single URL, with your key (key) and an action (action). Existing reseller scripts therefore work without any changes. Create your key from your account, in the “API” section.

Address: https://sociallikeyou.com/api/v2

Method: POST · Reply: JSON

Liste des services

ParameterDescription
keyYour API key
actionservices

Sample response

[{"service":1,"name":"…","type":"Default","category":"…","rate":"0.9","min":"10","max":"10000","refill":false,"cancel":false}]

Passer une commande

ParameterDescription
keyYour API key
actionadd
serviceID du service
linkLien
quantityQuantité
idempotency_keyFacultatif : identifiant unique pour éviter les doublons en cas de nouvel essai

Sample response

{"order":23501}

Statut d’une commande

ParameterDescription
keyYour API key
actionstatus
orderID de la commande

Sample response

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

Statut de plusieurs commandes (100 max)

ParameterDescription
keyYour API key
actionstatus
ordersIDs séparés par des virgules

Sample response

{"1":{"charge":"0.27","start_count":"0","status":"Completed","remains":"0","currency":"EUR"},"10":{"error":"Incorrect order ID"}}

Solde du compte

ParameterDescription
keyYour API key
actionbalance

Sample response

{"balance":"100.84","currency":"EUR"}

REST API (JSON) and notifications

For new integrations, a REST API is available at https://sociallikeyou.com/api/rest/v1 with the header Authorization: Bearer YOUR_KEY : GET /services, GET /balance, GET /orders, GET /orders/{id} and POST /orders. Creation requires the header Idempotency-Key, so a retry after a connection drop never creates a duplicate. Full specification in OpenAPI format: openapi.json.

Notifications: enter an HTTPS URL in your account (API section). On every status change, we send a POST JSON with the header X-Webhook-Signature: t=…,v1=…. To verify it, compute the HMAC-SHA256 of t.corps with your secret. If delivery fails, it is retried up to 10 times over about 24 hours.

Errors

Business errors return {"error": "message"}. Invalid key: HTTP 401. Too many requests: HTTP 429 (default limit: 120 requests per minute per key).

Examples

PHP

<?php
$ch = curl_init("https://sociallikeyou.com/api/v2");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        "key" => "VOTRE_CLE", "action" => "add",
        "service" => 1, "link" => "https://exemple.com/page", "quantity" => 1000,
    ]),
]);
$reponse = json_decode(curl_exec($ch), true);

Python

import requests
r = requests.post("https://sociallikeyou.com/api/v2", data={"key": "VOTRE_CLE", "action": "balance"}, timeout=30)
print(r.json())

JavaScript (Node.js)

const r = await fetch("https://sociallikeyou.com/api/v2", {
  method: "POST",
  body: new URLSearchParams({ key: "VOTRE_CLE", action: "services" }),
});
console.log(await r.json());