开发者 API 参考文档
通过标准 JSON API 将各项服务直接无缝接入您的应用程序。
https://trumlike.vip/api/v2
获取 SMM 服务列表
获取您当前账户等级下可订购的所有 SMM 服务详细列表,包含费率、起订量、最大量以及服务特性。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key authentication token. |
| action | string 必填 | Set parameter value to "services". |
| lang | string 可选 | Service name language. Allowed values: "vi", "en". Default is "vi". |
[
{
"service": 17374,
"name": "Shopee Follow | VietNam",
"type": "Default",
"category": "Follow Shop",
"platform": "Shopee",
"rate": 5.4638,
"min": 10,
"max": 10000,
"refill": false,
"cancel": true,
"description": "Real users, speed: 500-1k/day",
"stable": "stable",
"status": "active"
},
{
"service": 17493,
"name": "Lazada Follow",
"type": "Default",
"category": "Follow Lazada",
"platform": "Lazada",
"rate": 10.9275,
"min": 10,
"max": 10000,
"refill": true,
"cancel": true,
"description": "Follow Global accounts",
"stable": "beta",
"status": "inactive"
},
{
"service": 18021,
"name": "TikTok Livestream Viewers",
"type": "LiveStream",
"minutes": [15, 30, 60, 90, 120],
"category": "Livestream TikTok",
"platform": "TikTok",
"rate": 2.1500,
"min": 100,
"max": 50000,
"refill": false,
"cancel": false,
"description": "Livestream viewers, keep for the selected duration",
"stable": "stable",
"status": "active"
}
]
minutes array 可选 — 仅在预设时长的直播服务中出现。该字段列出了下单时 "minute" 参数所支持的分钟数值。低于最小预设值的输入将被拒绝;介于两个选项之间的数值将向下取整至最近的档位。
查询账户余额
查询当前账户钱包余额及平台配置的货币单位。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key authentication token. |
| action | string 必填 | Set parameter value to "balance". |
{
"balance": "343.22",
"currency": "VND"
}
提交 SMM 订单
创建新的 SMM 营销订单。必填参数将根据目标服务类型的不同而动态变化。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set parameter value to "add". |
| service | integer 必填 | The SMM Service ID obtained from the services list. |
| link | string 必填 | Target link URL (Profile, post, channel, group, video, etc). |
| quantity | integer 必填 | The quantity of views, followers, likes, etc. to buy. |
{
"order": 99999
}
查询订单状态
查询单个订单的状态、扣费金额、起始数量以及剩余进度。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "status". |
| order | integer 必填 | Target Order ID. |
{
"charge": "2.5",
"start_count": "168",
"status": "Completed",
"remains": "0"
}
批量查询订单状态
同时获取多个订单的状态详情(单次最多支持 100 个订单 ID)。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "status". |
| orders | string 必填 | Comma-separated list of Order IDs (e.g. "123,456,789"). |
{
"123": {
"charge": "0.27819",
"start_count": "3572",
"status": "Partial",
"remains": "157"
},
"456": {
"error": "Incorrect order ID"
},
"789": {
"charge": "1.44219",
"start_count": "234",
"status": "In progress",
"remains": "10"
}
}
申请订单补单
为已完成但数量出现下滑的订单触发补单服务(需服务线路配置支持补单)。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "refill". |
| order | integer 必填 | Target Order ID to refill. |
{
"refill": "1298"
}
批量申请订单补单
同时提交多个订单的补单申请。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "refill". |
| orders | string 必填 | Comma-separated list of Order IDs. |
[
{
"order": 123,
"refill": 1299
},
{
"order": 456,
"refill": 1300
},
{
"order": 789,
"refill": {
"error": "Incorrect order ID"
}
}
]
查询补单请求状态
查询之前创建的单个补单任务的进度状态。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "refill_status". |
| refill | integer 必填 | Target Refill ID (e.g. 1298). |
{
"status": "Completed"
}
批量查询补单请求状态
同时查询多个补单任务的当前状态。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "refill_status". |
| refills | string 必填 | Comma-separated list of Refill IDs. |
[
{
"refill": 1299,
"status": "Completed"
},
{
"refill": 1300,
"status": "Rejected"
}
]
申请取消订单
提交正在进行中订单的取消请求(需对应线路服务器支持撤单功能)。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "cancel". |
| orders | string 必填 | Comma-separated list of target Order IDs. |
[
{
"order": 123,
"cancel": {
"error": "Order cannot be cancelled"
}
},
{
"order": 456,
"cancel": 1
}
]
TikTok 直播日志查看器
获取订单的实时跟踪日志(例如直播服务的在线人数随时间变化记录)。仅限查询属于您 API Key 的订单。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "log_viewer". |
| order | integer 必填 | 要读取日志的订单 ID。 |
{
"ok": true,
"nick": "example_nick",
"logs": [
{
"ts": "2026-08-18 09:15:00",
"viewers": 1250,
"top": [
{
"username": "viewer_01",
"name": "Viewer 01",
"avatar": "https://.../avatar.jpg",
"count": 37
}
]
}
],
"latest_top": []
}
{
"error": "Incorrect order ID"
}
购买 / 租赁 Proxy
租赁专属 IPv4 静态 Proxy、静态 Proxy 套餐或动态旋转 Proxy。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "buy_proxy". |
| proxy | string 必填 | Specify type: "v4static", "v4package", or "v4rotate". |
| type | string 必填 |
ISP / Location:
"Viettel", "FPT", "VNPT", "PRIVATE", "DatacenterA", "DatacenterB", "DatacenterC", "US", "4Gvinaphone". |
| quantity | integer 必填 | Number of proxy lines to rent. |
| days | integer 必填 | Rent duration in days (minimum 1 day; minimum 7 days when type is "PRIVATE"). |
| protocol | string 必填 | Connection protocol format: "HTTP" or "SOCKS5". |
| user | string 可选 | Custom credentials username for proxy authentication. |
| password | string 可选 | Custom credentials password for proxy authentication. |
{
"key": "YOUR_API_KEY",
"action": "buy_proxy",
"proxy": "v4static",
"type": "PRIVATE",
"quantity": 1,
"days": 7,
"protocol": "HTTP",
"user": "",
"password": ""
}
{
"status": "success",
"data": [
{
"id": 279,
"proxy_type": "Proxy v4 static",
"protocol": "HTTPS",
"data": "206.125.175.230:13271:bUMBYc:YbhrHU",
"data2": "114.256.712.19:13271:bUMBYc:YbhrHU",
"status": "success",
"expired_at": "18-05-2025 22:14:17"
}
],
"payment": 1152,
"balance": 965567
}
获取 Proxy 详情
根据 Proxy ID 获取 Proxy 详情、认证凭据、运行状态及到期时间。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "get_proxy". |
| proxy_id | integer 必填 | Target unique Proxy ID. |
{
"status": "success",
"order": {
"proxy_id": 37775,
"proxy_type": "Proxy v4 static",
"protocol": "HTTPS",
"data": "172.111.171.99:14288:10md12:123456",
"data2": "114.122.09.99:11218:10md12:123456",
"status": "success",
"expired_at": "18-05-2025 22:14:17"
}
}
查询 / 更换动态 Proxy IP
查询活跃连接配置或通过 Proxy 密钥立即触发一次动态 IP 更换。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "get_rotate_proxy". |
| key_rotate | string 必填 | The rotation key associated with your proxy order. |
| operator | string 可选 | Target ISP: "Viettel", "FPT", "VNPT". |
| location | integer 可选 | Region location code (select from codes listed on the proxy page). Default is 0 (Random). |
| whitelist | string 可选 | IPv4 Address to whitelist for passwordless authorization. |
{
"status": "success",
"message": "Proxy này sẽ die sau 1021s",
"data": {
"key_rotate": "KFBlsUezBtRMKTmiHdlhHY",
"http": "42.114.164.224:20841:khljtiNj3Kd:fdkm3nbjg45d",
"socks5": "42.114.164.224:30841:khljtiNj3Kd:fdkm3nbjg45d",
"operator": "viettel",
"location": "HaiDuong1",
"expired_at": "18-05-2025 22:14:17"
}
}
列出所有活跃 Proxy
获取与您账户关联的所有活跃静态及动态 Proxy 租赁的详细列表。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "get_all_proxy". |
{
"status": "success",
"order": [
{
"id": 251,
"proxy_type": "Proxy v4 static",
"protocol": "HTTP",
"operator": "FPT",
"day": 89,
"data": "206.125.175.230:13271:bUMBYc:YbhrHU",
"data2": "114.256.712.19:13271:bUMBYc:YbhrHU",
"status": "success",
"expired_at": "18-05-2025 22:14:17",
"auto_renew": 0
}
]
}
续费 Proxy 租赁
为单个或多个静态 Proxy 续订租赁时长。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "renew_proxy". |
| proxy_id | string 必填 | Target Proxy ID or comma-separated list of IDs. |
| days | integer 必填 | Number of days to renew. |
{
"status": "success",
"data": [
{
"proxy_id": 37775,
"proxy_type": "Proxy v4 static",
"protocol": "SOCKS5",
"operator": "FPT",
"data": "172.111.171.99:14288:newuser:newpass",
"status": "success",
"expired_at": "18-05-2025 22:14:17"
}
],
"totalPrice": 5000
}
下载套餐 Proxy 列表
以纯文本列表格式下载静态套餐内的所有可用 Proxy 节点。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "download_package". |
| proxy_id | integer 必填 | The package ID of the purchased static proxy package. |
| mode | integer 必填 | Select format format: 1 = source direct list, 2 = forward/mapped proxy list. |
{
"status": "success",
"type": "HTTP",
"count": 3,
"list": [
"1.1.1.1:1010:user:pass",
"2.2.2.2:2020:user:pass",
"3.3.3.3:3030:user:pass"
]
}
更新 Proxy 认证凭据
修改活跃 Proxy 资源的用户名、密码或连接协议格式 (HTTP/SOCKS5)。
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "change_auth_proxy". |
| proxy_id | string 必填 | Target Proxy ID or comma-separated list of IDs. |
| protocol | string 可选 | New protocol: "HTTP" or "SOCKS5". Default is keeping current. |
| user | string 可选 | New Username. Set as "random" for automatic generation. |
| password | string 可选 | New Password. Set as "random" for automatic generation. |
{
"status": "success",
"data": [
{
"proxy_id": 251,
"proxy_type": "Proxy v4 static",
"protocol": "SOCKS5",
"operator": "FPT",
"data": "172.111.171.99:14288:newuser:newpass",
"status": "success",
"expired_at": "18-05-2025 22:14:17"
}
]
}
重新分配 Proxy IP 地址
Re-allocate a brand-new IP address line for an active static proxy slot.
Cost: 1,500đ per allocation change.
| 参数 | 类型与规则 | 说明 |
|---|---|---|
| key | string 必填 | Your unique API Key. |
| action | string 必填 | Set to "change_proxy". |
| proxy_id | string 必填 | Target Proxy ID or comma-separated list of IDs. |
| loaiproxy | string 必填 | Target network ISP region: "Viettel", "FPT", "VNPT", "DatacenterB". |
| protocol | string 可选 | Desired connection protocol: "HTTP" or "SOCKS5". |
| user | string 可选 | Custom Username. Default is keeping current. |
| password | string 可选 | Custom Password. Default is keeping current. |
{
"status": "success",
"data": [
{
"proxy_id": 251,
"proxy_type": "Proxy v4 static",
"protocol": "HTTP",
"operator": "VNPT",
"data": "42.115.123.45:12345:user123:pass456",
"status": "success",
"expired_at": "18-05-2025 22:14:17"
}
]
}