Main SMM API

https://themainsmm.com/api
Admin
The Main SMM API provides a comprehensive set of endpoints for managing social media marketing...
Tokens:3,691
Snippets:20
Trust Score:5.5
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example Get Refill Status Response

Source: https://themainsmm.com/api

This JSON structure provides the status of a specific refill.

```json
{
    "status": "Completed"
}
```

--------------------------------

### Example Create Refill Response

Source: https://themainsmm.com/api

This JSON structure indicates the result of a single refill request.

```json
{
    "refill": "1"
}
```

--------------------------------

### Example User Balance Response

Source: https://themainsmm.com/api

This JSON structure displays the user's current balance and currency.

```json
{
    "balance": "100.84292",
    "currency": "USD"
}
```

--------------------------------

### Example Add Order Response

Source: https://themainsmm.com/api

This JSON structure shows the response after successfully adding a new order.

```json
{
    "order": 23501
}
```

--------------------------------

### Example Service List Response

Source: https://themainsmm.com/api

This JSON structure represents the response when requesting a list of available services.

```json
[
    {
        "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
    }
]
```

--------------------------------

### Example Order Status Response

Source: https://themainsmm.com/api

This JSON structure details the status of a specific order.

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

--------------------------------

### Example Get Multiple Refill Status Response

Source: https://themainsmm.com/api

This JSON structure shows the statuses for multiple refill requests, including potential errors.

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

--------------------------------

### Example Create Multiple Refill Response

Source: https://themainsmm.com/api

This JSON structure shows the results for multiple refill requests, including potential errors.

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

--------------------------------

### Example Create Cancel Response

Source: https://themainsmm.com/api

This JSON structure shows the results of a cancellation request for one or more orders, including potential errors.

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

--------------------------------

### Example Multiple Orders Status Response

Source: https://themainsmm.com/api

This JSON structure shows the statuses for multiple orders, including potential errors.

```json
{
    "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"
    }
}
```

--------------------------------

### Get Refill Status

Source: https://themainsmm.com/api

Retrieves the status of a specific refill request using its ID.

```APIDOC
## Get Refill Status

### Description
Checks the status of a previously created refill request.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'refill_status'
- **refill** (integer) - Required - The ID of the refill request to check.

### Response
#### Success Response (200)
- **status** (string) - The status of the refill (e.g., 'Completed', 'Pending', 'Failed').

### Response Example
```json
{
    "status": "Completed"
}
```
```

--------------------------------

### Get Multiple Refill Status

Source: https://themainsmm.com/api

Retrieves the status of multiple refill requests by providing a comma-separated list of refill IDs.

```APIDOC
## Get Multiple Refill Status

### Description
Retrieves the status for multiple refill requests simultaneously.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'refill_status'
- **refills** (string) - Required - A comma-separated list of refill IDs (up to 100 IDs).

### Response
#### Success Response (200)
Returns a JSON array where each object contains the refill ID and its status, or an error message if the refill ID is not found.
- **refill** (integer) - The ID of the refill request.
- **status** (string) - The status of the refill.
- **status** (object) - Contains an 'error' field if the refill ID is not found.
  - **error** (string) - An error message indicating the refill was not found.

### Response Example
```json
[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]
```
```

--------------------------------

### Service List

Source: https://themainsmm.com/api

Retrieves a list of available services with their details. Requires an API key and the 'services' action.

```APIDOC
## Service List

### Description
Retrieves a list of available services, including their ID, name, type, category, rate, minimum and maximum order quantities, and refill/cancel options.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'services'

### Response
#### Success Response (200)
- **service** (integer) - The unique identifier for the service.
- **name** (string) - The name of the service.
- **type** (string) - The type of service.
- **category** (string) - The category the service belongs to.
- **rate** (string) - The cost per unit of the service.
- **min** (string) - The minimum quantity that can be ordered.
- **max** (string) - The maximum quantity that can be ordered.
- **refill** (boolean) - Indicates if the service supports refills.
- **cancel** (boolean) - Indicates if the service can be canceled.

### Response Example
```json
[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    }
]
```
```

--------------------------------

### Add Order

Source: https://themainsmm.com/api

Adds a new order for a specified service. Different parameters are available for different service types (e.g., default, custom comments, subscriptions).

```APIDOC
## Add Order

### Description
Adds a new order to the system. The required parameters vary depending on the type of service being ordered. Common parameters include API key, action, service ID, and link. Additional parameters like quantity, comments, username, and delivery options may be required or optional.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'add'
- **service** (integer) - Required - The ID of the service to order.
- **link** (string) - Required - The link to the page or profile for the order.
- **quantity** (integer) - Required for some service types - The desired quantity for the order.
- **comments** (string) - Required for 'Custom Comments' type - A list of comments separated by newline characters (\n or \r\n).
- **username** (string) - Required for some subscription types - The username for the subscription.
- **min** (integer) - Required for some subscription types - The minimum quantity for the subscription.
- **max** (integer) - Required for some subscription types - The maximum quantity for the subscription.
- **answer_number** (integer) - Required for poll-related services - The answer number for the poll.
- **runs** (integer) - Optional - The number of runs for the order (if applicable).
- **interval** (integer) - Optional - The interval in minutes for recurring orders.
- **posts** (integer) - Optional - Limits the number of new posts to parse for orders.
- **old_posts** (integer) - Optional - Specifies the number of existing posts to parse for orders.
- **delay** (integer) - Optional - Delay in minutes for order processing. Possible values: 0, 5, 10, 15, 20, 30, 40, 50, 60, 90, 120, 150, 180, 210, 240, 270, 300, 360, 420, 480, 540, 600.
- **expiry** (string) - Optional - The expiry date for the order in 'd/m/Y' format.

### Response
#### Success Response (200)
- **order** (integer) - The ID of the newly created order.

### Response Example
```json
{
    "order": 23501
}
```
```

--------------------------------

### Create Multiple Refill

Source: https://themainsmm.com/api

Requests refills for multiple orders simultaneously.

```APIDOC
## Create Multiple Refill

### Description
Requests refills for multiple orders at once by providing a comma-separated list of order IDs.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'refill'
- **orders** (string) - Required - A comma-separated list of order IDs (up to 100 IDs).

### Response
#### Success Response (200)
Returns a JSON array where each object indicates the result of the refill request for a specific order.
- **order** (integer) - The ID of the order.
- **refill** (integer) - The ID of the refill request if successful.
- **refill** (object) - Contains an 'error' field if the refill failed for the given order.
  - **error** (string) - An error message indicating why the refill failed.

### Response Example
```json
[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]
```
```

--------------------------------

### User Balance

Source: https://themainsmm.com/api

Retrieves the current balance of the user's account.

```APIDOC
## User Balance

### Description
Retrieves the current account balance and currency.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'balance'

### Response
#### Success Response (200)
- **balance** (string) - The current account balance.
- **currency** (string) - The currency of the balance.

### Response Example
```json
{
    "balance": "100.84292",
    "currency": "USD"
}
```
```

--------------------------------

### Create Cancel

Source: https://themainsmm.com/api

Requests cancellation for one or more orders.

```APIDOC
## Create Cancel

### Description
Requests the cancellation of one or more orders.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'cancel'
- **orders** (string) - Required - A comma-separated list of order IDs (up to 100 IDs).

### Response
#### Success Response (200)
Returns a JSON array where each object indicates the result of the cancellation request for a specific order.
- **order** (integer) - The ID of the order.
- **cancel** (integer) - Indicates successful cancellation (usually '1').
- **cancel** (object) - Contains an 'error' field if the cancellation failed for the given order.
  - **error** (string) - An error message indicating why the cancellation failed.

### Response Example
```json
[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]
```
```

--------------------------------

### Create Refill

Source: https://themainsmm.com/api

Requests a refill for a specific order.

```APIDOC
## Create Refill

### Description
Requests a refill for a completed or partially completed order to restore its quantity.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'refill'
- **order** (integer) - Required - The ID of the order to refill.

### Response
#### Success Response (200)
- **refill** (integer) - The ID of the refill request.

### Response Example
```json
{
    "refill": "1"
}
```
```

--------------------------------

### Order Status

Source: https://themainsmm.com/api

Retrieves the status of a single order using its ID.

```APIDOC
## Order Status

### Description
Retrieves the current status and details of a specific order.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'status'
- **order** (integer) - Required - The ID of the order to check.

### Response
#### Success Response (200)
- **charge** (string) - The amount charged for the order.
- **start_count** (string) - The initial count when the order started.
- **status** (string) - The current status of the order (e.g., 'Partial', 'In progress', 'Completed').
- **remains** (string) - The remaining quantity to be delivered.
- **currency** (string) - The currency used for the charge.

### Response Example
```json
{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}
```
```

--------------------------------

### Multiple Orders Status

Source: https://themainsmm.com/api

Retrieves the status of multiple orders by providing a comma-separated list of order IDs.

```APIDOC
## Multiple Orders Status

### Description
Retrieves the status and details for multiple orders simultaneously by providing their IDs.

### Method
POST

### Endpoint
https://themainsmm.com/api/v2

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key
- **action** (string) - Required - Must be set to 'status'
- **orders** (string) - Required - A comma-separated list of order IDs (up to 100 IDs).

### Response
#### Success Response (200)
Returns a JSON object where keys are the order IDs and values are the status details for each order. If an order ID is invalid, an 'error' field will be present for that ID.
- **order_id** (object)
  - **charge** (string) - The amount charged for the order.
  - **start_count** (string) - The initial count when the order started.
  - **status** (string) - The current status of the order.
  - **remains** (string) - The remaining quantity to be delivered.
  - **currency** (string) - The currency used for the charge.
  - **error** (string) - An error message if the order ID is invalid.

### Response Example
```json
{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    }
}
```
```
Tokens:
Raw