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

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

WhatsApp