API v1.0

PND SUB API - Power Your Applications

Integrate our social media growth services directly into your applications, websites, or automation scripts with our comprehensive REST API.

Real-time Integration

Instant API responses with JSON format

Secure Authentication

API key based authentication with HTTPS

Full Automation

Automate orders, track status, get balance

Multi-language Support

Works with PHP, Python, JavaScript, etc.

Example API Request

PHP cURL Example

PHP

// Get services via API
$apiKey = "YOUR_API_KEY_HERE";
$url = "https://pndsub.ng/api/services";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['code'] == 200) {
    foreach ($data['data'] as $service) {
        echo $service['name'] . " - ₦" . $service['price'];
    }
}
curl_close($ch);
                            

API Overview

Everything you need to integrate PND SUB services into your applications

Base URL

https://pndsub.com.ng/api/

All API endpoints are relative to this base URL

Request/Response Format

JSON UTF-8

All requests and responses use JSON format with UTF-8 encoding

Security

HTTPS API Key

All endpoints require HTTPS and API key authentication

Standard Response Format


{
    "code": 200,
    "message": "Success message",
    "data": {
        // Response data here
    },
    "pagination": {
        "page": 1,
        "limit": 50,
        "total": 100,
        "pages": 2
    }
}
                    

All API responses follow this consistent format. Error responses include appropriate HTTP status codes.

API Authentication

Secure access to your account and services

API Key Authentication

Every request must include your API key for authentication

Header Method (Recommended)

Authorization: Bearer YOUR_API_KEY_HERE

Query Parameter Method

https://pndsub.com.ng/api/services?api_key=YOUR_API_KEY_HERE

How to Get Your API Key

  1. Login to your PND SUB account
  2. Go to Profile Settings
  3. Click on "API Settings"
  4. Generate a new API key or use existing one
  5. Copy your API key (keep it secret!)
Important Security Note:

Your API key is like a password. Never share it publicly or commit it to version control. If compromised, regenerate it immediately.

API Endpoints

Complete list of available API endpoints

GET

/api/services

Public

Retrieve all available services with filtering and pagination

Query Parameters

Parameter Type Required Description
page integer No Page number (default: 1)
limit integer No Items per page (default: 50, max: 100)
category_id string No Filter by category ID
social string No Filter by social media platform
search string No Search in service names

Response Example


{
    "code": 200,
    "message": "Services retrieved successfully",
    "data": [
        {
            "id": 123,
            "service_id": "IGL1",
            "name": "Instagram Likes",
            "category_id": "1",
            "social": "Instagram",
            "min": "50",
            "max": "10000",
            "price": "20.00",
            "description": "High quality Instagram likes",
            "avg_delivery_time": "5-30 minutes",
            "quality_rating": "high"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 50,
        "total": 150,
        "pages": 3
    }
}
                                    
GET

/api/service/{id}

Public

Get detailed information about a specific service

Path Parameters

Parameter Type Required Description
id integer Yes Service ID
POST

/api/order/create

Private

Create a new service order

Request Body (JSON)


{
    "service_id": 123,
    "link": "https://instagram.com/p/your_post",
    "quantity": 1000,
    "comments": "Please deliver fast"
}
                                    

Response Example


{
    "code": 200,
    "message": "Order created successfully",
    "data": {
        "order_id": "ORD1672584934567",
        "order_db_id": 456,
        "service_id": 123,
        "service_name": "Instagram Likes",
        "link": "https://instagram.com/p/your_post",
        "quantity": 1000,
        "charge": 20000,
        "new_balance": 50000,
        "status": "pending",
        "estimated_delivery": "5-30 minutes",
        "created_at": "2024-01-01 12:00:00"
    }
}
                                    
GET

/api/orders

Private

Get user's orders with filtering

Query Parameters

Parameter Type Required Description
status string No Filter by status (pending, completed, etc.)
service_id integer No Filter by service ID
start_date date No Filter from date (YYYY-MM-DD)
end_date date No Filter to date (YYYY-MM-DD)
GET

/api/order/{id}

Private

Get detailed information about a specific order

GET

/api/balance

Private

Get user's current account balance

Response Example


{
    "code": 200,
    "message": "Balance retrieved successfully",
    "data": {
        "balance": 50000.00,
        "currency": "₦",
        "user_id": 123,
        "email": "user@example.com",
        "username": "user123"
    }
}
                                    
GET

/api/socials

Public

Get all available social media platforms

GET

/api/categories

Public

Get all service categories

Code Examples

Implementation examples in various programming languages

Create Order in PHP


$apiKey = "YOUR_API_KEY_HERE";
$apiUrl = "https://pndsub.com.ng/api/order/create";

$data = [
    'service_id' => 123,
    'link' => 'https://instagram.com/p/post_id',
    'quantity' => 1000,
    'comments' => 'Fast delivery please'
];

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $result = json_decode($response, true);
    echo "Order created: " . $result['data']['order_id'];
} else {
    echo "Error: " . $response;
}
                            

Get Balance in Python


import requests

api_key = "YOUR_API_KEY_HERE"
url = "https://pndsub.com.ng/api/balance"

headers = {
    "Authorization": f"Bearer {api_key}"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    balance = data['data']['balance']
    print(f"Current Balance: ₦{balance}")
else:
    print(f"Error: {response.text}")
                            

Get Services in JavaScript (Node.js)


const axios = require('axios');

const apiKey = 'YOUR_API_KEY_HERE';
const apiUrl = 'https://pndsub.com.ng/api/services';

axios.get(apiUrl, {
    headers: {
        'Authorization': `Bearer ${apiKey}`
    },
    params: {
        page: 1,
        limit: 10,
        social: 'Instagram'
    }
})
.then(response => {
    const services = response.data.data;
    services.forEach(service => {
        console.log(`${service.name}: ₦${service.price}`);
    });
})
.catch(error => {
    console.error('Error:', error.response?.data || error.message);
});
                            

cURL Commands


# Get balance
curl -X GET "https://pndsub.com.ng/api/balance" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

# Get services with filters
curl -X GET "https://pndsub.com.ng/api/services?social=Instagram&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

# Create order
curl -X POST "https://pndsub.com.ng/api/order/create" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 123,
    "link": "https://instagram.com/p/post_id",
    "quantity": 1000
  }'
                            

Test API Live

Try our API endpoints directly from your browser

API Response

{
    "code": 0,
    "message": "Enter your API key and click 'Test API'"
}