Snapchat 号码查询 API:手机号、批量、邮箱还是用户名

发布于 2026年8月24日 · 更新于2026年10月16日

五个 Snapchat 查询接口共用一个项目、一把授权密钥,但不是同一件事。CRM 导入、注册表单、名单清洗看起来都像「查一下在不在」,真正分叉的是标识形态:单个手机号、一批号码、邮箱、用户名,还是公开主页上的 handle。对不上那一行,后面的重试、计费和副作用都会跟着错。

手里是调不要误用成
一个手机号check-phone命中时 username、userId、displayName 已经在同一响应里
一批手机号check-phones-batch最多 50 个逗号分隔;拿 check-phone 循环是在烧往返
只要邮箱或用户名在不在check-email-username轻量 exists;邮箱走找回探测
标识混杂,要机器可读 statususer-infonumber 或 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 查询。