Snapchat 号码查询 API:手机号、批量、邮箱还是用户名
五个 Snapchat 查询接口共用一个项目、一把授权密钥,但不是同一件事。CRM 导入、注册表单、名单清洗看起来都像「查一下在不在」,真正分叉的是标识形态:单个手机号、一批号码、邮箱、用户名,还是公开主页上的 handle。对不上那一行,后面的重试、计费和副作用都会跟着错。
| 手里是 | 调 | 不要误用成 |
|---|---|---|
| 一个手机号 | check-phone | 命中时 username、userId、displayName 已经在同一响应里 |
| 一批手机号 | check-phones-batch | 最多 50 个逗号分隔;拿 check-phone 循环是在烧往返 |
| 只要邮箱或用户名在不在 | check-email-username | 轻量 exists;邮箱走找回探测 |
标识混杂,要机器可读 status | user-info | number 或 target,两个都传时以手机号为准 |
| 已知 handle,要公开卡片 | public-profile | 显示名和 snapcode,不是「这个手机号注册了没」 |
登录后从控制台复制一把可用密钥。curl 示例用 YOUR_API_KEY,Python 读环境变量 OPENDATA_API_KEY。密钥走查询参数,不要出现在截图、工单和浏览器前端。打开本页或复制示例不会发出查询。
先选探针,再写循环
五条路径都在 https://api.opendata-api.com/api/project/snapchat/<operation>。HTTP 200 只说明传输成功。网关还有 code / message / data,有时会包两层;拆到业务载荷为止,code 不是 200 就按业务失败处理——密钥无效、余额不足、参数缺了,都可能是「传输成功、业务失败」。
手机号的 registered、邮箱或用户名的 exists 都是三态:true、false、null。null 是暂时不确定,去看 message,退避后再试,绝不能当成「没注册」。把不确定写成未注册,渠道分流会把本来能触达的人丢掉。user-info 和 public-profile 则给机器可读的 status(found、not_found、invalid,前者还有 error),按这个字段分支,不要解析 message 文本。
点数按实际打出的查询计。选错接口等于把同一条联系人买两遍:手机号命中后再打 user-info 是典型浪费。大多数产品其实只需要一个分流函数,而不是五个都打一遍。
import os
import time
import requests
API_KEY = os.environ["OPENDATA_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()
# Unwrap {"code", "data"} layers; HTTP 200 is not business success
while isinstance(body, dict) and "code" in body and isinstance(body.get("data"), (dict, list)):
body = body["data"]
return body
def probe(phone=None, email=None, username=None):
if phone:
return get("check-phone", number=phone)
if email:
return get("check-email-username", target=email)
if username:
return get("public-profile", username=username)
raise ValueError("need phone, email, or username")
一次只传一种标识。手机号命中后再打 user-info「补全」是多余的——check-phone 在 registered=true 时已经带回公开身份。
单号与 50 个一批
check-phone 接收国际格式 number(数字,可带前导 +),接口会自行归一化。解析不了的号码应在本地丢掉,不要拿国内 11 位、空格、括号去撞接口。命中时 username、userId、displayName 在同一份载荷里,足够把 Snapchat 身份挂回 CRM 主键。
curl "https://api.opendata-api.com/api/project/snapchat/check-phone?key=YOUR_API_KEY&number=8613800138000"
registered 为 null 就等一等再试,不要写成 false 入库。
def check_phone(number, retries=2):
data = None
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
名单是另一个接口,不是 for 循环。实时表单、单条工单用 check-phone;导入、夜间清洗、周期性回扫用 check-phones-batch。一次最多分类 50 个逗号分隔的号码,逐行返回三态 registered,某一行暂时失败不会拖垮整批;命中行同样带用户名、userId 和显示名。计费按返回的号码条数,灌仓库之前先看定价。超限自己切片,不要赌接口帮你吞掉第 51 个。
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 的行收进下一批,成功行不要重打。断点续跑靠这份 jsonl,而不是靠「再从头跑一遍」。
邮箱和用户名是另一扇门
手机号不要进 check-email-username。这个接口只收 target,并且按形态分叉:形如 teng_leo 的用户名走公开主页表面;带 @ 的邮箱地址走账号找回探测。返回的 exists 同样是三态。用户名可用性、注册表单去重、CRM 里「这个邮箱绑过 Snapchat 没有」,才是这扇门的活。
curl "https://api.opendata-api.com/api/project/snapchat/check-email-username?key=YOUR_API_KEY&target=teng_leo"
邮箱形式只适合单次、有意为之的检查——注册表单、工单、你已有合法依据处理的 CRM 记录。命中时可能给地址所有者发一封真实的找回邮件,对方会把它当成一次登录或改密动作,而不是你在后台做的静默校验。这不是洗名单的原语。没有「50 封邮箱一批」,也不要用循环自己造;批量清洗只对手机号成立。
标识混杂(有的行是手机号,有的是邮箱或用户名)、而且你要的是机器可读 status 而不是单纯的 exists 时,走 user-info。传 number 或 target;两个都给时以 number 为准,形如手机号的 target 会转到手机号路径——不要靠「两个都塞,让接口猜」。返回随表面而变:手机号命中给用户名、userId、显示名;用户名命中给显示名和 snapcode 图片链接;邮箱命中给掩码后的找回地址——找回邮件的副作用同样适用。按 status 分支。invalid 是输入形态不对,换接口也救不回来;error 才是该退避的暂时故障。
info = get("user-info", number="8613800138000")
if info.get("status") == "found":
print("identity", info.get("username"), info.get("displayName"))
elif info.get("status") in ("not_found", "invalid"):
print("no account or bad input")
else:
print("retry later", info.get("message"))
user-info 是混钥那扇门,不是 check-phone 之后的必经第二跳。
公开主页不等于注册检查
public-profile 把 username 解析成 username、displayName,以及账号存在时的 snapcode 图片链接。它不需要手机号,返回 registered 和 found / not_found / invalid 的 status。这个公开表面没有简介,也没有 Bitmoji。同一用户名,若只要「占没占」,check-email-username 更轻;若还要显示名和可扫描码,才值得打 public-profile。两扇门都不是手机号注册检查。
curl "https://api.opendata-api.com/api/project/snapchat/public-profile?key=YOUR_API_KEY&username=teng_leo"
它适合确认某个 handle 已被占用、补显示名、取可扫描的 snapcode。它不回答「8613800138000 在不在 Snapchat 上」。把手机号塞进 username 不会变成号码检测;把用户名塞进 check-phone 也不会变成资料卡片。
若要的是 Stories、Spotlight 或 Lens 而不是注册状态,到此停住,改走通过 API 获取 Snapchat 资料、Stories 与 Spotlight——那是另一个项目,不是这个项目上的第六个接口。
这五个接口不该摊成什么
不要给每个联系人打五连击「以求保险」。一种标识,一个探针。手机号名单走 check-phones-batch;handle 走 public-profile;邮箱走克制的 check-email-username 或 user-info,绝不能群发式探测。也不要把这五个接口焊成固定流水线:先查号、再查邮箱、再拉主页——那是把选择权交回给循环,而不是交给标识。
不要把 null 或 error 当成 false,也不要把 HTTP 200 当成 true。不确定的行留下来重试。message 不是契约。
不要指望发送接口、好友关系、Bitmoji、简介或实时位置。这些调用只给标识分类,命中时返回该表面本来就公开的身份字段。没有合法依据的联系人不要送进来。
不要把 Snapchat 注册状态当成唯一的 KYC 或反欺诈信号。它只是渠道标记:这个号码或 handle 能不能走 Snapchat,不是这个人是谁。
不要把 Signal、Viber、WhatsApp 和 Snapchat 塞进这一个项目。各渠道有各自的接口;要合并评分和分流,走线索核验工作流。超大 WhatsApp 名单的分块续跑见 WhatsApp 号码批量校验。分渠道查询:Signal、Viber、WhatsApp。
产品页:Snapchat 查询。