API Documentation

Integrate our SMM services directly into your application with our powerful RESTful API

Method POST
URL https://api.botzzz773.com/v2
Format JSON

Getting Started

1

Get Your API Key

Sign up and generate your unique API key from the dashboard

2

Make API Requests

Use POST method to send requests with your API key

3

Receive JSON Response

Get instant JSON responses with order details and status

Authentication

All API requests require your unique API key for authentication

Security Best Practices

  • Never share your API key publicly or commit it to version control
  • Store API keys in environment variables or secure vaults
  • Regenerate keys immediately if compromised
  • Use HTTPS only for all API requests
  • Implement rate limiting on your side to prevent abuse
Request Example
{
    "key": "a8Kx9mP!4nQr2sT-vWy5zB@7cDe-fGh3jK#6lMn-pRs1tU",
    "action": "services"
}

API Endpoints

Get Services List

GET

Retrieve all available services with pricing and details

Parameters

key
string
Your API key
action
string
services

Example Request

cURL
curl -X POST https://api.botzzz773.com/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key": "a8Kx9mP!4nQr2sT-vWy5zB@7cDe-fGh3jK#6lMn-pRs1tU",
    "action": "services"
  }'

Example Response

JSON
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "1.81",
    "min": "100",
    "max": "100000",
    "refill": true,
    "cancel": true
  },
  {
    "service": 2,
    "name": "Instagram Likes",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.11",
    "min": "50",
    "max": "50000",
    "refill": true,
    "cancel": true
  }
]

Create New Order

POST

Place a new order for a specific service

Parameters

key
string
Your API key
action
string
add
service
integer
Service ID
link
string
Link to your profile/post
quantity
integer
Quantity to order

Example Request

JavaScript
const response = await fetch('https://api.botzzz773.com/v2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    key: 'a8Kx9mP!4nQr2sT-vWy5zB@7cDe-fGh3jK#6lMn-pRs1tU',
    action: 'add',
    service: 1,
    link: 'https://instagram.com/username',
    quantity: 1000
  })
});

const data = await response.json();
console.log(data);

Example Response

JSON
{
  "order": 23501
}

Check Order Status

GET

Get the current status of your order

Parameters

key
string
Your API key
action
string
status
order
integer
Order ID

Example Response

JSON
{
  "charge": "1.81",
  "start_count": "1250",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Get Account Balance

GET

Check your current account balance

Parameters

key
string
Your API key
action
string
balance

Example Response

JSON
{
  "balance": "250.84",
  "currency": "USD"
}

Create Refill

POST

Request a refill for an existing order

Parameters

key
string
Your API key
action
string
refill
order
integer
Order ID to refill

Example Response

JSON
{
  "refill": "1"
}

Cancel Order

DELETE

Cancel a pending order

Parameters

key
string
Your API key
action
string
cancel
orders
string
Order IDs (comma separated, max 100)

Example Response

JSON
[
  {
    "order": 23501,
    "cancel": 1
  }
]

Error Handling

400
Invalid API key or missing parameters
401
Unauthorized - API key is invalid
404
Service or order not found
429
Too many requests - rate limit exceeded
500
Internal server error

Code Examples

PHP

example.php
<?php
$api_key = 'a8Kx9mP!4nQr2sT-vWy5zB@7cDe-fGh3jK#6lMn-pRs1tU';
$api_url = 'https://api.botzzz773.com/v2';

$data = array(
    'key' => $api_key,
    'action' => 'add',
    'service' => 1,
    'link' => 'https://instagram.com/username',
    'quantity' => 1000
);

$ch = curl_init($api_url);
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, array(
    'Content-Type: application/json'
));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo 'Order ID: ' . $result['order'];
?>

Python

example.py
import requests
import json

api_key = 'a8Kx9mP!4nQr2sT-vWy5zB@7cDe-fGh3jK#6lMn-pRs1tU'
api_url = 'https://api.botzzz773.com/v2'

data = {
    'key': api_key,
    'action': 'add',
    'service': 1,
    'link': 'https://instagram.com/username',
    'quantity': 1000
}

response = requests.post(
    api_url,
    json=data,
    headers={'Content-Type': 'application/json'}
)

result = response.json()
print(f"Order ID: {result['order']}")

Node.js

example.js
const axios = require('axios');

const apiKey = 'a8Kx9mP!4nQr2sT-vWy5zB@7cDe-fGh3jK#6lMn-pRs1tU';
const apiUrl = 'https://api.botzzz773.com/v2';

const data = {
  key: apiKey,
  action: 'add',
  service: 1,
  link: 'https://instagram.com/username',
  quantity: 1000
};

axios.post(apiUrl, data)
  .then(response => {
    console.log('Order ID:', response.data.order);
  })
  .catch(error => {
    console.error('Error:', error);
  });