TwexAPI REST API 规范参考
TwexAPI 通过 https://api.twexapi.io 对外提供标准的 RESTful API，全面支持 Twitter/X 平台的数据读取、内容写入、推文高级搜索、用户资料与社交图谱导出、私信收发、话题趋势榜单、长文章处理、社区动态及 AI Agent 集成等全套功能。
核心功能与能力：
- 推文高级搜索 (Search) — 关键词、Hashtag 话题标签、Cashtag 金融代码检索，支持复杂布尔逻辑与时间窗口过滤
- 推文与互动分析 (Tweets) — 获取完整推文串（Thread）、推文详情、评论回复列表、点赞/转推/引用用户导出、AI 情感倾向分析
- 用户与社交图谱 (Users) — 用户公开资料卡查询、批量多用户解析、基于游标（Cursor）的大规模粉丝与关注列表导出
- 发推与互动写操作 (Tweet Actions) — 自动化发推、跟帖回复、一键发布推文串、点赞、转推、收藏、关注、修改个人资料
- 私信会话管理 (Direct Messages) — 发送纯文本或媒体私信、权限检查、会话列表及历史聊天记录提取
- 全球热搜榜单 (Trending) — 全球及各国家地区热门趋势推文、热搜话题分类
- X 长文章 (Articles) — 一键将 X Articles 提取为干净规范的 Markdown（专为大模型 RAG 语料优化）、长文章草稿与一站式发布流水线
所有接口成功时均返回统一封装格式（包含 code: 200、msg: "success" 和 data 数据节点）。详见 错误处理指南。
身份认证 (Authentication)
所有 API 请求均须在 HTTP 请求头中携带您的 API 密钥：
Authorization: Bearer YOUR_API_KEY对于发推、点赞、转推、关注、发私信等写操作，还需在请求参数中附带目标账号的 Twitter Cookie 或 auth_token。完整凭据提取与调用示例请查阅 身份认证与鉴权指南。
Version 1.0.0
Base URL
https://api.twexapi.ioCookie Endpoints
- GET通过 auth_token 获取完整 Cookie
/twitter/{auth_token}/cookie - GET通过 auth_token 获取登录用户信息
/twitter/{auth_token}/user_info
Search Endpoints
- POST游标分页推特高级搜索 (Twitter Scraper API)
/twitter/advanced_search/page - POSTCashtag 股票代号搜索
/twitter/cashtags - POSTHashtag 话题标签搜索
/twitter/hashtags
Tweet Actions Endpoints
- POST点赞推文
/twitter/tweets/{tweet_id}/like - DELETE取消点赞
/twitter/tweets/{tweet_id}/like - POST转发推文 (Retweet)
/twitter/tweets/{tweet_id}/retweet - DELETE取消转发推文
/twitter/tweets/{tweet_id}/retweet - POST一键发布连环推文串 (Thread)
/v3/twitter/tweets/create-thread - POST创建推文或跟帖回复
/twitter/tweets/create - POST引用推文 (Quote Tweet)
/twitter/tweets/quote - POST添加推文书签 (Bookmark)
/twitter/tweets/{tweet_id}/bookmark - DELETE移除推文书签
/twitter/tweets/{tweet_id}/bookmark - POST批量删除推文
/twitter/tweets/delete-batch
Users Endpoints
- POST批量查询用户资料
/twitter/users - POST屏蔽用户 (Block)
/twitter/user/block - DELETE解除屏蔽用户
/twitter/user/block - POST按用户 ID 批量获取资料
/twitter/users/by_ids - POST验证账号有效性
/x/account/verify - POST批量检测用户账号状态
/twitter/users/status - GET搜索推特用户
/twitter/search-user/{keyword}/{target_count} - POST关注用户
/twitter/user/follow - DELETE取消关注用户
/twitter/user/follow
Followers & Following Endpoints
- GET按数量获取粉丝列表
/twitter/followers/{screen_name}/{count} - GET查询粉丝导出异步任务状态
/twitter/followers/task/{task_id}/status - GET提取粉丝导出任务下一页数据
/twitter/followers/task/{task_id}/next - POST分页获取粉丝列表
/twitter/followers/page - POST分页获取关注列表
/twitter/following/page - GET按数量获取关注列表
/twitter/following/{screen_name}/{count} - GET查询关注导出异步任务状态
/twitter/following/task/{task_id}/status - GET提取关注导出任务下一页数据
/twitter/following/task/{task_id}/next - POST获取关注列表 (v3 游标版)
/v3/twitter/users/following - POST导出用户粉丝列表 (v3 游标高性能版)
/v3/twitter/users/followers - POST获取蓝 V 认证粉丝 (v3)
/v3/twitter/users/verified-followers
Tweet Replies Endpoints
- POST分页拉取推文评论与回复列表 (官方推荐)
/twitter/tweets/{tweet_id}/replies/page - GET获取推文回复 (旧版)
/twitter/tweets/{tweet_id}/replies/{count}
DM Endpoints
- POST检查私信权限状态
/v2/dm/status - POST发送私信 (XChat v3 版)
/v3/twitter/send-dm - POST获取私信聊天历史 (XChat v3)
/v3/twitter/dm-history - POST获取私信媒体附件 (XChat v3)
/v3/twitter/dm-media - POST获取私信会话列表
/v3/twitter/conversations
Article Endpoints
- POST批量查询 X 长文章
/x/article - GET一键提取 X 长文章为纯净 Markdown
/x/article/{tweet_id}/markdown - POST创建长文章草稿
/x/articles/draft - PUT设置长文章封面图
/x/articles/{article_id}/cover - PUT更新长文章标题
/x/articles/{article_id}/title - PUT更新长文章正文
/x/articles/{article_id}/content - POST正式发布长文章
/x/articles/{article_id}/publish - POST一站式发布长文章
/x/articles/publish
Tweets Endpoints
- POST推文详细数据查询 (v2)
/v2/tweet/detail - POST获取完整推文串 (Thread)
/twitter/tweets/thread_by_id - POST按 ID 批量查询推文
/twitter/tweets/lookup - GET查询相似推文
/twitter/tweets/{tweet_id}/similar
Grok Endpoints
- POST向 Grok AI 发起提问
/v3/twitter/grok/ask - POST获取 Grok 历史对话记录
/v3/twitter/grok/history - POST获取 Grok 对话会话
/v3/twitter/grok/conversation
Tweet Engagement Endpoints
- POST分页获取转推用户列表
/twitter/tweets/retweeters/page - POST获取推文点赞用户列表
/twitter/tweets-favoriters - POST分页获取引用推文列表
/twitter/tweets/quotes/page
Lists Endpoints
- POST创建推特列表 (List)
/twitter/list/create - POST分页获取列表推文流
/twitter/list/tweets/page - GET获取推特列表订阅者
/twitter/list/{list_id}/subscribers/{target_count} - POST分页获取推特列表成员
/twitter/list/members/page - POST搜索推特列表
/twitter/list/search
Communities Endpoints
- POST分页获取社区成员列表
/twitter/community/members/page - POST分页获取社区推文列表
/twitter/community/tweets/page - POST搜索推特社区
/twitter/community/search - GET获取推特社区详情
/twitter/community/{community_id} - POST在社区内搜索推文
/twitter/community/search-tweets
Twitter Profile Actions Endpoints
Trending Endpoints
- GET查询支持热搜的国家列表
/twitter/global-trending/countries - GET查询热门话题分类
/twitter/global-trending/topics - GET查询热门内容标签
/twitter/global-trending/contents - GET获取全球热门趋势推文
/twitter/global-trending/tweets - GET按国家查询热搜趋势
/twitter/{country}/trending