Developer Documentation

smmto.com API

Integrate our services directly into your platform with our powerful REST API. Fast, reliable, and easy to implement. Build your own growth tool or reseller panel today.

Uptime 99.9%
Response Time <200ms
Volume 50M+
Get API Key View on GitHub

1. Getting Started

Our API is built on REST principles. It uses standard HTTP response codes, authentication, and verbs. All requests should be sent to the base URL and will return responses in JSON format.

Base URL: https://smmto.com/api/v2

2. Authentication

To authenticate your requests, you must include your unique API key as a `key` parameter in every request. You can find your API key in your account dashboard.

POST https://smmto.com/api/v2
Content-Type: application/json

{
  "key": "your-api-key-here",
  "action": "services"
}

Keep your API key secret. Do not share it in public repositories, client-side code, or documentation. If compromised, regenerate it immediately.

3. Add Order

POST /api/v2

Place a new order for any social media service available on our platform.

Parameter Type Required Description
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Request Example

{
  "key": "your-api-key",
  "action": "add",
  "service": 1,
  "link": "https://t.me/yourchannel",
  "quantity": 1000
}

Response Example

{
  "order": 23501,
  "status": "success"
}

4. Order Status

POST /api/v2

Check the status and progress of a previously placed order.

Parameter Type Required Description
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Multiple Orders

POST /api/v2

Efficiency is key. Use the bulk endpoint to place up to 100 orders in a single API call.

{
  "key": "your-api-key",
  "action": "add_bulk",
  "orders": [
    { "service": 1, "link": "link_1", "quantity": 100 },
    { "service": 2, "link": "link_2", "quantity": 250 }
  ]
}

6. Cancel Order

POST /api/v2

Cancel a pending or in-progress order by order ID.

{
  "key": "your-api-key",
  "action": "cancel",
  "order": 23501
}

7. Refill Order

POST /api/v2

Request a refill for eligible orders that dropped below the guaranteed level.

{
  "key": "your-api-key",
  "action": "refill",
  "order": 23501
}

8. Services List

POST /api/v2

Retrieve the full list of available services, rates, min/max quantities, and metadata.

{
  "key": "your-api-key",
  "action": "services"
}

9. Error Codes

The API uses standard HTTP status codes to indicate success or failure.

Code Message Description
400Invalid requestMissing or invalid parameters
401Invalid API keyAuthentication failed
404Service not foundInvalid service ID
429Rate limit exceededToo many requests
500Internal errorServer-side error

10. Rate Limits

API requests are limited to 100 requests per minute per API key. Exceeding this limit returns HTTP 429. Contact support for higher throughput on reseller plans.

11. SDKs & Libraries

12. Changelog

v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.

Panel API Methods

Service list

POST /api/v2 services
Parameter Description
key Your API key
action services

Example Response

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

POST /api/v2 add

Example Response

{
    "order": 23501
}

Order status

POST /api/v2 status
Parameter Description
key Your API key
action status
order Order ID

Example Response

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

Multiple orders status

POST /api/v2 multi_status
Parameter Description
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Example Response

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

POST /api/v2 refill
Parameter Description
key Your API key
action refill
order Order ID

Example Response

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
Parameter Description
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Example Response

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Get refill status

POST /api/v2 refill_status
Parameter Description
key Your API key
action refill_status
refill Refill ID

Example Response

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
Parameter Description
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Example Response

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

Create cancel

POST /api/v2 cancel
Parameter Description
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

Example Response

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

User balance

POST /api/v2 balance
Parameter Description
key Your API key
action balance

Example Response

{
    "balance": "100.84292",
    "currency": "USD"
}
Example PHP Code
Live Chat 24/7 Support