Reseller API

Overview

Every request is a POST to one endpoint:

POST https://socialengine.cc/api/v2

• Send parameters as application/x-www-form-urlencoded form fields or as a JSON body (application/json).
• Every request needs key (your API key) and action.
• Responses are JSON. Amounts are USD, sent as decimal strings.
• Order ids are your Social Engine order numbers, the same ones you see in your order history.

Authentication

Create a key in your account under Reseller API. Keys start with se_live_ and are shown once, when you create them. We store only a hash, so if you lose a key, revoke it and create a new one. You can have up to 10 active keys.

Orders placed with a key are paid from your wallet balance, so treat the key like a password: keep it on your server, never in browser code or a public repository. Revoking a key stops it working on the next request.

Service list

action=services returns every service you can order. Each product is offered in three quality tiers, and each product and tier pair has its own service id. Ids are stable: we never renumber or reuse them.

[
  {
    "service": 1002,
    "name": "Instagram Followers [Premium] | 60-day refill",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "18.99",
    "min": 100,
    "max": 50000,
    "refill": true,
    "cancel": true,
    "dripfeed": true
  }
]

type is Default or Custom Comments. rate is the price per 1000 units. min and max are the order limits.

Add order

{
  "order": 100001
}

Drip-feed. As on other panels, with drip-feed quantity is per run, so the order total is quantity × runs. We deliver that total with our natural delivery, spread over runs × interval minutes rounded to whole days (at least 1 day, at most 30). Delivery happens in batches we schedule, so batch sizes and times may differ from your exact runs and interval. Drip-feed is not available for Custom Comments.

Order status

{
  "charge": "2.50",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}

{
  "9": {
    "error": "Incorrect order ID"
  },
  "100001": {
    "charge": "2.50",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "100002": {
    "charge": "0.84",
    "start_count": "0",
    "status": "Pending",
    "remains": "1000",
    "currency": "USD"
  }
}

Statuses:

• Pending: accepted and queued for delivery.
• In progress: delivery has started.
• Processing: our team is checking the order.
• Completed: fully delivered.
• Partial: partly delivered. The undelivered part was refunded to your balance.
• Canceled: nothing was delivered and the charge was refunded.

charge is what you paid for the order, less any automatic refund for undelivered units. remains is quantity minus delivered. start_count is the count we recorded when delivery started, or 0 before then.

Refill

{
  "refill": "8f6c2a1e-3b7d-4c55-9a0e-2d4f6b8c1a90"
}

[
  {
    "order": 100001,
    "refill": "8f6c2a1e-3b7d-4c55-9a0e-2d4f6b8c1a90"
  },
  {
    "order": 100002,
    "refill": {
      "error": "Refills open once the order has completed"
    }
  }
]

Refill ids are strings. Store them as text, not as integers.

Refill status

{
  "status": "Completed"
}

[
  {
    "refill": "8f6c2a1e-3b7d-4c55-9a0e-2d4f6b8c1a90",
    "status": "In progress"
  },
  {
    "refill": "00000000-0000-0000-0000-000000000000",
    "status": {
      "error": "Refill not found"
    }
  }
]

Statuses are Pending, In progress, Completed and Rejected.

Cancel

[
  {
    "order": 100001,
    "cancel": 1
  },
  {
    "order": 100002,
    "cancel": {
      "error": "Order can't be canceled"
    }
  }
]

Balance

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

Your spendable wallet balance: cash plus bonus credit. Orders spend bonus credit first.

Errors

Errors come back as JSON with an error message and, as on other panels, HTTP status 200. Check for the error field on every response.

{
  "error": "Not enough funds on balance"
}

• Invalid API key: the key is missing, mistyped or revoked.
• Account restricted: your account can't use the API right now. Contact support.
• Incorrect action, Incorrect request: unknown action or an unreadable body.
• Incorrect service ID, Incorrect order ID, Incorrect quantity, Incorrect link: a parameter is missing or not valid.
• Not enough funds on balance: add funds and try again. Nothing was charged.

Other messages explain what to fix, for example a quantity outside the service limits. Two exceptions use HTTP status codes: 429 when you exceed the rate limit, and 500 if something fails on our side. In both cases nothing was charged and you can retry.

Rate limits

Each key can make 60 requests per minute, with short bursts up to 120. Over the limit you get HTTP 429 with {"error":"Too many requests, slow down"} and a Retry-After header in seconds. Use the batch forms (orders, refills) to check up to 100 ids in one request, and cache the service list rather than fetching it before every order.

Pricing

API orders use linear pricing:

charge = rate × quantity / 1000

rate comes from the service list and is the same for any quantity, so your panel can price orders the same way we charge them. Charges are calculated to a millionth of a dollar. Your loyalty discount, if you have one, also applies to API orders. Rates can change; fetch the service list regularly to stay current.

Refills and cancels

• Every tier includes a refill guarantee: Standard 30 days, Premium 60 days, Elite 90 days, counted from when the order completes.
• A refill can be requested once the order is Completed or Partial and inside its window. One refill per order can be open at a time. We redeliver drops at no cost.
• Cancel stops the parts of an order that haven't been sent for delivery yet, such as later drip-feed batches, and refunds them to your balance. Parts already being delivered keep going. If nothing is left to stop, you get Order can't be canceled.
• Undelivered units on partial or canceled orders are refunded to your balance automatically.

See our guarantees for the full rules.

Examples

curl

# List services
curl -X POST https://socialengine.cc/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

# Place an order for 1,000 Instagram Followers [Premium]
curl -X POST https://socialengine.cc/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1002 \
  --data-urlencode link=https://www.instagram.com/yourprofile \
  -d quantity=1000

# Same request as JSON
curl -X POST https://socialengine.cc/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"status","order":100001}'

PHP

<?php
class SocialEngineApi
{
    private string $url = 'https://socialengine.cc/api/v2';

    public function __construct(private string $key) {}

    private function call(array $params): mixed
    {
        $ch = curl_init($this->url);
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => http_build_query(['key' => $this->key] + $params),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 30,
        ]);
        $body = curl_exec($ch);
        curl_close($ch);
        return json_decode((string) $body, true);
    }

    public function services() { return $this->call(['action' => 'services']); }
    public function order(array $data) { return $this->call(['action' => 'add'] + $data); }
    public function status(int $order) { return $this->call(['action' => 'status', 'order' => $order]); }
    public function multiStatus(array $orders) { return $this->call(['action' => 'status', 'orders' => implode(',', $orders)]); }
    public function refill(int $order) { return $this->call(['action' => 'refill', 'order' => $order]); }
    public function refillStatus(string $refill) { return $this->call(['action' => 'refill_status', 'refill' => $refill]); }
    public function cancel(array $orders) { return $this->call(['action' => 'cancel', 'orders' => implode(',', $orders)]); }
    public function balance() { return $this->call(['action' => 'balance']); }
}

$api = new SocialEngineApi('YOUR_API_KEY');

$order = $api->order([
    'service' => 1002,
    'link' => 'https://www.instagram.com/yourprofile',
    'quantity' => 1000,
]);

if (isset($order['error'])) {
    echo 'Error: ' . $order['error'];
} else {
    print_r($api->status($order['order']));
}

Service ids

The live list, ids 1001 to 1147. Your panel can also import it with action=services.

Get started

Create an API key in your account, add funds, and connect your panel. Running a panel or agency at volume? Look at our partner program.