ⓘ
当前版本: 1.0.0
更新时间: 2026-04-10 | 基础URL: https://api.th333.cc
🛡️ 认证说明
所有API请求都需要在请求头中携带认证令牌。
| 参数名 | token |
| 类型 | String |
| 必填 | 是 |
| 说明 | 认证令牌，请向管理员申请 |
GET /api/user/balance HTTP/1.1 Host: api.data.com token: your_token_here
🌐 通用响应格式
成功响应
{
"code": 0,
"message": "success",
"data": { }
}失败响应
{
"code": 1,
"message": "错误描述信息"
}| code: 0 | 请求成功 |
| code: 1 | 请求失败 |
📄 API 接口列表
GET1️⃣ 查询账号余额
查询当前账号的可用余额(单位：积分)
接口地址: GET /api/user/balance
请求参数: 无需额外参数，通过token自动识别账号
响应示例:
{
"code": 0,
"message": "success",
"data": {
"balance": 100.0
}
}| balance | 当前账号余额(积分) |
POST2️⃣ 提交任务
创建并提交一个新的筛选任务
接口地址: POST /api/task/create
Content-Type: multipart/form-data
请求参数:
| file | 必填任务文件，仅支持txt格式 |
| country | 必填地区编码(如：US-美国，DE-德国) |
| taskType | 必填任务类型，详见任务类型列表 |
| taskName | 可选自定义任务名称 |
响应示例:
{
"code": 0,
"message": "任务创建成功",
"data": {
"taskId": "WS250905164942",
"country": "US",
"taskTotal": 485,
"taskState": "Waiting"
},
"consume": {
"deduction": 0.119,
"balance": 491.892
}
}响应参数:
| data.taskId | 任务ID，后续查询进度和下载结果时使用 |
| data.country | 任务所属地区编码 |
| data.taskTotal | 任务总数量 |
| data.taskState | 任务状态，初始通常为 Waiting |
| consume.deduction | 本次任务扣费积分 |
| consume.balance | 扣费后账户剩余积分 |
GET3️⃣ 获取任务进度
查询指定任务的执行进度和状态
接口地址: GET /api/task/progress
请求参数:
| taskId | 必填任务ID(创建任务时返回的taskId) |
请求示例:
GET /api/task/progress?taskId=WS250905164942
响应示例:
{
"code": 0,
"message": "success",
"data": {
"taskId": "PA260426095209979",
"taskName": "3869514995format",
"country": "US",
"taskTotal": 4973,
"taskProgress": 4973,
"validQuantity": 264,
"taskState": "Finish"
}
}响应参数:
| data.taskId | 任务ID |
| data.taskName | 任务名称 |
| data.country | 任务地区编码 |
| data.taskTotal | 任务总数量 |
| data.taskProgress | 当前已处理数量 |
| data.validQuantity | 当前有效数量 |
| data.taskState | 任务状态（如 Pending/Waiting/Ongoing/Finish/Fail/Close） |
GET4️⃣ 下载结果文件
下载已完成任务的结果文件
接口地址: GET /api/task/result
请求参数:
| taskId | 必填任务ID(创建任务时返回的taskId) |
响应说明: 返回文件流，响应头包含文件信息
任务类型列表
WhatsApp 筛选
wsValid - WS筛开通
wsActive - WS筛活跃
wsGender - WS性别年龄-全格式
Telegram 筛选
tgValid - TG筛开通
tgActive - TG筛活跃
tgGender - TG性别年龄-全格式
tgNameValid - TG筛用户名
社交媒体筛选
fbValid - Facebook筛开通
fbGender - Facebook筛性别
fbUid - Facebook筛UID
insValid - Instagram筛开通
linkedinValid - 领英筛开通
linkedinGender - 领英筛全格式
tiktokUser - Tiktok筛用户名
twitterValid - Twitter筛开通
snapchatValid - Snapchat筛开通
通讯工具筛选
lineValid - Line筛开通
lineGender - Line筛性别年龄
signalValid - Signal筛开通
viberValid - Viber筛开通
viberGender - Viber筛性别年龄
viberActive - Viber筛活跃
botimValid - Botim筛开通
botimGender - Botim筛性别年龄
zaloValid - Zalo筛开通
zaloGenderQuick - Zalo极速筛性别年龄
zaloActive - Zalo筛活跃
wxValid - WeChat筛开通
rcsSystem - RCS筛系统
其他服务
amazonValid - 亚马逊筛开通
teamsValid - Teams筛开通
sidelineValid - Sideline筛开通
dhlValid - DHL筛开通
交易所
binanceValid - 币安筛开通
okxValid - OKX筛开通
htxValid - HTX筛开通
kucoinValid - Kucoin筛开通
coinwValid - Coinw筛开通
mexcValid - MEXC筛开通
号码检测
iosBlueValid - IOS筛蓝号
iosValid - IOS筛系统
phoneCheck - 空号检测
operatorStandard - 运营商检测
numberStatus - 手机型号检测
phoneActive - 号码活跃检测
任务状态说明
| Pending | 排队中任务已提交，等待系统分配资源 |
| Waiting | 待执行任务已创建，即将开始执行 |
| Ongoing | 执行中任务正在执行中 |
| Finish | 已完成任务执行完成，可下载结果 |
| Fail | 执行失败任务执行失败（会立即自动退款） |
| Close | 已关闭任务已被关闭（请联系管理员） |
⚠️ 错误码说明
| token不能为空或无效 | 请检查token是否正确，或联系管理员重新获取 |
| 参数错误 | 检查必填参数是否都已提供，格式是否正确 |
| 余额不足 | 账号余额不足以执行任务，请充值后重试 |
| 任务不存在 | 指定的taskId不存在，检查taskId是否正确 |
| 无权访问该任务 | 尝试访问其他用户的任务，只能访问自己创建的任务 |
| 文件不存在或已被删除 | 结果文件不存在，可能任务未完成或文件已过期 |
📘 使用示例 (cURL)
1. 查询余额
curl -X GET "https://api.data.com/api/user/balance" \ -H "token: your_token_here"
2. 提交任务
curl -X POST "https://api.data.com/api/task/create" \ -H "token: your_token_here" \ -F "file=@/path/to/your/file.txt" \ -F "country=US" \ -F "taskType=wsValid" \ -F "taskName=测试任务"
3. 查询任务进度
curl -X GET "https://api.data.com/api/task/progress?taskId=WS250905164942" \ -H "token: your_token_here"
4. 下载结果文件
curl -X GET "https://api.data.com/api/task/result?taskId=WS250905164942" \ -H "token: your_token_here" \ -O -J
注意事项
安全性
- 请妥善保管您的token，不要泄露给他人
- 建议通过HTTPS协议访问API
- 定期更换token以提高安全性
文件要求
- 任务文件必须是txt格式
- 文件编码建议使用UTF-8
- 单个文件大小建议不超过100万行
- 文件中每行一个号码，包含国际区号，不包含"+"号
任务执行
- 任务提交后会立即扣除相应积分
- 任务完成后才能下载结果文件
- 结果文件保留时间为30天
频率限制
- 建议单个账号并发任务数不超过10个
- 查询接口建议间隔不少于1秒
- 批量操作建议使用任务进度接口轮询，避免频繁请求