内容与社交 / X API

X 开发者平台

X API 提供帖子搜索、实时内容流、发布、用户关系、私信和内容指标等能力，适合内容工具、品牌监测与授权账号管理。当前自助接入以 credits 按用量计费，具体功能还受认证、权限、端点规则和开发者政策约束。

帖子搜索实时内容流内容发布账号授权私信数据分析

01 / CAPABILITIES

开放功能

帖子搜索与内容读取

按关键词、话题标签、作者或链接查找帖子，读取帖子详情和时间线，构建信息检索与品牌提及看板。

接入要求需要开发者应用凭证；近期搜索与完整历史搜索的时间范围和访问要求不同，返回字段与数据可见性取决于端点和授权。

X API 能力概览帖子近期搜索与完整历史搜索注册开发者、创建应用与获取凭证

实时过滤内容流

配置过滤规则后，使用长连接或按官方条件配置 Webhook 投递，持续接收匹配的公开帖子，适合事件监听和新内容处理。

接入要求需要相应的应用凭证；长连接需处理断线和重连，Webhook 需核对开通条件并配置可接收投递的回调端点。规则、连接及高级操作符有访问限制，不能视为全站无限数据流。

实时过滤内容流与访问限制

发布与管理帖子

代表授权用户发布文本、带媒体或投票的帖子，组合连续帖子，并删除该用户自己的内容。

接入要求需要用户授权和对应写入权限；媒体需先上传。自助接入仅允许在原帖作者已通过 @ 提及该回复账号，或引用该账号的帖子明确召唤其参与后回复；自动互动还需遵守政策。

帖子创建、回复、媒体与删除条件 OAuth 2.0 PKCE、回调地址与 scopes 开发者政策：自动化、隐私、展示和内容删除

用户资料与关注关系

查询用户资料及可访问的关注关系，或在授权用户主动发起操作时执行关注与取消关注。

接入要求公开读取和关系写入使用不同认证及权限；OAuth 场景需按端点配置 users.read、follows.read 或 follows.write，禁止批量或激进的关注操作。

X API 能力概览关注关系查询与管理 OAuth 2.0 PKCE、回调地址与 scopes 开发者政策：自动化、隐私、展示和内容删除

授权账号私信

读取授权用户可访问的私信事件，创建会话、发送消息，支持个人和群组会话中的相关操作。

接入要求需要用户上下文授权及私信读写权限；只能访问授权用户可见的会话，历史查询范围有限。自动私信须事先取得明确同意并提供退出方式。

授权用户私信事件查询与历史范围授权用户私信与会话管理 OAuth 2.0 PKCE、回调地址与 scopes 开发者政策：自动化、隐私、展示和内容删除

列表管理

创建、更新与删除授权账号的列表，结合列表成员和内容查询组织关注主题。

接入要求管理列表需要用户 Access Token 与相应列表权限；私有列表受授权可见性约束，不得无差别批量添加用户。

创建、更新与删除列表官方入门 OAuth 2.0 PKCE、回调地址与 scopes 开发者政策：自动化、隐私、展示和内容删除

帖子与媒体表现指标

查询公开互动指标，并在用户授权后读取自己内容可提供的非公开、自然传播或推广指标，制作内容表现看板。

接入要求公开与非公开指标认证要求不同；非公开指标限授权用户自己的内容，并受官方规定的时间范围限制。

公开与非公开帖子、媒体指标

02 / REQUIREMENTS

接入条件

适用主体: 内容工具开发者、品牌与社媒团队、数据产品开发者、独立开发者
接入方式: 应用级 Bearer Token，用于支持的公开数据读取 / OAuth 2.0 授权码流程与 PKCE，用于用户授权操作 / OAuth 1.0a 用户上下文，用于支持该认证方式的端点
申请概况: 注册开发者并创建应用后接入

使用 X 账号注册开发者、接受协议并说明用途，在控制台创建应用并取得凭证；本导航不收集凭证，也不代接账号。
根据目标端点选择应用认证或用户认证；OAuth 2.0 需在应用设置中启用，并配置准确的回调地址与所需 scopes。
在控制台核对余额、端点价格与支出上限，再安排开发和测试请求。
遵守开发者协议、数据政策和自动化规则；公开展示内容时保留其完整性，并响应内容删除及用户退出要求。

03 / GET STARTED

开通步骤

01
注册并创建应用
进入 Developer Console，填写用途并创建 App，取得相应 API 凭证。
02
确认费用与目标端点
查看所需端点的现行价格、认证和访问条件，按自己的预算设置支出上限。
03
完成最小读取请求
按官方首次请求教程，用应用 Bearer Token 运行用户或帖子查询，检查 JSON 结果与频控响应头。
04
再接入用户写操作
配置 OAuth 及最小权限，使用自己控制的测试账号验证授权和撤销；发布、私信等请求会真实影响账号。

04 / COSTS & LIMITS

费用、边界与测试方式

费用概况

按用量消耗预购 credits，具体价格以控制台及当前官方计费页为准。

当前自助接入采用按用量模式，先在控制台购买 credits，再按实际调用消耗。
读取通常按返回资源计费，写入和互动按相应请求或动作计费；不同资源及端点的费用不同。
控制台支持查看用量、设置支出上限与配置自动充值；达到支出上限或余额不足可能阻止后续请求。
开发和测试也应纳入预算；免费 credits 活动、折扣、税费及企业方案需要另查当前资格与条款。

使用范围与限制

拥有应用凭证不代表能读取任意账号的私密信息；受保护内容、私信和非公开指标依赖相应用户授权与可见范围。
频控按端点以及应用或用户维度计算；应读取 x-rate-limit 响应头，遇到 429 后等待相应窗口恢复。
API 有发布能力不代表可以批量营销；自动回复、私信、关注及跨账号重复发布等行为受开发者政策和自动化规则限制。
展示、存储、再分发和删除 X 数据有独立规则；不得把公开搜索接口描述为可任意复制或长期保留所有数据。
开发者协议要求遵守适用法律及出口、进口限制；本页未核验用户所在地区、支付方式或账号的实际开通资格。
本次未确认通用免费沙箱；官方首次请求教程使用正式 API，请求可能计费，写操作也会产生真实内容或互动。

如何进行开发测试

正式 API：首次请求教程使用 api.x.com，需要真实的开发者应用凭证。
开发验证：可先按官方教程使用 cURL、Postman 或 HTTP 客户端进行少量只读请求，并设置预算上限。
写入验证：使用自己控制并明确用于测试的账号，按政策验证授权、撤销及错误处理；本页未进行账号或接口实测。
沙箱情况：本次核对资料中未确认覆盖上述能力的通用免费沙箱，不承诺测试免计费或与正式账号隔离。

接入前再确认

当前自助计费页与部分协议页面仍存订阅措辞差异，实际购买条款需在控制台再次核对。
本次未确认通用免费沙箱。开发测试请求可能计费，写入操作可能真实影响账号。

05 / OFFICIAL SOURCES

官方资料

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

01
X API 能力概览已核对官方资料 · 2026-10-15
02
注册开发者、创建应用与获取凭证已核对官方资料 · 2026-10-15
03
X API 认证方式概览已核对官方资料 · 2026-10-15
04
OAuth 2.0 PKCE、回调地址与 scopes已核对官方资料 · 2026-10-15
05
帖子近期搜索与完整历史搜索已核对官方资料 · 2026-10-15
06
实时过滤内容流与访问限制已核对官方资料 · 2026-10-15
07
帖子创建、回复、媒体与删除条件已核对官方资料 · 2026-10-15
08
关注关系查询与管理已核对官方资料 · 2026-10-15
09
授权用户私信事件查询与历史范围已核对官方资料 · 2026-10-15
10
授权用户私信与会话管理已核对官方资料 · 2026-10-15
11
创建、更新与删除列表官方入门已核对官方资料 · 2026-10-15
12
公开与非公开帖子、媒体指标已核对官方资料 · 2026-10-15
13
X API 按用量计费、credits 与支出上限已核对官方资料 · 2026-10-15
14
端点频控、应用和用户维度及响应头已核对官方资料 · 2026-10-15
15
使用 cURL 或 Postman 发送首个正式 API 请求已核对官方资料 · 2026-10-15
16
开发者政策：自动化、隐私、展示和内容删除已核对官方资料 · 2026-10-15
17
开发者协议：资格、适用法律与跨境限制已核对官方资料 · 2026-10-15
18
X 开发者控制台入口官方入口 · 细则待复核 · 2026-10-15

官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明