怎样通过写 TwitterAPI.io 教程获得 API 额度?
注:本文是标注过的示例演练,不是真实用户的故事。 文中的写作计划、分享码 AB12CD34 和帖子网址都是为了演示步骤编的;所有规则、金额和时限都以线上的 TwitterAPI.io 社区奖励 页面和控制台里的提交表单为准。
一句话回答: 写一篇关于你如何使用 TwitterAPI.io 的真实内容(短帖、教程、视频都可以),在正文里放上你的分享码或推荐链接,写明你会因此获得额度,然后把网址提交到控制台的社区奖励页面。审核通过后按平台给额度:短帖 $5,长文教程 $20,视频、Hacker News 或 20 星以上的 GitHub 仓库 $30;每个平台只奖励一次,每个账号每月最高可获 $200 额度。额度在 3 天或 7 天冻结期后解锁,解锁后 30 天内可用于任意接口。
下面用一个例子走完全程:一位开发者写了一个关键词提醒脚本,把它写成教程,发到三个平台,再在 X 上发一条短串推,然后在额度用完之前定期检查每篇帖子是否仍带着分享码。
第 1 步:拿到分享码和推荐链接
登录后打开 控制台 → Community Rewards(/dashboard/community-rewards)。"Your proof-of-authorship credentials" 一栏里有两个可以一键复制的值:分享码(8 个字符)和 推荐链接(twitterapi.io/?ref=<你的分享码>)。放其中一个就够了。它和联盟推广用的是同一个码,不需要另外申请。
这个码用来证明帖子是你写的。自动审核会抓取公开页面,在正文里找分享码或推荐链接。某个平台账号第一次审核通过后,会和你的 TwitterAPI.io 账号绑定;以后如果别人用这个平台账号的帖子来提交,会转人工审核。
放在哪里: 放在帖子正文里。只出现在评论、回复或置顶跟帖里的分享码不算。在 X 上,请放在你提交的那条推文里。
第 2 步:选平台(档位由网址决定)
档位不用自己选,提交表单会根据网址识别平台并定档。所以计划的重点是:你的内容放在哪里对读者最有用。
两条限制决定了怎么安排: 每个平台每个账号只奖励一次,以后再发 X 帖子不会再有奖励;每个账号每个自然月最多获得 $200 额度,所有平台合计。
评价类网站不接受。 Trustpilot、G2 这类网站禁止任何形式的有偿评价,所以不在范围内。没列出的平台也可以提交,不符合条件的话审核时会告诉你。
第 3 步:写内容,并加上声明
用自己的话写你真正做过、测过的东西。正文大部分是链接、自己的文字很少的帖子,很可能会转人工查看;抄别人的帖子再换上自己的分享码,会被取消奖励,还可能失去参与资格。
必须声明。 提交表单要求你确认:帖子里写明了你会因此获得额度,形式符合平台要求(面向美国读者的内容按 FTC 的要求披露,Reddit 按其自我推广规则,有平台自带的赞助标签就用标签)。一句话就够,但要让读者看得到:FTC 的指南提醒,只放在文末、个人主页或需要点"更多"才能看到的声明很容易被忽略,所以建议放在开头、第一次提到我们的地方。例如:
声明示例: "声明:我通过 TwitterAPI.io 社区奖励计划为本文获得 API 额度。我的推荐链接:twitterapi.io/?ref=AB12CD34"
关于链接: 本计划从不为 dofollow 链接付费,也不会提这样的要求。平台默认怎么处理链接(nofollow、UGC、sponsored)都可以。
写什么 由你决定。对读者帮助比较大的通常是:一个能跑的脚本加上运行结果、一次你自己测的成本对比、从别的客户端迁移过来的过程,或者一份老实的"踩坑清单"。如果需要参考,推特 API 接口分类说明 和 X(Twitter)API 价格说明 的细节程度可以借鉴。
第 4 步:在控制台提交网址
还是在控制台的这个页面,把一个公开帖子的网址填进 Post URL,在 "What's in the post?" 里写一段简介(至少 30 个字符),勾选声明确认框,点 Submit for review。每次提交一个网址。
Medium 和 LinkedIn: 这两个平台的页面无法自动抓取,请把帖子全文粘贴到简介框里,检查会针对这段文字进行。
可能遇到的报错: "platform already used" 表示你在这个平台已经拿过奖励;"duplicate URL" 表示这个网址或它的变体已经提交过;非公开网址(内网地址、IP、私密页面)会被拒绝。
提交之后: 自动审核每隔几个小时运行一次,检查正文里的分享码和各档门槛(视频时长、GitHub 星数、Hacker News 评论数)。个人博客、Medium、LinkedIn、Hashnode、Qiita、Zenn、Substack 会走简短的人工审核。有结果时会发邮件通知,最晚 3 个工作日。
第 5 步:冻结期、解锁和 30 天使用期
审核通过不会马上到账,先进入冻结期:A 档 3 天,B 档和 C 档 7 天,期间确认帖子仍然公开。冻结期结束时自动做最后一次检查,帖子还在、分享码或链接也还在,额度就解锁到你的余额里。
解锁后 30 天内 可以用于任意接口。这 30 天里会在 第 7 天和第 21 天 再复查一次:帖子被删、设为私密,或分享码不见了,还没用掉的那部分额度会被收回,已经用掉的不受影响。如果帖子在冻结期内就没了,奖励直接取消,不会发放任何额度。
社区奖励额度不能兑换现金。如果有人通过你的链接注册并付费,那是另一笔联盟推广佣金,按 联盟推广计划 的条款计算(12 个月有效期、每位付费用户有上限、不能自己推荐自己)。
示例:一篇教程,四份奖励(示意)
我们虚构的这位开发者写了一篇教程《40 行 Python 实现 X 关键词提醒》,发在自己的博客上,同步到 Dev.to 和 Hashnode,再在 X 上发了一条三连推,附上教程链接。每个网址分别提交。
$65 低于每月 $200 的上限, 四份奖励都能全额拿到。下个月这四个平台对这个账号不会再有奖励;同一个项目录一段 YouTube 演示是新平台(C 档 $30),代码仓库在 GitHub 上超过 20 星后也算新平台。
$65 额度能做什么: TwitterAPI.io 读取推文按返回条数计费,每 1,000 条 $0.15,所以 $65 大约能读 43.3 万条推文。X 官方 API 按量计费价目表(docs.x.com/x-api/getting-started/pricing,2026 年数据)上,读取他人推文的 Posts: Read 是每条 $0.005,同样 $65 只能读 1.3 万条。
分享码丢了会怎样: 假设 Dev.to 那篇在解锁后第 10 天被编辑,推荐链接那一行被删掉了。第 21 天复查找不到分享码,这 $20 里还没用掉的部分就会被收回。这就是下一步的用处。
第 6 步:自己先检查一遍
下面的脚本按审核的方式检查你提交过的每篇帖子:是否还公开,正文里是否还有分享码或推荐链接。X 的帖子通过 GET /twitter/tweets 读取(检查 text 和展开后的 entities.urls,因为 X 会把链接缩成 t.co);其他平台直接按普通网页抓取。建议提交前跑一次,解锁后第 7 天和第 21 天前后各跑一次。
成本: 每检查一条 X 帖子算返回一条推文,15 credits($0.00015)。四篇帖子查三轮不到一美分;普通网页不收费。
"""社区奖励自查:帖子是否仍然公开,正文里是否仍有分享码或推荐链接。"""
import re
import requests
API_KEY = "YOUR_API_KEY" # 在 twitterapi.io/dashboard 获取
SHARE_CODE = "AB12CD34" # 你的 8 位分享码(示例值)
POSTS = [
"https://x.com/your_handle/status/1234567890123456789",
"https://dev.to/your_handle/a-keyword-alert-for-x-in-40-lines-of-python",
"https://your-blog.example/keyword-alert-for-x",
]
def x_post_body(url):
tweet_id = re.search(r"/status/(\d+)", url).group(1)
r = requests.get("https://api.twitterapi.io/twitter/tweets",
params={"tweet_ids": tweet_id},
headers={"X-API-Key": API_KEY}, timeout=30)
r.raise_for_status()
tweets = r.json().get("tweets") or []
if not tweets:
return None # 已删除、受保护或不再可见
t = tweets[0]
# X 会把链接改写成 t.co,真实网址在 entities.urls 里
links = [u.get("expanded_url", "") for u in (t.get("entities") or {}).get("urls") or []]
return t.get("text", "") + " " + " ".join(links)
def web_page_body(url):
r = requests.get(url, timeout=30, headers={"User-Agent": "rewards-self-check/1.0"})
return r.text if r.ok else None
for url in POSTS:
body = x_post_body(url) if "/status/" in url else web_page_body(url)
if body is None:
print(f"GONE {url}")
elif SHARE_CODE in body:
print(f"OK {url}")
else:
print(f"NO CODE {url}")
提交前的检查清单
公开: 用无痕窗口、不登录也能打开这篇帖子。
正文带码: 分享码或推荐链接在帖子正文里,不在评论里(上面的脚本输出 OK)。
有声明: 有一句话写明你会因此获得 TwitterAPI.io 额度,而且放在读者看得到的位置。
自己的话: 写的是你做过、测过或遇到的事,不是改写别人的帖子或我们的文档。
达到档位门槛: B 档中文 1,200 字符以上(英文 600 词以上);YouTube 3 分钟以上且实际演示 API;Hacker News 5 条以上评论;GitHub 20 星以上。
新平台: 你之前没有在这个平台拿过奖励。
保持在线: 打算在额度用完之前一直保留帖子和分享码。
# 用自查脚本同样的方式读取一条 X 帖子(每返回一条推文 15 credits)
curl -s "https://api.twitterapi.io/twitter/tweets?tweet_ids=1234567890123456789" \
-H "X-API-Key: $TWITTERAPI_IO_API_KEY"常见问题
必须是付费用户才能参加吗?
需要一个 TwitterAPI.io 账号来获取分享码和提交,因为奖励是以额度的形式发到这个账号里。注册账号是免费的。
可以写批评或负面的评价吗?
可以。本计划要的是真实的内容,列出哪里不好用的帖子同样欢迎。标准是其他开发者能不能从中学到东西。
计划开始前写的旧帖子能提交吗?
可以,只要帖子仍然公开,正文里有你的分享码或推荐链接,并且有声明(现在补上也可以)。
分享码放在回复里,为什么不算?
分享码必须在你提交的那条帖子正文里。回复、评论和后续跟帖不在检查范围内。
社区奖励额度和联盟推广佣金是一回事吗?
不是。社区奖励是为帖子发放的额度,每月上限 $200,解锁后 30 天内使用;联盟推广佣金来自通过你的链接注册的用户的付费,按联盟推广计划的条款计算。两者用的是同一个分享码。
继续阅读
- FTC:社交媒体博主披露指南(Disclosures 101)第 3 步关于声明放在显眼位置的建议来自这份指南
- TwitterAPI.io 文档:按 ID 获取推文第 6 步自查脚本使用的接口
- X API 官方价目表示例中 Posts: Read 每条 $0.005 的出处
- /zh-CN/community-rewards
- /affiliate-program
- /zh-CN/blog/twitter-api-jiekou
- /zh-CN/blog/x-twitter-api-jiage
- /pricing
已经在用 TwitterAPI.io？发布一篇真实的教程或开发记录，每月最高可获得 $200 积分。