工作原理
你向 Bright Data X Scraper API 发送一个或多个 X（前身为 Twitter）URL。Bright Data 负责处理抓取基础设施，并返回干净、结构化的 JSON。dataset_id 来指定数据类型（个人主页或帖子），并以 JSON、NDJSON 或 CSV 格式返回结果。
响应内容示例
Bright Data X (Twitter) Scraper API 于 2026 年 9 月 6 日返回的单条记录（已裁剪为所示字段）。可在快速开始中亲自发送该请求。支持的数据类型
个人主页
粉丝数、简介、认证状态、头像图片。可通过用户名发现个人主页。
帖子
帖子文本、点赞、转发、回复、媒体和话题标签。可通过个人主页 URL 发现帖子。
请求方式
Bright Data Scraper API 支持两种请求方式，请根据您的数据量和延迟需求选择。
详见了解同步与异步请求。
两个端点都接受两种请求体格式：本页所有示例使用的纯 JSON 数组，或带有
input 数组的对象。当您同时传入 custom_output_fields 或 limit_per_input（两个端点均支持），或在 /trigger 上传入 deliver 配置时，请使用对象格式。详见请求体。
功能与限制
常见问题
数据是实时抓取的吗？
是的。每次请求都会触发一次实时抓取。没有缓存或过时的数据。处理时间取决于目标网站状况和爬虫负载。Bright Data X（Twitter）Scraper API 不公布固定的响应时间。同步请求最多等待 1 分钟，之后返回 HTTP202 和 snapshot_id，并继续以异步方式采集。发现（discovery）请求始终以异步方式运行，耗时更长，具体取决于结果数量。
响应时间为什么会发生变化？
X（Twitter）会调整其页面的提供方式，Bright Data X（Twitter）Scraper API 的采集器也会相应更新。即使成功率保持不变，采集器更新也可能改变一次采集所需的时间。对于生产环境的工作负载，请基于异步工作流或 Webhook 投递进行构建，这样较长的运行时间不会破坏集成。URL 采集与发现有什么区别？
URL 采集 抓取你提供的特定 X 页面（例如个人主页 URL）。发现 查找符合搜索条件的 X 内容（例如某个个人主页 URL 的所有帖子）并抓取结果。发现请求在两个端点上均可使用。在/scrape 上通常会超过 1 分钟限制并返回 HTTP 202 和 snapshot_id，因此发现请求请使用异步 /trigger 端点。
与使用代理或 Web Unlocker API 抓取有何不同？
使用代理或 Web Unlocker API 抓取时，您仍需编写和维护自己的解析逻辑，并在目标网站页面结构变化时随时更新。Bright Data Scraper API 处理整个链路：代理轮换、反爬绕过与解析。您只需发送 URL 或关键词，即可获得干净的结构化 JSON，无需自建抓取基础设施或维护解析器。后续步骤
快速开始
5 分钟内抓取你的第一个 X 个人主页。
端点
每个端点一个请求，附实际抓取的响应。
API 参考
端点规格、参数和响应模式。