API 文档

HTTP 方法	POST
API 地址	`https://china-smm.com/api/v2`
API 密钥	请在账户页面生成
响应格式	JSON
货币	CNY
频率限制	每个密钥每分钟 120 次请求（超出返回 HTTP 429）

API 与网站使用完全相同的价格、余额校验和订单处理流程。响应和错误信息为英文。

服务列表

参数	说明
key	您的 API 密钥
action	services

响应示例

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "Instagram",
        "rate": "6.50",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true,
        "dripfeed": false
    }
]

下单

参数	说明
key	您的 API 密钥
action	add
service	服务 ID
link	页面链接
quantity	所需数量
runs (optional)	分批次数
interval (optional)	每次间隔分钟数
comments / usernames	每行一个，用于自定义列表类服务
idempotency_key (optional)	您为此订单设置的唯一标识（8–64 个字符）。使用相同标识重试时返回原订单，而不会创建新订单。

响应示例

{
    "order": 23501
}

订单状态

参数	说明
key	您的 API 密钥
action	status
order	订单号

响应示例

{
    "charge": "1.9520",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "CNY"
}

Multiple orders status

参数	说明
key	您的 API 密钥
action	status
orders	订单号，以逗号分隔（最多 100 个）

响应示例

{
    "1": {
        "charge": "1.9520",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "CNY"
    },
    "10": {
        "error": "Incorrect order ID"
    }
}

申请补单

参数	说明
key	您的 API 密钥
action	refill
order	订单号

响应示例

{
    "refill": "1"
}

批量补单

参数	说明
key	您的 API 密钥
action	refill
orders	订单号，以逗号分隔（最多 100 个）

响应示例

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": {
            "error": "Refill is not available for this order."
        }
    }
]

补单状态

参数	说明
key	您的 API 密钥
action	refill_status
refill	补单 ID

响应示例

{
    "status": "Completed"
}

批量查询补单状态

参数	说明
key	您的 API 密钥
action	refill_status
refills	补单 ID，以逗号分隔（最多 100 个）

响应示例

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

取消订单

参数	说明
key	您的 API 密钥
action	cancel
orders	订单号，以逗号分隔（最多 100 个）

响应示例

[
    {
        "order": 9,
        "cancel": 1
    },
    {
        "order": 2,
        "cancel": {
            "error": "This order can no longer be canceled."
        }
    }
]

用户余额

参数	说明
key	您的 API 密钥
action	balance

响应示例

{
    "balance": "700.8429",
    "currency": "CNY"
}

错误

错误以 HTTP 200（限流时为 429）返回，JSON 中包含错误信息和机器可读代码：

{"error": "Not enough funds on balance", "code": "insufficient_funds"}

代码	含义
`bad_method`	请求不是 POST
`invalid_key`	API 密钥缺失、格式错误或不存在
`account_inactive`	账户已被暂停或封禁
`rate_limited`	请求过多（HTTP 429）
`unknown_action`	不支持的 action 参数
`invalid_request`	校验失败（服务、链接、数量、字段等）
`insufficient_funds`	余额不足以支付该订单
`order_not_found`	该账户下不存在此订单号
`refill_not_found`	该账户下不存在此补单 ID
`not_supported`	该订单不支持补单/取消
`provider_unavailable`	上游临时故障，请稍后重试

状态值：Pending、Processing、In progress、Completed、Partial、Canceled。部分完成和已取消的订单会自动退款至余额。

示例（PHP）

<?php
$ch = curl_init('https://china-smm.com/api/v2');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key' => 'YOUR_API_KEY',
        'action' => 'add',
        'service' => 1,
        'link' => 'https://instagram.com/example',
        'quantity' => 1000,
        'idempotency_key' => 'my-order-0001',
    ]),
]);
$response = json_decode(curl_exec($ch), true);

示例（curl）

curl -X POST https://china-smm.com/api/v2 \
  -d key=YOUR_API_KEY -d action=balance