RGSMM API Documentation

Introduction

The RGSMM API allows you to programmatically access our SMM services. You can check balances, place orders, and track order status using simple HTTP requests.

Base URL

https://api.rgsmm.com/v1

Response Format

All responses are returned in JSON format.

Rate Limiting

API requests are limited to 60 requests per minute per API key.

Authentication

All API requests require authentication using your API key. Include your API key in the request headers:

X-API-Key: your-api-key-here

You can generate API keys from your dashboard under Settings > API Keys.

GET /balance

Get your current account balance.

Response

{
    "status": "success",
    "balance": 150.25,
    "currency": "USD"
}
                

Example Request

curl -X GET https://api.rgsmm.com/v1/balance \
  -H "X-API-Key: your-api-key"
                

GET /services

Get list of all available services.

Response

[
    {
        "id": 1,
        "name": "Instagram Followers",
        "category": "Instagram",
        "type": "default",
        "price": 2.50,
        "min": 10,
        "max": 10000,
        "description": "High quality Instagram followers",
        "required_fields": null,
        "processing_time": "Instant",
        "refill_possible": true,
        "cancel_possible": false
    }
]
                

POST /order

Place a new order.

Parameters

Parameter	Type	Required	Description
service	integer	Required	Service ID from the services list
link	string	Required	URL to the target profile/post
quantity	integer	Required	Number of likes/followers/etc
custom_data	object	Optional	Additional service-specific parameters

Example Request

curl -X POST https://api.rgsmm.com/v1/order \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "service": 1,
    "link": "https://instagram.com/username",
    "quantity": 100
  }'
                

Success Response

{
    "status": "success",
    "order_id": "ORD-20231225-ABCDEF",
    "service": "Instagram Followers",
    "quantity": 100,
    "price": 2.50,
    "balance": 147.75,
    "created_at": "2023-12-25T10:30:00Z"
}
                

GET /status/{order_id}

Get order status by order ID.

Parameters

Parameter	Type	Required	Description
order_id	string	Required	The order ID from the order response

Response

{
    "order_id": "ORD-20231225-ABCDEF",
    "service": "Instagram Followers",
    "link": "https://instagram.com/username",
    "quantity": 100,
    "price": 2.50,
    "status": "completed",
    "start_count": 45,
    "remains": 0,
    "created_at": "2023-12-25T10:30:00Z",
    "updated_at": "2023-12-25T10:35:00Z",
    "completed_at": "2023-12-25T10:35:00Z"
}
                

Status Values

pending - Order received and queued
processing - Order is being processed
in_progress - Order is in progress
completed - Order completed successfully
partial - Partially completed
cancelled - Order cancelled
error - Order failed

Error Codes

HTTP Code	Error	Description
400	Bad Request	Invalid parameters or validation failed
401	Unauthorized	Invalid or missing API key
403	Forbidden	IP not whitelisted or insufficient permissions
404	Not Found	Resource not found
422	Unprocessable Entity	Validation errors
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server error, contact support

Error Response Format

{
    "error": "Error message description",
    "messages": {
        "field": ["Validation error for field"]
    }
}
                

Code Examples

<?php

$apiKey = 'your-api-key';
$baseUrl = 'https://api.rgsmm.com/v1';

// Get balance
$ch = curl_init($baseUrl . '/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$balance = json_decode($response, true);
echo "Current balance: {$balance['balance']} {$balance['currency']}\n";

// Place order
$orderData = [
    'service' => 1,
    'link' => 'https://instagram.com/username',
    'quantity' => 100
];

$ch = curl_init($baseUrl . '/order');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($orderData));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

if ($order['status'] === 'success') {
    echo "Order placed: {$order['order_id']}\n";
}

curl_close($ch);
?>
                        

import requests

api_key = 'your-api-key'
base_url = 'https://api.rgsmm.com/v1'

headers = {
    'X-API-Key': api_key
}

# Get balance
response = requests.get(f'{base_url}/balance', headers=headers)
balance = response.json()
print(f"Current balance: {balance['balance']} {balance['currency']}")

# Get services
response = requests.get(f'{base_url}/services', headers=headers)
services = response.json()
for service in services:
    print(f"{service['id']}: {service['name']} - ${service['price']}")

# Place order
order_data = {
    'service': 1,
    'link': 'https://instagram.com/username',
    'quantity': 100
}

response = requests.post(
    f'{base_url}/order',
    headers=headers,
    json=order_data
)

order = response.json()
if order['status'] == 'success':
    print(f"Order placed: {order['order_id']}")
                        

const axios = require('axios');

const apiKey = 'your-api-key';
const baseUrl = 'https://api.rgsmm.com/v1';

const api = axios.create({
    baseURL: baseUrl,
    headers: {
        'X-API-Key': apiKey
    }
});

// Get balance
api.get('/balance')
    .then(response => {
        console.log(`Current balance: ${response.data.balance} ${response.data.currency}`);
    })
    .catch(error => {
        console.error('Error:', error.response.data);
    });

// Place order
const orderData = {
    service: 1,
    link: 'https://instagram.com/username',
    quantity: 100
};

api.post('/order', orderData)
    .then(response => {
        if (response.data.status === 'success') {
            console.log(`Order placed: ${response.data.order_id}`);
        }
    })
    .catch(error => {
        console.error('Error:', error.response.data);
    });
                        