多平台号码标记查询API：风控、外呼、客服来电识别接口方案
手机号码标记查询API接口：聚合多平台号码标记数据
一次调用，聚合腾讯手机管家、360手机卫士、百度、小米、电话邦等主流平台的号码标记与认证信息。
适用于风控反欺诈、客服来电识别、电销号码过滤、外呼系统号码清洗等场景。
为什么需要号码标记查询API
号码标记数据分散在多个平台。腾讯手机管家、360手机卫士、百度、小米、电话邦、泰迪熊、搜狗……各家数据库独立，收录规则和更新频率不同。同一个号码，在腾讯显示正常，在360可能已经被标成“营销推广”；在百度没有标记，在电话邦却有“商业营销”。
对于个人用户，偶尔查一次，逐个平台看还能接受。但对于外呼系统、客服系统、风控平台来说，需要批量查询、实时查询、自动化查询，手动逐个平台查根本不现实。
这就是号码标记查询API要解决的问题：一次调用，聚合多平台数据，返回结构化结果。
Tmini 提供的手机号标记查询接口，聚合查询腾讯手机管家、360手机卫士、百度、小米、电话邦等主流平台的号码标记与认证信息。返回号码是否被标记、各平台具体状态（认证/被标记/未标记）及详细的标记标签和对应标记量，同时展示企业官方认证名称。
接口基本信息
| 项目 | 内容 |
|---|---|
| 请求方法 | GET |
| 接口地址 | api.tmini.net/apis/checkmark |
| 计费方式 | 600 积分 / 次 |
| 鉴权方式 | Query 参数、Header(X-API-Key)、Bearer Token |
| QPM 限制 | 不限制 |
| 接口文档 | https://api.tmini.net/detail/1 |
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥，在Tmini后台获取 | 后台KEY |
| phone | string | 是 | 待查询的手机号 | 17264353835 |
返回数据说明
| 字段 | 说明 |
|---|---|
| code | 状态码，200表示成功 |
| phone | 查询的号码 |
| isMarked | 号码是否被任何平台标记 |
| region | 号码归属地及运营商 |
| results | 各平台标记详情数组 |
在 results 数组中，每个平台会返回：
| 字段 | 说明 |
|---|---|
| platform | 平台名称，如腾讯手机管家、360手机卫士、百度、小米、电话邦、泰迪熊、搜狗、联通、移动等 |
| status | 标记状态，分为“认证”“被标记”“未标记”三种 |
| tags | 标记标签数组，包含标签名称如“骚扰电话”“快递送餐”“商业营销”“快递外卖”，部分平台还会返回标记次数 count |
| name | 企业官方认证名称，仅当状态为“认证”时返回 |
返回示例
点击展开查看完整返回示例
{
"code": 200,
"phone": "17264353835",
"isMarked": true,
"region": "重庆 移动",
"results": [
{
"platform": "腾讯手机管家",
"status": "被标记",
"tags": [
{ "name": "快递送餐", "count": 6 }
]
},
{
"platform": "360手机卫士",
"status": "被标记",
"tags": [
{ "name": "快递送餐", "count": 13 }
]
},
{
"platform": "泰迪熊",
"status": "被标记",
"tags": [
{ "name": "快递外卖", "count": 20 }
]
},
{
"platform": "百事通",
"status": "未标记"
},
{
"platform": "移动",
"status": "未标记"
},
{
"platform": "电话邦",
"status": "未标记"
},
{
"platform": "小米",
"status": "认证",
"name": "京东快递"
},
{
"platform": "搜狗",
"status": "未标记"
},
{
"platform": "联通",
"status": "被标记",
"tags": [
{ "name": "快递送餐", "count": 6 }
]
},
{
"platform": "百度",
"status": "被标记",
"tags": [
{ "name": "商业营销" }
]
}
]
}
字段解读
isMarked：快速判断号码是否被任何平台标记，方便业务逻辑做初步筛选，不需要遍历整个 results 数组。
status 区分“认证”和“被标记”：被标记是负面信号，认证是正面信号。认证说明这个号码是企业官方号码，比如“京东快递”“顺丰速运”。在风控场景下，如果只看 isMarked 为 true 就拦截，可能误杀正规企业的外呼。区分认证和被标记，能有效降低误判率。
tags 里的 count 字段：反映标记量。标记量越大，说明被标记的共识越强，风险等级越高。可以根据 count 设置分级策略，比如 count 超过 20 的号码直接加入黑名单，count 在 5 到 20 之间的做人工审核。
多平台覆盖：接口聚合了腾讯手机管家、360手机卫士、百度、小米、电话邦、泰迪熊、搜狗以及联通、移动等运营商数据，一次调用就能拿到多平台结果，不需要逐个平台对接。
在风控场景下，不能只看 isMarked 为 true 就拦截。要区分“认证”和“被标记”，避免误杀正规企业的官方号码。
应用场景
外呼系统号码过滤
销售团队批量外呼前，先通过号码标记查询API查询待拨号码是否被标记为“骚扰电话”或“营销推广”。如果命中高风险标记，自动跳过或转由人工处理，避免浪费外呼资源。这就是外呼系统号码标记查询的典型用法。
客服系统来电识别
客户来电时，系统实时查询号码标记信息。如果显示“金融理财”“保险推销”等标签，自动路由到对应的业务队列。这是客服来电标记查询的核心价值。
风控反欺诈
把号码标签接入规则引擎，用于异常号码识别，辅助判断是否存在欺诈风险。风控号码标记查询可以帮助系统在注册、登录、交易等环节增加一层判断依据。
批量号码清洗
一次提交多个号码，快速获取所有号码在各平台的标记状态，用于号码库清洗和筛选。批量号码标记查询适合需要处理大量号码的企业用户。
接入方式
- 第一步访问接口文档页面，了解请求参数和返回结构
- 第二步注册 Tmini 账号，在控制台申请接口调用 KEY
- 第三步传入 key 和 phone 参数，发起 GET 请求
- 第四步解析返回的 JSON 数据，提取 isMarked、results 等字段用于业务逻辑
接口文档
接口返回标准 JSON，结构清晰，无论是 Python、Java、PHP 还是 Node.js，解析起来都不费劲。文档里还提供了在线测试功能，可以先输入一个号码看看返回结果，确认符合预期后再正式接入。