Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

本教程向您展示如何使用 Bright Data X Scraper API 抓取 X（前称 Twitter）个人资料并获取结构化的 JSON 数据。

​
前置条件

  • 一个 Bright Data 账户（包含 $2 免费额度）
  • 已安装 cURL、Python 3 或 Node.js 18+
1

获取您的 API 密钥

转到您 Bright Data 账户中的用户设置页面并复制您的 API 密钥。如果您还没有账户，请在 brightdata.com 注册。新用户可获得 $2 免费额度用于测试。
您的 API 密钥仅在创建时显示一次。请安全地复制并存储它。
2

发送请求

我们将使用个人资料端点发送同步请求。将 YOUR_API_KEY 替换为您的实际密钥：
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk"}]'
您应该会看到 200 状态码。这需要 10-30 秒。
3

查看响应

Bright Data X Scraper API 返回一个包含结构化个人资料数据的 JSON 数组：
[
  {
    "user_name": "elonmusk",
    "name": "Elon Musk",
    "description": "Read @WallStreetSilv",
    "followers": 214000000,
    "following": 870,
    "number_of_tweets": 52000,
    "is_verified": true,
    "url": "https://x.com/elonmusk"
  }
]
每个个人资料对象都包含涵盖粉丝数、个人简介、认证状态等字段。请查看完整响应架构。
您已成功使用 Bright Data X Scraper API 抓取了第一个 X 个人资料。

​
常见问题

可以。向输入数组添加更多对象即可。同步请求支持最多 20 个 URL。对于更大的批次，请使用异步 /trigger 端点。
[
  {"url": "https://x.com/elonmusk"},
  {"url": "https://x.com/BillGates"},
  {"url": "https://x.com/NASA"}
]
验证您的 API 密钥是否正确且未过期。从账户设置生成新密钥。有关详细信息，请参阅身份验证指南。
同步请求的超时时间为 1 分钟。如果请求超过此限制，它将自动切换到异步模式并返回 snapshot_id。对于大批量抓取，请使用异步工作流。
验证 X 个人资料 URL 是否可公开访问且格式正确。URL 应遵循 https://x.com/username 的模式。

​
后续步骤

发送您的第一个请求

探索包含完整示例的两种端点类型。

异步批量请求

在单个批处理作业中抓取数百个 URL。

设置 Webhook

在抓取完成时自动接收结果。