API 参考 · v1
一条连接，接收 X 账号的全部动态
xSignalFeed 监视你指定的 X（原 Twitter）账号，并在它们有动作时实时发给你：新帖子、回复、转推、引用、删除、资料修改、关注动作和新增的认证粉丝。你也可以监视 X 搜索中的某个短语，并按需读取资料、帖子、粉丝、列表、社区和趋势。事件通过一条 WebSocket 传输；当你需要主动查询而非等待时，还有 REST 可用。
简介
使用本服务有三种方式。监控：指定账号和关键词，在事情发生时通过 WebSocket 或 Webhook 接收事件。历史记录：读回你的密钥收到过的事件。读取：此刻向 X 询问某个资料、帖子、搜索、列表、社区或趋势。
事件分为四大类。每一类只有一种载荷结构，在事件一节逐字段说明。
| 类别 | 类型 | 含义 |
|---|---|---|
| 帖子 | tweet.create, tweet.reply, tweet.retweet, tweet.quote, tweet.edit, tweet.delete | 账号发布的内容：新帖子、回复、转推、引用、编辑，以及对上述任一内容的删除 |
| 资料 | profile.name, profile.screen_name, profile.bio, profile.location, profile.url, profile.avatar, profile.banner, profile.pinned, profile.verified | 账号对外展示信息的任何变化，附旧值和新值 |
| 关注关系 | follow.add, follow.remove, followers.verified.add | 账号开始或停止关注了谁，以及哪些认证账号开始关注它 |
| 账号 | account.status | 账号是否还能被看到：受保护、被封禁、不可见，或恢复正常 |
| 搜索 | search.match | X 上任何人发布的、匹配你所监视关键词的帖子 |
访问凭据是 API 密钥。密钥携带的权限范围和上限来自其套餐；GET /v1/account 会告诉你你的密钥能做什么。这里没有任何东西按事件量计费：流式传输已包含在内，只有按需读取才消耗额度。
xSignalFeed 是独立的第三方服务，与 X Corp 没有从属、背书或赞助关系。我们只读取公开数据。