Developer Portal

BoostFollower API Documentation

The BoostFollower API lets developers and marketplaces connect directly to BoostFollower and automate service discovery, pricing, orders, order status, refills and wallet balance checks.

API Base URL

https://boostfollower.online/api/public

Every endpoint below is relative to this base URL.

API Partner Program — 30% OFF

Customers who actively use a valid BoostFollower API key are eligible for a 30% discount on BoostFollower services. Connect your platform, place API orders, then contact our team to verify your usage and activate your API Partner pricing. Your price = regular price × 0.70, applied automatically on our servers once your partner status is active.

Get API Key Talk to Our Team About My 30% Discount

How it works

  1. Create or sign in to your BoostFollower account.
  2. Generate an API key in Profile → API keys.
  3. Store the key securely in your own backend — never in frontend code.
  4. Fund your BoostFollower wallet (orders are charged in NGN).
  5. Retrieve available services.
  6. Create orders through the API.
  7. Check order status and request refills.
  8. Monitor your wallet balance and handle errors.

Authentication

Authenticated endpoints require a valid BoostFollower API key. Send it as an x-api-key header, or as a bearer token. Keys start with boost_live_. Requests without a valid key return 401.

x-api-key header
x-api-key: boost_live_YOUR_KEY
Bearer token
Authorization: Bearer boost_live_YOUR_KEY

Keep your API key private. Never publish it in frontend JavaScript, GitHub repositories, screenshots, public websites or client-side applications. You can revoke or regenerate a key at any time from your profile.

Endpoints

(7)

Order statuses

Pending
Processing
In Progress
Completed
Partial
Canceled
Refunded

Code examples

cURL
curl -X POST "https://boostfollower.online/api/public/order/create" \
  -H "x-api-key: boost_live_YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{"platform":"tiktok","category":"followers","quantity":1000,"link":"https://www.tiktok.com/@username"}'
JavaScript
const res = await fetch("https://boostfollower.online/api/public/order/create", {
  method: "POST",
  headers: {
    "x-api-key": process.env.BOOSTFOLLOWER_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    platform: "tiktok",
    category: "followers",
    quantity: 1000,
    link: "https://www.tiktok.com/@username",
  }),
});
const data = await res.json();
console.log(data);
PHP
<?php
$ch = curl_init("https://boostfollower.online/api/public/order/create");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: " . getenv("BOOSTFOLLOWER_API_KEY"),
    "content-type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "platform" => "tiktok",
    "category" => "followers",
    "quantity" => 1000,
    "link" => "https://www.tiktok.com/@username",
  ]),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Python
import os, requests

res = requests.post(
    "https://boostfollower.online/api/public/order/create",
    headers={
        "x-api-key": os.environ["BOOSTFOLLOWER_API_KEY"],
        "content-type": "application/json",
    },
    json={
        "platform": "tiktok",
        "category": "followers",
        "quantity": 1000,
        "link": "https://www.tiktok.com/@username",
    },
    timeout=30,
)
print(res.status_code, res.json())

Errors

  • 200OK

    The request succeeded.

  • 201Created

    The order was created and your wallet was debited.

  • 400Bad Request

    A required field is missing or a value is invalid.

  • 401Unauthorized

    The API key is missing, malformed, invalid or revoked.

  • 402Payment Required

    Your BoostFollower wallet balance is too low for this order.

  • 404Not Found

    The order or service does not exist, or does not belong to your account.

  • 502Bad Gateway

    A delivery network rejected the request or is temporarily unreachable.

  • 503Service Unavailable

    No verified delivery network currently meets the start standard for that service. Nothing was charged.

Need help getting started?

Our team can help you connect your platform and activate API Partner pricing.

WhatsApp 0807 817 7519support@boostfollower.online