API Documentation - Boosted Plug

Universal Gateway Endpoints

Our API acts as an automated Universal Translator. No matter what protocol or script your clients use (SmartPanel, PerfectPanel, WHMCS, custom Python bot, or modern Node.js app), our gateway accepts requests in any format and translates responses seamlessly.

v3 Next-Gen RESTful (Recommended) JSON / Bearer

RESTful JSON bodies, Bearer tokens, structured success/error envelopes, rich timestamps and order durations.

          https://boostedplug.com.ng/api/v3
          
        

v2 Standard SMM Reseller Form POST

Industry-standard SMM reseller protocol compatible with SmartPanel, RentalPanel, PerfectPanel, and WHMCS.

          https://boostedplug.com.ng/api/v2
          
        

Universal Auto-Negotiator Auto-Detect

Automatically detects client format (v1, v2, or v3) from headers, payload type, and parameters.

          https://boostedplug.com.ng/api
          
        

Authentication Options

You can authenticate using any of the following standard methods across all versions:

Bearer Token Header (Modern v3): Authorization: Bearer YOUR_API_KEY
Custom Header: X-API-Key: YOUR_API_KEY
Request Body / Parameter (v1 & v2 Standard): key=YOUR_API_KEY or api_key=YOUR_API_KEY

Auto-Detection for Old-Style GET Requests

Our gateway automatically inspects incoming traffic and detects if a client sends an old-style GET request (query-string based like GET /api?action=balance&key=... or GET /api?action=add&...) instead of a standard POST request.

Instant Compatibility: Legacy bots, simple cron scripts, or older PHP scripts using file_get_contents() will connect without errors.
All Actions Supported: Actions like add (place order), status, refill, and cancel are fully executed over GET when legacy scripts require it.
Cache Prevention: All GET transactions automatically send Cache-Control: no-store, no-cache headers so proxies or CDNs never serve stale data.

v3 RESTful API Specification (Next-Gen)

1. List Services Catalog

GET https://boostedplug.com.ng/api/v3/services

Retrieves all active services with rates, min/max bounds, service descriptions, and live average completion speeds.

v3 Response Example

{
  "version": "v3",
  "success": true,
  "data": {
    "total": 580,
    "currency": "NGN",
    "services": [
      {
        "id": 21150,
        "service": 21150,
        "name": "TikTok Video Views | High Speed",
        "category": "TikTok Views",
        "type": "Default",
        "rate": 43.15,
        "rate_per_1k": "43.1500",
        "min": 100,
        "max": 10000000,
        "refill": true,
        "dripfeed": false,
        "desc": "Starts within 0-15 mins. Non-drop high retention.",
        "average_time": "15m"
      }
    ]
  },
  "timestamp": "2026-10-09T20:30:00Z"
}

2. Get Account Balance

GET https://boostedplug.com.ng/api/v3/balance

Returns your current balance, wallet currency, formatted display, and historical spend.

{
  "version": "v3",
  "success": true,
  "data": {
    "user_id": 7422,
    "balance": 567.30,
    "currency": "NGN",
    "formatted": "₦567.30",
    "spent": 4000.00
  },
  "timestamp": "2026-10-09T20:30:00Z"
}

3. Submit New Order

POST https://boostedplug.com.ng/api/v3/orders

Accepts either a JSON body (application/json) or standard form payload.

JSON Request Body

{
  "service": 21150,
  "link": "https://www.tiktok.com/@user/video/123456789",
  "quantity": 1000
}

v3 Success Receipt

{
  "version": "v3",
  "success": true,
  "data": {
    "order_id": 10425,
    "service_id": 21150,
    "charge": 43.15,
    "currency": "NGN",
    "balance_remaining": 524.15,
    "status": "Pending",
    "created_at": "2026-10-09 20:30:15"
  },
  "timestamp": "2026-10-09T20:30:15Z"
}

4. Query Order Status

GET https://boostedplug.com.ng/api/v3/orders/{order_id}

Returns full execution analytics: start counter, remaining units, completion timestamp, execution duration, and service average speed.

{
  "version": "v3",
  "success": true,
  "data": {
    "order_id": 10425,
    "charge": 43.15,
    "start_count": 1500,
    "status": "Completed",
    "remains": 0,
    "currency": "NGN",
    "link": "https://www.tiktok.com/@user/video/123456789",
    "quantity": 1000,
    "created_at": "2026-10-09 20:15:00",
    "completion_time": "2026-10-09 20:29:12",
    "duration": "14m 12s",
    "average_time": "15m",
    "refill_allowed": true
  },
  "timestamp": "2026-10-09T20:30:00Z"
}

v2 Standard SMM Protocol (Classic Compatible)

Point your SMM panel, SmartPanel, or script to https://boostedplug.com.ng/api/v2 with action and key parameters:

Action	Required Parameters	Sample Response
`services`	`key` (optional)	`[{"service": 1, "name": "...", "rate": "1.5000", ...}]`
`balance`	`key`	`{"balance": "567.3000", "currency": "NGN"}`
`add`	`key`, `service`, `link`, `quantity`	`{"order": 10425}`
`status`	`key`, `order` (or `orders`)	`{"status": "Completed", "charge": "...", "remains": "0", "duration": "14m", ...}`
`refill`	`key`, `order`	`{"refill": 55}`
`cancel`	`key`, `order`	`{"cancel": 1}`

Code Integration Examples

Python 3 (v3 REST with Bearer Token)

import requests

API_URL = "https://boostedplug.com.ng/api/v3"
API_KEY = "YOUR_API_KEY_HERE"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 1. Check Balance
res = requests.get(f"{API_URL}/balance", headers=headers).json()
print("Balance:", res['data']['formatted'])

# 2. Place Order
order_payload = {
    "service": 21150,
    "link": "https://tiktok.com/@user/video/123",
    "quantity": 1000
}
order_res = requests.post(f"{API_URL}/orders", headers=headers, json=order_payload).json()
print("Order Placed:", order_res['data']['order_id'])

PHP cURL (v2 Standard / Reseller Scripts)