Snapchat 号码查询 API：检测手机号、邮箱与用户名

Snapchat 仍是年轻用户中最大的即时通讯平台之一，因此是触达、验证与补全的有用渠道。如果你的产品会用到手机号、邮箱或用户名，那么确认某个联系人是否在 Snapchat 上，并解析其背后的公开身份，会影响你选择哪个渠道、如何给线索打分。Snapchat 号码查询 API 通过普通 HTTP 请求就能回答这些问题。

本文涵盖五个接口：检测手机号、批量检测名单、探测邮箱或用户名、解析完整身份，以及读取用户名的公开资料。文中附有可运行的 Python 代码，以及处理生产名单所需的错误处理。

你需要哪个接口？

目标	接口	输入
检测一个手机号，命中时附带身份信息	check-phone	number
检测一批手机号	check-phones-batch	numbers，最多 50 个，逗号分隔
这个邮箱或用户名是否已注册？	check-email-username	target
手机号、邮箱或用户名的注册状态加身份信息	user-info	number 或 target
已知用户名的公开资料	public-profile	username

第一步：获取 API 密钥

注册后，在控制台复制一个可用的密钥。账户包含免费点数，可用于测试。

第二步：检测手机号

check-phone 接收国际格式的 number（数字，可带前导 +，接口会自行归一化），返回该号码是否已注册 Snapchat。命中时还会返回账户的 username、userId 和 displayName，因此不需要再发第二个请求就能知道号码属于谁。

curl "https://api.opendata-api.com/api/project/snapchat/check-phone?key=YOUR_API_KEY&number=8613800138000"

registered 是三态值：true 表示已注册，false 表示未注册，null 表示结果不确定，这是一种暂时状态。遇到 null 时，请查看 message，并在短暂退避后重试。

import time
import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://api.opendata-api.com/api/project/snapchat"


def get(operation, **params):
    params["key"] = API_KEY
    resp = requests.get(f"{BASE}/{operation}", params=params, timeout=30)
    resp.raise_for_status()
    body = resp.json()
    # A reply can be wrapped more than once as {"code": ..., "data": {...}}
    while isinstance(body, dict) and "code" in body and isinstance(body.get("data"), (dict, list)):
        body = body["data"]
    return body


def check_phone(number, retries=2):
    for attempt in range(retries + 1):
        data = get("check-phone", number=number)
        if data.get("registered") is not None:
            return data
        time.sleep(2 * (attempt + 1))   # undetermined: back off, then retry
    return data


hit = check_phone("8613800138000")
print(hit.get("registered"), hit.get("username"), hit.get("displayName"))

第三步：批量检测名单

筛选名单时，check-phones-batch 一次请求最多可对 50 个逗号分隔的号码分类，并返回逐个号码的结果。每一行都带有各自的三态 registered 标志，所以某一个号码的临时失败不会让整个批次失败，命中的行会包含 username、userId 和 displayName。

curl "https://api.opendata-api.com/api/project/snapchat/check-phones-batch?key=YOUR_API_KEY&numbers=8613800138000,8613900139000"

一次请求顶替最多 50 次请求，减少了往返次数，筛选速度也快得多。批量结果按返回的号码条数计数，所以处理超大名单之前请先查看定价。下面的脚本把名单切成每组 50 个，并把每组的原始响应追加写入文件：

import json


def chunks(items, size=50):
    for i in range(0, len(items), size):
        yield items[i:i + size]


numbers = ["8613800138000", "8613900139000"]   # your normalized list
with open("snapchat_batches.jsonl", "a") as out:
    for batch in chunks(numbers):
        data = get("check-phones-batch", numbers=",".join(batch))
        out.write(json.dumps({"requested": batch, "result": data}) + "\n")

保存原始响应，意味着无论你之后怎样解析各行，脚本都依然有效。之后把 registered 为 null 的行收集起来，放进后面的批次再发一遍即可。

第四步：探测邮箱或用户名

check-email-username 是最轻量的存在性探测。传入一个 target：形如用户名的值，例如 teng_leo，会在公开资料页面上解析；邮箱地址则通过账号找回探测来检查。返回的 exists 同样是三态值。

curl "https://api.opendata-api.com/api/project/snapchat/check-email-username?key=YOUR_API_KEY&target=teng_leo"

它很适合注册表单、用户名可用性检查和 CRM 去重。请谨慎使用邮箱形式。 邮箱命中时可能会给地址所有者发送一封真实的找回邮件，所以只适合单次的、有意为之的检测，绝不能对名单群发式探测。

第五步：解析完整身份

user-info 接受 number（手机号）或 target（邮箱或用户名）。两者同时提供时，以 number 为准，形如手机号的 target 会被转到手机号路径。返回内容取决于命中的渠道：

• 手机号命中：返回 username、userId 和 displayName
• 用户名命中：返回 displayName 和 snapcode 图片链接
• 邮箱命中：返回经过掩码处理的找回邮箱地址

响应始终带有机器可读的 status（found、not_found、invalid 或 error）和易读的 message。请依据 status 分支，而不是去解析 message：

info = get("user-info", number="8613800138000")
if info.get("status") == "found":
    print("identity:", info)
elif info.get("status") in ("not_found", "invalid"):
    print("no account, or a malformed input:", info.get("message"))
else:
    print("retry later:", info.get("message"))

第六步：读取用户名公开资料

public-profile 把一个 username 解析为 username、displayName，以及账户存在时的 snapcode 图片链接。它不需要手机号，会返回明确的 registered 标志，以及 found、not_found 或 invalid 之一的 status。你可以用它确认某个用户名已被占用、为已知用户名补全显示名称，或获取可扫描的 snapcode。这个公开页面不提供简介和 Bitmoji 头像。

curl "https://api.opendata-api.com/api/project/snapchat/public-profile?key=YOUR_API_KEY&username=teng_leo"

如果你需要的是 Stories、Spotlight 和 Lens 数据而非注册检测，请阅读 通过 API 获取 Snapchat 资料、Stories 与 Spotlight。

应用场景

• 渠道分流：只在 Snapchat 可用的地方把它作为联系渠道。
• 线索校验：把号码或邮箱加入营销活动之前，先确认它们在 Snapchat 上。
• 联系人补全：把 Snapchat 用户名和 userId 附加到已有的手机号记录上。
• 反欺诈与 KYC：把注册状态作为一个轻量的信任信号，但绝不能作为唯一信号。
• 名单清洗：批量校验已存储的联系人，剔除不在 Snapchat 上的号码。

最佳实践

• 归一化号码：检测前统一成带国家码的纯数字，无法解析的直接拒绝。
• 名单走批量：用 check-phones-batch，不要循环调用 check-phone。
• 先校验再补全：先跑 check-phone，只对已注册的联系人调用 user-info。
• 把 null 当作稍后重试，绝不当作明确的否定，尝试之间要退避。
• 注意邮箱的特殊情况：邮箱探测只做有意为之的单次检测。
• 保持合规：只处理你有合法依据使用的联系人，并尊重隐私预期和平台条款。

它在整体流程中的位置

Snapchat 命中只是众多信号之一。想与其他渠道对比，请看 Signal、Viber 和 WhatsApp 的指南；想把它们合并成统一的评分和分流决策，请遵循线索核验工作流。对于超大的 WhatsApp 名单，同样的分块加断点续跑模式也适用，见 WhatsApp 号码批量校验。

常见问题

registered=null 是什么意思？ 表示结果不确定，这是一种暂时状态。请查看 message，等待片刻后重试。不要把它当作「未注册」。

一次请求最多能检测多少个号码？ 每次 check-phones-batch 调用最多 50 个逗号分隔的号码。每一行都有自己的 registered 标志，所以某一行失败不会让整个批次失败。

邮箱检测会通知账户所有者吗？ 可能会。邮箱探测基于账号找回，命中时可能向地址所有者发送一封真实的找回邮件。请只用于有意为之的单次检测，不要用于批量名单。

公开资料包含哪些内容？ 用户名存在时，返回用户名、显示名称和 snapcode 图片链接。该页面不提供简介和 Bitmoji 头像。

检测手机号该用哪个接口？ 单个号码用 check-phone，名单用 check-phones-batch。只有在联系人已经通过检测、并且你想要完整身份信息时，才调用 user-info。

立即体验

在 Snapchat 查询页面测试查询，或阅读 check-phone、check-phones-batch、check-email-username、user-info 与 public-profile 接口文档。查看定价了解每次请求的成本。