Developer API

API Documentation

Integrate your application with the API, automate orders, retrieve services, check order status, manage refills and access account balance from one clean developer workspace.

v2 API VERSION
Api Documentations
HTTP Method POST
API URL https://mainsmmserver.com/api/v2
API Key Get an API key on the Account page
Response format JSON
Service list
Parameters 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

Example response

{
    "order": 23501
}
                            
Order status
Parameters Description
keyYour API key
actionstatus
orderOrder ID

Example response

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}
                            
Multiple orders status
Parameters Description
keyYour API key
actionstatus
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
Parameters Description
keyYour API key
actionrefill
orderOrder ID

Example response

{
    "refill": "1"
}
                            
Create multiple refill
Parameters Description
keyYour API key
actionrefill
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
Parameters Description
keyYour API key
actionrefill_status
refillRefill ID

Example response

{
    "status": "Completed"
}
                            
Get multiple refill status
Parameters Description
keyYour API key
actionrefill_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
Parameters Description
keyYour API key
actioncancel
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
Parameters Description
keyYour API key
actionbalance

Example response

{
    "balance": "100.84292",
    "currency": "USD"
}
                            
SMM API Resource Center

SMM API Documentation, Integration & Automation Guide

This SMM API documentation provides developers with a structured reference for connecting applications, reseller systems, websites and custom dashboards with social media marketing services. The API documentation explains authentication, service discovery, order creation, order status, refill operations, cancellation requests and account balance retrieval.

Developers can use the service list to discover available services and identify the service type before submitting an order. Because different service types can require different parameters, applications should build requests according to the documented parameter structure returned for each service.

SMM API Integration Connect your application, website, reseller dashboard or custom software with structured API requests.
Service List API Retrieve service information including service IDs, names, types, categories, rates, minimums and maximums.
Automated Orders Build automated ordering workflows without manually repeating dashboard operations.
Order Status API Retrieve documented order information such as status, remains, charge and start count.
Refill Management Use the documented refill actions and refill status operations where supported.
Balance API Retrieve the connected account balance and currency through the documented balance action.

What Is an SMM API?

An SMM API is a programmatic interface that allows software to communicate with a social media marketing service platform. Instead of manually performing every operation through a web dashboard, a developer can create software that sends an API request and processes the returned response.

How SMM API Integration Works

A typical integration starts with an API key and a documented action. The application sends the required parameters using the supported HTTP method and receives a JSON response. The application can then store an order ID, display information to a customer, update an internal dashboard or start another application workflow.

SMM Reseller API Automation

Reseller platforms and digital agencies can use API integration to connect a customer-facing ordering system with a service provider. A custom reseller workflow may retrieve services, display selected service information, accept an order request and save the returned order ID for later status checking.

Service Types and API Parameters

The Add Order documentation contains multiple service types. Some services use basic parameters such as service, link and quantity, while other services may require comments, usernames, hashtags, media URLs, poll answers or subscription settings. Your application should use the parameters associated with the selected service type.

Order Status and JSON Processing

JSON responses can be processed by many programming languages and frameworks. A developer can parse the returned properties and use them in an order dashboard, customer portal, reporting system or automation workflow. Applications should also handle error responses instead of assuming that every request succeeds.

Bulk API Operations

The documentation includes multiple-order status, multiple refill and cancellation operations. Bulk operations can help applications process several IDs within the documented limits. When processing a bulk response, each returned item should be checked separately because an individual ID may return an error while other IDs succeed.

API Security Best Practices

Keep API credentials private and avoid exposing sensitive keys in public client-side source code. When possible, perform authenticated API requests from a secure server-side environment. Validate application input, protect administrative configuration and use secure HTTPS connections for production integrations.

SMM API for Developers, Agencies and Resellers

An API can be useful for developers building custom ordering interfaces, agencies managing multiple workflows, freelancers creating client dashboards and resellers connecting their own software with service operations. The exact implementation depends on the application's architecture and the API services available to the connected account.

Frequently Asked Questions About SMM API

What is an SMM API?
An SMM API is a programmatic interface that allows software to communicate with an SMM service platform through structured requests and responses.

What format does the API return?
The documented API uses JSON responses.

How do I get an API key?
Authenticated users can access the Account page referenced in the API documentation to obtain their API key.

Can I automate SMM orders?
Yes. Developers can integrate the documented order actions into a custom application and automate the order workflow.

Can I check order status through the API?
Yes. The documented status action accepts an order ID and returns the available order information.

Can I use refill operations?
The documentation includes refill and refill-status actions for supported workflows.

Can multiple orders be processed?
The documentation includes multiple-order status, multiple refill and cancellation operations where the relevant parameters are provided.