如何用 API 获取 WhatsApp 头像、简介与在线状态

发布于 2026年8月23日

一个已注册的 WhatsApp 号码往往带有公开足迹：头像、「关于」签名，以及在线状态/最后在线等在线信号。对于线索补全、身份验证与数据研究，这些公开资料很有价值——而你可以通过编程方式获取它们。

本指南介绍如何用资料查询接口拉取 WhatsApp 号码的头像、简介与在线状态。

两段式流程

资料查询以注册校验为前提。这样更省成本：你先确认号码存在，再只为真实账户支付补全点数。

  1. 用 check-exist-by-phone 做注册校验——对已注册号码会返回 userHash 标识符。
  2. 把该 userHash 传入资料查询接口以获取资料数据。

第一步 —— 获取 userHash

curl "https://api.opendata-api.com/api/project/whatsapp/check-exist-by-phone?key=你的API_KEY&phoneNumber=15551234567"

从响应中复制 userHash。

第二步 —— 获取资料字段

头像：

curl "https://api.opendata-api.com/api/project/whatsapp/get-avatar?key=你的API_KEY&userHash=USER_HASH"

简介 / 签名：

curl "https://api.opendata-api.com/api/project/whatsapp/get-about?key=你的API_KEY&userHash=USER_HASH"

在线状态 / 最后在线：

curl "https://api.opendata-api.com/api/project/whatsapp/get-presence?key=你的API_KEY&userHash=USER_HASH"

受隐私设置影响。 某个字段能否返回数据，取决于账户自己的 WhatsApp 隐私设置——隐藏了头像或最后在线的用户，对应字段只会返回空数据。

应用场景

  • 线索补全 —— 在销售外联前，为线索补上一张脸和更多上下文。
  • 身份信号 —— 真实头像与简介有助于区分真实账户与一次性账户。
  • 活跃度打分 —— 在线状态/最后在线能反映联系人的活跃（与可触达）程度。
  • 企业发现 —— 结合企业资料查询接口获取公司信息。

最佳实践

  • 务必先校验 —— 对未通过注册校验的号码，不要调用资料接口。
  • 缓存 userHash，避免重复补全时重复支付校验成本。
  • 优雅处理空字段 —— 因隐私设置而隐藏是正常情况，并非错误。
  • 保持合规 —— 只补全你有合法依据处理的号码，并遵守 WhatsApp 条款。

立即体验

在 WhatsApp 号码校验页面在线获取资料，或阅读 get-avatar、get-about 与 get-presence 接口文档。查看定价了解每次请求成本。