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 |