推特抽奖与活动验证接口

核验每位参与者是否真的关注、转发、引用、评论或加入了社区。每个动作一次布尔调用。无需 OAuth,无需开发者账号,也没有只看最近 100 条转发的限制。

100 次免费请求 · 无需绑卡 · 永不过期

cURL
curl -X POST "https://api.sorsa.io/v3/check-retweet" \
  -H "ApiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_link": "https://x.com/YourBrand/status/123", "username": "participant"}'
JSON
{ "retweet": true, "user_protected": false }

怎么用

三步,从参与到发奖

1

收集参与名单

按你现有的方式收集账号:报名表单、机器人,或者从活动里导出的表格。

2

每个动作跑一次核验

对每项要求的任务,把参与者的账号发给对应接口,读回一个布尔值。

3

给通过核验的人发奖

只保留通过全部核验的参与者,再从一份你真能拿得出手的名单里选出中奖者。


问题所在

靠自觉的参与登记会毁掉抽奖

假账号和机器人

到第三百份参与时,你的表单里已经塞满假账号、只做了一半的任务,还有专门薅奖池的机器人。人工审核太慢,靠自觉打勾则毫无意义。

消费级抽奖工具不够用

多数免费抽奖工具只看最近 100 条转发,抽一个中奖者就结束了。几乎没有一个能逐条核验关注、引用、评论或多任务活动。

官方接口里没有这项核验

官方推特接口没有直接的"这个用户做过这件事吗"接口,于是你只能把整份转发者和粉丝名单拉下来自己过滤。

Sorsa API 用一次调用回答唯一要紧的问题,对每位参与者都是如此:这个人有没有做他说做过的事?

抽奖工具是从它能看到的名单里抽一个中奖者。验证接口不一样:它在开奖之前逐个核验每位参与者,对照每一项要求的动作,所以你公布的中奖者是真能拿得出手的。


能核验什么

活动里的每个动作,各返回一个布尔值

传入参与者的账号和动作,拿回是或否。无需 OAuth,返回纯 JSON。

动作接口返回
关注了你的账号/check-followfollow: true 或 false
转发了某条帖子/check-retweetretweet: true 或 false(分页,无 100 条转发上限)
引用了某条帖子/check-quotedquoted、retweet 或 not_found,附带引用文本
评论了某条帖子/check-commentcommented: true 或 false,附带评论内容
加入了你的 X 社区/check-community-memberis_member: true 或 false
账号确实归本人所有/user-tweets发一条一次性验证码来确认账号归属
点赞了某条帖子无法核验X 在 2024 年把点赞设为私密,任何接口都无法确认一次点赞

要搭带批量处理、质量规则和打分的完整流程? 实现指南 用可运行的 Python 代码走完整个流程,也可以看 验证接口文档

想先手动试一次核验?免费的 互关检测 就在浏览器里跑同一个 /check-follow 调用。


为核验而建

团队为什么在 Sorsa API 上做核验

01

每个动作一个布尔值

官方推特接口没有直接的核验接口,你只能把整份转发者或粉丝名单拉下来再搜。Sorsa API 一次调用就给答案。

02

没有 100 条转发的天花板

粗糙的做法和很多消费级抽奖工具只看得到最近 100 条转发。Sorsa API 会分页,早期参与者绝不会漏。

03

无需 OAuth,也不用预充值

一个 ApiKey 请求头就够。官方推特接口要 OAuth 2.0、要先买额度,每取一份资料收 $0.01,所以为确认一位参与者去扫一份粉丝名单,可能比整个 Sorsa 套餐还贵。

04

为规模而建

按请求固定计费加每秒 20 次请求,一夜之间就能核验几万条参与记录。

05

接口层面的反欺诈

/info-batch 每次请求返回 100 份完整资料,含 created_at、tweets_count 和 followers_count,质量规则在花掉任何一次核验之前就能跑完。

06

挡住账号冒用

发奖之前先确认参与者确实拥有他填的那个账号。


对比

做核验:Sorsa API 与官方推特接口

官方推特接口Sorsa API
直接核验"用户做过 X 吗"没有,只能拉完整名单再过滤每个动作一次布尔调用
转发深度卡在最近 100 条分页,没有上限
认证方式OAuth 2.0 加一个通过审批的开发者账号单个 ApiKey 请求头
规模化后的真实成本按量付费:每取一位粉丝或一份资料 $0.01,而且名单必须整份拉取$49/月起,按请求固定计费
在一个 5 万粉丝的账号上确认一次关注最高约 $500(按 $0.01 每份资料拉完整名单)$0.002(Pro 上一次 /check-follow 调用)
核验点赞2024 年起私密2024 年起私密(任何工具都做不到)
免费起步没有100 次免费请求

谁在用

适配各种形态的活动

抽奖与活动平台: 核验每一份参与都完成了全部要求的任务。

创作者营销代理商: 跑品牌活动,不用花好几天人工审核参与记录。

Web3 任务与空投: 把奖励门槛挂在已核验的平台内动作上。

大使与推荐计划: 确认持续的互动,而不是一次性的转发。

Discord 与权限门控: 只给已核验的粉丝授予身份组。


按活动规模计价

价格固定,随活动规模伸缩

一场典型的 5 任务活动,加上归属核验和资料质量过滤,每位参与者约 7 次请求,在 Pro 上大约 $0.014。所有接口都是 1 次请求等于 1 次调用,没有点数换算,也没有按资源的附加费。

Starter
1 万
次请求 / 月
$49/月
按月计费
比官方接口省 $950

  • 最多可核验约 1,400 位参与者
  • 20 次/秒速率限制
  • 覆盖全部 40 个接口
  • 可创建多个 API 密钥
选择 Starter
Enterprise
50 万
次请求 / 月
$899/月
按月计费
比官方接口省 $49,000

  • 最多可核验约 7.1 万位参与者
  • 20 次/秒速率限制
  • 覆盖全部 40 个接口
  • 优先支持
选择 Enterprise

不确定选哪个?每个账号都从 100 次免费请求开始:最多 1 万条推文或 2 万份用户资料。无需绑卡,永不过期,覆盖全部 40 个接口。

活动规模很大?

50 万次请求以上的用量、定制基础设施,以及与我们团队的直接联系,专为在生产环境核验参与记录的高吞吐平台准备。

  • 用量每月 50 万次请求以上
  • 基础设施更高的速率限制,专属
  • 价格批量折扣与定制条款
  • 支持专属客户经理

常见问题

常见问题

能用接口核验推特上的转发和关注吗?

能。Sorsa API 对每项都返回一个布尔值:这个用户有没有转发这条帖子,这个用户有没有关注这个账号。每个动作一次调用,无需 OAuth,返回纯 JSON。

能核验点赞吗?

不能。X 在 2024 年 6 月把点赞设为私密,因此任何接口都无法确认一次点赞。改用转发、引用或评论,这三项都完全可核验。

需要推特开发者账号或 OAuth 吗?

不需要。认证方式就是一个 ApiKey 请求头,没有应用审核,也没有审批流程。

超过最近 100 条转发还能用吗?

能。转发核验会分页,所以早期参与者不会被漏掉,这一点和只能看最近 100 条转发的工具不同。

每位参与者的核验成本是多少?

按请求固定计费。在 Pro 套餐上,一次涵盖多项任务的完整核验,每位参与者大约 $0.014。逐个套餐的细节见价格页。

如果参与者的账号是私密的怎么办?

每次核验都会返回 user_protected 标记。私密账号任何第三方都无法核验,所以多数活动会直接拒绝,或者退回到用一次性验证码确认账号归属。实际操作中,抽奖参与者里私密账号不到 1%。

怎么挡住假账号和机器人?

核验之前先按账号年限、推文数和粉丝数过滤,再让参与者发一条一次性验证码,确认账号确实归他所有。

一次调用核验你的下一场活动

拿个密钥,传入参与者的账号和一个动作,得到已核验的是或否。前 100 次请求免费:无需绑卡,永不过期。