> ## 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.

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

> 使用可复制粘贴的代码示例向Bright Data X爬虫API端点发起同步请求。

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

## 前提条件

* 具有活跃 API 密钥的 [Bright Data 账户](https://www.bright.cn/cp/start)
* 已完成 [快速入门](/cn/products/scrapers/twitter/quickstart)

## 请求结构

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

```
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 格式。

<Note>
  同步请求最多支持 20 个 URL，超时时间为 1 分钟。如果请求耗时更长，API 将自动返回 `snapshot_id`。请查阅 [异步请求](/cn/products/scrapers/scrapers-library/async-requests)。
</Note>

## 配置文件

**数据集 ID：** `gd_lwxmeb2u1cniijd7t4`

```bash theme={null}
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 秒。

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "user_name": "elonmusk",
      "name": "Elon Musk",
      "description": "Read @WallStreetSilv",
      "followers": 214000000,
      "following": 870,
      "number_of_tweets": 52000,
      "is_verified": true,
      "profile_image_link": "https://..."
    }
  ]
  ```
</Accordion>

[完整配置文件响应架构](/cn/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url)

## 帖子

**数据集 ID：** `gd_lwxkxvnf1cynvib9co`

```bash theme={null}
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"}]'
```

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "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"]
    }
  ]
  ```
</Accordion>

[完整帖子响应架构](/cn/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url)

## 快速参考：数据集 ID

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

## 输出格式

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

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

## 相关内容

<CardGroup cols={2}>
  <Card title="异步批量请求" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    在单个批处理作业中抓取数百个 URL。
  </Card>

  <Card title="API 参考" icon="code" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    完整的参数和响应字段参考。
  </Card>
</CardGroup>