API Documentation
Our API uses the POST method for all requests. All responses are returned in JSON format.
| HTTP Method | POST |
| API URL | https://smminsights.xyz/api/v2 |
| Return format | JSON |
Contents
Service List
| Parameters | Explanation |
|---|---|
| key | Your API Key |
| action | services |
Sample return
[
{
"service": 1,
"name": "Followers",
"type": "Default",
"category": "First Category",
"rate": "0.90",
"min": "50",
"max": "10000",
"refill": true,
"cancel": false
},
{
"service": 2,
"name": "Comments",
"type": "Custom Comments",
"category": "Second Category",
"rate": "8",
"min": "10",
"max": "1500",
"refill": false,
"cancel": true
}
]
New Order
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | add |
| service | Service ID |
| link | Service connection (URL) |
| quantity | Quantity |
| comments (optional) | Custom comments array for Custom Comments service type |
| username (optional) | Username for services that require it |
| runs (optional) | Runs to deliver for Drip Feed orders |
| interval (optional) | Interval in minutes for Drip Feed orders |
| posts (optional) | Number of posts for Subscription orders |
| min (optional) | Minimum quantity for Package services |
| max (optional) | Maximum quantity for Package services |
| delay (optional) | Delay in minutes for Subscription orders |
| expiry (optional) | Expiry date for Subscription orders (format: YYYY-MM-DD) |
Sample return
{
"order": 23501
}
Order Status
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | status |
| order | Order ID |
Sample return for regular order
{
"charge": "0.27819",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD"
}
Sample return for subscription order
{
"status": "Active",
"posts": "12"
}
Sample return for drip feed order
{
"status": "In Progress",
"runs": "2"
}
Multiple Orders Status
Use this endpoint to efficiently check the status of multiple orders in a single API call!
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | multi_status |
| orders | Array of Order IDs |
Sample request
curl -X POST "https://smminsights.xyz/api/v2" \ -d "key=your_api_key" \ -d "action=multi_status" \ -d "orders[]=23501" \ -d "orders[]=23502" \ -d "orders[]=23503"
Sample return
[
{
"order": 23501,
"charge": "0.27819",
"start_count": "3572",
"status": "Partial",
"remains": "157"
},
{
"order": 23502,
"charge": "1.80000",
"start_count": "5000",
"status": "Completed",
"remains": "0"
},
{
"order": 23503,
"status": "Active",
"posts": "7"
}
]
User Balance
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | balance |
Sample return
{
"balance": "100.84292",
"currency": "USD"
}
Refill Order
Only available for services that support refills (check "refill": true in services list).
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | refill |
| order | Order ID to refill |
Sample return
{
"refill": 955
}
Refill Status
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | refill_status |
| refill | Refill ID |
Sample return
{
"status": "Completed"
}
Update Refill/Cancel Status
This endpoint allows you to update refill and cancel availability for services from your providers.
| Parameter | Explanation |
|---|---|
| key | Your API Key |
| action | update_refill_cancel |
| service_id (optional) | Specific service ID to update (if empty, all services will be updated) |
Sample return
{
"status": "success",
"updated": 156,
"errors": 2
}
Error Codes & Responses
| Error Message | Description |
|---|---|
| Incorrect request. | Missing required parameters (action or key) |
| Invalid API Key. | The API key provided does not exist |
| The account is inactive. | The client account associated with the API key is disabled |
| No order was placed with this ORDER ID. | The order ID provided does not exist or doesn't belong to your account |
| No service categories found. | No service categories are available |
| No services found. | No services are available |
| Orders parameter must be an array of order IDs. | The orders parameter in multi_status action must be an array |
| Service does not support refills. | You tried to refill an order for a service that doesn't support refills |