API

HTTP Method	POST
API URL	https://nhiemvucheo.mastersmm.net/api/v2
API Key	Your API key
Response format	JSON
Currency	VND

Service list

Parameters	Description
key	Your API key
action	services

[
    {
        "service": 1,
        "name": "Reactions",
        "type": "Reaction",
        "category": "Facebook — Post reactions",
        "rate": "6300.06",
        "min": 50,
        "max": 50000,
        "refill": false,
        "cancel": false,
        "currency": "vnd",
        "data": {
            "allow_reaction": true,
            "allow_multi_reaction": true,
            "reactions": ["like", "love", "care", "haha", "wow", "sad", "angry"]
        }
    },
    {
        "service": 1000101,
        "name": "Like",
        "type": "Default",
        "category": "Facebook — Post reactions",
        "rate": "6300.06",
        "min": 50,
        "max": 50000,
        "refill": false,
        "cancel": false,
        "currency": "vnd"
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Facebook — Post comments",
        "rate": "225",
        "min": 10,
        "max": 5000,
        "refill": false,
        "cancel": true,
        "currency": "vnd"
    }
]

rate is the price per 1000 in VND.

Add order

Default Reaction Custom Comments

Parameters	Description
key	Your API key
action	add
service	Service ID
link	Link to page
quantity	Needed quantity
reaction (optional)	Reaction, e.g. like or like,love. Defaults to the first reaction of the service
comments	Comments list separated by \n (one comment per line)
idempotency_key (optional)	Unique key, at least 8 characters, to prevent duplicate orders

{
    "order": 23501
}

Order status

Parameters	Description
key	Your API key
action	status
order	Order ID

{
    "charge": "1575.02",
    "start_count": "77",
    "status": "In progress",
    "remains": "1",
    "currency": "vnd"
}

Multiple orders status

Parameters	Description
key	Your API key
action	status
orders	Order IDs (separated by a comma, up to 100 IDs)

{
    "199593": {
        "charge": "1575.02",
        "start_count": "77",
        "status": "In progress",
        "remains": "1",
        "currency": "vnd"
    },
    "199594": {
        "error": "order_not_found"
    }
}

Responses are always keyed by order ID, even when only one ID is sent.

Create cancel

Parameters	Description
key	Your API key
action	cancel
orders	Order IDs (separated by a comma)

Only for services with "cancel": true. The undelivered part is refunded.

User balance

Parameters	Description
key	Your API key
action	balance

{
    "balance": "9000.09",
    "currency": "vnd"
}

Create refill

Parameters	Description
key	Your API key
action	refill
order	Order ID

{
    "error": "order_not_refillable"
}

Refill is not available yet. refill_status returns the same error.

Order statuses

Status	Description
Pending	Order created, waiting to start
In progress	Order is running
Completed	Order fully delivered
Partial	Stopped before completion, the rest is refunded
Canceled	Order canceled and fully refunded

Errors

Error	Description
invalid_api_key	Wrong or missing API key (HTTP 401)
invalid_action	Unknown action
invalid_service	Wrong service ID
invalid_link	Wrong link
invalid_quantity	Quantity out of min–max range
invalid_comments	Comments do not match the service rules
insufficient_funds	Not enough balance
order_not_found	Wrong order ID
order_not_cancellable	Order cannot be canceled
request_in_progress	Duplicate order is being processed (HTTP 409)
rate_limited	Too many requests (HTTP 429)
method_not_allowed	Only POST is accepted (HTTP 405)

Most errors return HTTP 200 with an "error" field. Always check for it.