Live & Documented
API Documentation
Automate your orders and manage your account fully via our simple, standards-compliant API.
1
Authentication
The API uses API Keys for authentication. Generate your key from the dashboard under the "API" section. Send your key with every request using one of two methods:
-
Header: Send
Authorization: Bearer YOUR_API_KEY -
Body parameter: Send
key=YOUR_API_KEYin the request body
Never share your API key. If compromised, delete it immediately and generate a new one.
All requests use POST method and must include
Content-Type: application/x-www-form-urlencoded or application/json. All responses are JSON.
2
Services List
POST
services
Get all available services
Request Example
POST https://t.smmxcel.shop/api/v2
key=YOUR_API_KEY
action=services
Response
[
{
"service": 1,
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "0.50", // USD per 1000
"min": 100,
"max": 10000,
"refill": true,
"cancel": false,
"description": "High quality followers..."
}
]
3
Balance
POST
balance
Get your account balance
Request Example
POST https://t.smmxcel.shop/api/v2 key=YOUR_API_KEY action=balance
Response
{
"balance": "98.54200",
"currency": "USD"
}
4
Add Order
Price is calculated as:
(quantity / 1000) × rate. Deducted from your balance immediately.
POST
add
Default Order
| Parameter | Type | Description |
|---|---|---|
| keyRequired | string | Your API key |
| actionRequired | string | add |
| serviceRequired | integer | Service ID |
| linkRequired | string | URL of the page or post |
| quantityRequired | integer | Quantity (between service min and max) |
| runsOptional | integer | Number of runs (Drip Feed) |
| delayOptional | integer | Delay between runs in minutes |
Example
key=YOUR_API_KEY action=add service=1 link=https://instagram.com/username quantity=1000 // Response { "order": 23501 }
POST
add
Custom Comments Order
| Parameter | Type | Description |
|---|---|---|
| serviceRequired | integer | Service ID (Custom Comments type) |
| linkRequired | string | Post URL |
| commentsRequired | string | Comments — one per line |
Example
key=YOUR_API_KEY action=add service=15 link=https://instagram.com/p/ABC123 comments=Amazing post!\nLove this content!\nGreat work! // Response { "order": 23502 }
POST
add
Subscriptions Order
| Parameter | Type | Description |
|---|---|---|
| serviceRequired | integer | Subscriptions service ID |
| usernameRequired | string | Username (without @) |
| minRequired | integer | Min followers count |
| maxRequired | integer | Max followers count |
| postsRequired | integer | Number of posts |
| delayRequired | integer | Delay in minutes |
5
Order Status
POST
status
Single or Multiple Orders
| Parameter | Type | Description |
|---|---|---|
| orderOptional | integer | Order ID (single order) |
| ordersOptional | string | Comma-separated order IDs (up to 100) |
Response — Single
{
"charge": "0.50000",
"start_count": "1200",
"status": "Completed",
"remains": "0",
"currency": "USD"
}
Response — Multiple
{
"23501": { "status": "Completed", "remains": "0", ... },
"23502": { "status": "In progress", "remains": "500", ... },
"99999": { "error": "Incorrect order ID" }
}
Possible Order Statuses
- ● Pending
- ● In progress
- ● Active
- ● Completed
- ● Partial
- ● Canceled
- ● Failed
6
Refill
Refill is only available for
Completed orders with services that support it (refill: true).
POST
refill
Create Refill
| Parameter | Type | Description |
|---|---|---|
| orderOptional | integer | Order ID (single) |
| ordersOptional | string | Comma-separated IDs |
Response
{ "refill": 9901 }
Response
[
{ "order": 23501, "refill": 9901 },
{ "order": 23502, "refill": { "error": "Refill not available" } }
]
POST
refill_status
Refill Status
| Parameter | Type | Description |
|---|---|---|
| refillOptional | integer | Refill ID (single) |
| refillsOptional | string | Comma-separated IDs |
Response
// Single { "status": "Completed" } // Multiple [ { "refill": 9901, "status": "Completed" }, { "refill": 9902, "status": "Pending" } ]
7
Cancel Order
Cancel is only available for
Pending orders with services that support it (cancel: true).
POST
cancel
Cancel One or More Orders
| Parameter | Type | Description |
|---|---|---|
| ordersRequired | string | One or comma-separated order IDs |
Response
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "Cancel not available" } }
]
8
Error Messages
| Error | Description |
|---|---|
| Unauthenticated | Invalid or missing API key |
| This API key does not have permission for this action | Key lacks ability for this action |
| Service not found or inactive | Service does not exist or is disabled |
| Quantity must be between {min} and {max} | Quantity out of allowed range |
| Insufficient balance | Not enough balance to place order |
| Incorrect order ID | Order ID invalid or not yours |
| Refill not available | Refill not supported for this order |
| Cancel not available | Cancel not supported for this order |
| Unknown action | Unrecognized action value |