API Documentation SECURE

API Version

v1 v2 (Current) v3 (Coming Soon)

Rate Limiting

API requests are limited to 60 requests per minute per API key. Exceeding this limit will result in a 429 Too Many Requests response.

Authentication Methods

API Key Authentication

Include your API key in all requests as a URL parameter:

?key=YOUR_API_KEY

Get your API key from the Account page.

Bearer Token Authentication RECOMMENDED

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

GET API Base URL

HTTP Method	POST (recommended) or GET
API URL	https://devsmm.store/api/v2
Return Format	JSON
SSL/TLS	Required (HTTPS only)

POST Service List

Retrieve a list of all available services with their current rates and limits.

Parameter	Required	Type	Description
key	Yes	String	Your API Key
action	Yes	String	Must be "services"
category	No	String	Filter by category name

Response Fields

Field	Type	Description
service	Integer	Unique service ID
name	String	Service name
type	String	Service type
category	String	Category name
rate	Decimal	Price per 1000 units
min	Integer	Minimum order quantity
max	Integer	Maximum order quantity
description	String	Service description
refill	Boolean	Whether refill is available

Example Request

curl -X POST "https://devsmm.store/api/v2" \
-d "key=YOUR_API_KEY" \
-d "action=services"

Example Response

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "description": "High quality followers with profile pictures",
        "refill": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "description": "Custom comments with your specified text",
        "refill": false
    }
]

POST Create New Order

Place a new order for a specific service.

Parameter	Required	Type	Description
key	Yes	String	Your API Key
action	Yes	String	Must be "add"
service	Yes	Integer	Service ID
link	Yes	String	URL to your content
quantity	Yes	Integer	Number to order (within min/max)
runs	No	Integer	Number of runs to deliver (for drip-feed)
interval	No	Integer	Minutes between runs (for drip-feed)
custom_data	No	String	Custom parameters (comments, usernames, etc.)

Response Fields

Field	Type	Description
order	Integer	Unique order ID
charge	Decimal	Amount charged
start_count	Integer	Initial count (if applicable)
status	String	Order status
remains	Integer	Remaining quantity

Example Request

curl -X POST "https://devsmm.store/api/v2" \
-d "key=YOUR_API_KEY" \
-d "action=add" \
-d "service=1" \
-d "link=https://example.com" \
-d "quantity=1000"

Example Response

{
    "order": 23501,
    "charge": "0.90",
    "start_count": "0",
    "status": "Pending",
    "remains": "1000",
    "currency": "USD"
}

POST Order Status

Check the status of an existing order.

Parameter	Required	Type	Description
key	Yes	String	Your API Key
action	Yes	String	Must be "status"
order	Yes	Integer	Order ID to check

Response Fields

Field	Type	Description
charge	Decimal	Amount charged
start_count	Integer	Initial count
status	String	Order status (Pending, In progress, Partial, Completed, Cancelled)
remains	Integer	Remaining quantity
currency	String	Currency used
delivered	Integer	Quantity delivered
refunded	Decimal	Amount refunded (if any)

Status Codes

Status	Description
Pending	Order is in queue, not started yet
In progress	Order is currently being processed
Partial	Order is partially completed
Completed	Order is fully completed
Cancelled	Order was cancelled (may include partial refund)

Example Request

curl -X POST "https://devsmm.store/api/v2" \
-d "key=YOUR_API_KEY" \
-d "action=status" \
-d "order=23501"

Example Response

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "delivered": "9843",
    "currency": "USD"
}

POST User Balance

Check your current account balance.

Parameter	Required	Type	Description
key	Yes	String	Your API Key
action	Yes	String	Must be "balance"

Response Fields

Field	Type	Description
balance	Decimal	Current account balance
currency	String	Account currency
pending_charges	Decimal	Amount reserved for pending orders

Example Request

curl -X POST "https://devsmm.store/api/v2" \
-d "key=YOUR_API_KEY" \
-d "action=balance"

Example Response

{
    "balance": "100.84292",
    "currency": "USD",
    "pending_charges": "15.75"
}

POST Error Codes

Possible error responses from the API.

Code	Message	Description
400	Invalid API key	The provided API key is invalid
401	Unauthorized	Authentication required or failed
402	Insufficient balance	Not enough funds to place the order
403	Access denied	Your account doesn't have API access
404	Service not found	The requested service doesn't exist
406	Invalid parameters	Required parameters missing or invalid
429	Too many requests	Rate limit exceeded
500	Internal server error	Server-side issue, try again later
503	Service unavailable	Temporary maintenance or overload

Download PHP Example File OpenAPI/Swagger Specification