REST API 概览与接口参考

TwexAPI REST API 规范参考 — 基础鉴权、响应结构、分页游标及全功能核心端点中文速查指南。

TwexAPI 通过统一的 API 网关 https://api.twexapi.io 对外提供标准的 RESTful API，全面支持 Twitter/X 平台的数据读取、内容写入、推文高级搜索、用户资料与社交图谱导出、私信收发、话题趋势榜单、长文章处理、社区动态及账号运维等全套功能。

本页作为 API 的全功能中文参考中心，系统梳理了各核心接口的中文功能定义、关键入参说明、鉴权需求及直达链接。

基础服务地址 (Base URL)

https://api.twexapi.io

身份认证机制

所有 API 请求均须在 HTTP 请求头中携带有效的 API 密钥：

Authorization: Bearer YOUR_API_KEY

• 只读接口 (Read)：仅需携带 Authorization: Bearer YOUR_API_KEY 即可调用。
• 写操作接口 (Write)：发推、回复、点赞、转推、关注、发私信等接口，还须在请求参数中附带已登录目标账号的 Twitter Cookie 或 auth_token。完整凭据提取与多语言示例请参考 身份认证与鉴权指南。

统一响应数据结构

所有接口调用成功时，均返回统一的封装格式：

{
  "code": 200,
  "msg": "success",
  "data": {}
}

客户端判定请求成功必须以 HTTP 状态码处于 2xx 区间为准。当发生异常时，接口将返回对应的非 2xx HTTP 状态码及详细的错误 JSON 详情。错误码应对清单请查阅 错误处理与恢复指南。

分页与游标机制 (Cursor Pagination)

列表查询与搜索接口通常在 data 节点中返回 has_next_page、next_cursor 或分页标记字段。拉取下一页数据时，请将上一页返回的游标值原样作为请求参数传入。遇到 429 速率限制或网络抖动重试时，必须重试当前相同的游标，避免跳页漏数。

账户配额与余额查询

在发起大规模批量拉取或自动化循环任务前，建议主动调用余额查询端点核对额度：

curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'

开发者高频业务场景与端点选型指南 (High-Intent Use Cases)

针对开发者与出海团队最常面临的推特数据采集与业务场景，我们整理了最佳端点选型推荐：

核心接口中文速查手册

以下整理了 TwexAPI 平台最常用的核心接口及其功能说明。你可以点击各接口名称直接跳转到对应的详细参数规范与在线调试面板。

1. 推文检索与高级搜索 (Search)

2. 推文详情、推文串与互动分析 (Tweets & Engagement)

3. 用户资料与社交图谱 (Users & Followers)

4. 发布与互动写操作 (Tweet Actions & Writes)

5. 私信会话管理 (Direct Messages - DM)

6. 全球热搜与趋势榜单 (Trending)

7. X 长文章与 Markdown 提取 (Articles)

8. 账号工具与会话辅助 (Cookie & Balance)

接入方式与架构选型指南

核心运维与稳定性指引

• 错误处理与恢复指南 — HTTP 状态码深度解析、MCP 协议报错排查与幂等重试规则
• 速率限制与并发控制 — 100 QPS 吞吐优化、429 指数退避算法及并发平滑建议
• 身份认证与鉴权指南 — API Key 格式规范、环境变量管理与写操作多语言代码示例

数据处理说明 (Data handling)

TwexAPI does not maintain an archive or database of X content. We do not persist copies of public posts, X Articles, direct-message content, or AI chat content obtained through customer requests.

Requests are processed in transit. We retain only limited operational information necessary for security, abuse prevention, billing, and service reliability, such as request timestamps, endpoint usage, status codes, and credit consumption. We do not sell or provide archived X-content datasets.

（TwexAPI 不维护 X 内容的存档或数据库。我们不会保留通过客户请求获取的公开帖子、X 文章、私信内容或 AI 聊天内容的副本。请求均在传输过程中即时处理。我们仅保留出于安全性、防滥用、计费及服务可靠性所必需的有限运营信息，例如请求时间戳、端点调用记录、状态码和积分消耗。我们不会出售或提供存档的 X 内容数据集。）