发送您的第一个 X (Twitter) API 请求

本指南介绍如何向每个 Bright Data X Scraper API 端点发送同步请求。完成后，您将拥有用于配置文件和帖子的工作示例。

前提条件

具有活跃 API 密钥的 Bright Data 账户
已完成快速入门

请求结构

每个同步请求都遵循相同的模式：

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://x.com/..."}]

端点之间唯一变化的是 dataset_id 和输入 URL 格式。

同步请求最多支持 20 个 URL，超时时间为 1 分钟。如果请求耗时更长，API 将自动返回 snapshot_id。请查阅异步请求。

配置文件

数据集 ID： gd_lwxmeb2u1cniijd7t4

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 秒。

示例响应

[
  {
    "user_name": "elonmusk",
    "name": "Elon Musk",
    "description": "Read @WallStreetSilv",
    "followers": 214000000,
    "following": 870,
    "number_of_tweets": 52000,
    "is_verified": true,
    "profile_image_link": "https://..."
  }
]

完整配置文件响应架构

帖子

数据集 ID： gd_lwxkxvnf1cynvib9co

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxkxvnf1cynvib9co&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk/status/1234567890123456789"}]'

示例响应

[
  {
    "url": "https://x.com/elonmusk/status/1234567890123456789",
    "user_posted": "elonmusk",
    "description": "Exciting times ahead...",
    "date_posted": "2024-04-03T14:30:00.000Z",
    "likes": 125000,
    "retweets": 18000,
    "replies": 5200,
    "hashtags": ["technology", "innovation"]
  }
]

完整帖子响应架构

快速参考：数据集 ID

端点	数据集 ID	URL 模式
配置文件	`gd_lwxmeb2u1cniijd7t4`	`x.com/{username}`
帖子	`gd_lwxkxvnf1cynvib9co`	`x.com/{username}/status/{id}`

输出格式

使用 format 查询参数控制响应格式：

值	描述
`json`	JSON 数组（默认）
`ndjson`	换行符分隔的 JSON，每行一条记录
`csv`	逗号分隔值

异步批量请求

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

API 参考

完整的参数和响应字段参考。

快速开始

数据提取

Web 访问

AI 训练数据

代理网络

发送您的第一个 X (Twitter) API 请求

前提条件

请求结构

配置文件

帖子

快速参考：数据集 ID

输出格式

相关内容

异步批量请求

API 参考

​前提条件

​请求结构

​配置文件

​帖子

​快速参考：数据集 ID

​输出格式

​相关内容

异步批量请求

API 参考

前提条件

请求结构

配置文件

帖子

快速参考：数据集 ID

输出格式

相关内容