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

# 发送您的第一个亚马逊API请求

> 使用复制粘贴代码示例向所有五个Bright Data亚马逊爬虫API端点发起同步请求。

# Simplified Chinese Translation

本教程指导你向每个 Bright Data Amazon Scraper API 端点发送同步请求。完成本教程后,你将获得产品、评价、卖家信息、全球产品和产品搜索的工作示例。

## 前置条件

* 一个[Bright Data 账户](https://www.bright.cn/cp/start),拥有有效的 API 密钥
* 已完成[快速开始](/datasets/scrapers/amazon/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://www.amazon.com/..."}]
```

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

<Note>
  同步请求最多支持 20 个 URL,超时时间为 1 分钟。如果请求花费的时间更长,API 会自动返回 `snapshot_id`。请参阅[异步请求](/datasets/scrapers/amazon/async-requests)。
</Note>

## 产品

**数据集 ID:** `gd_l7q7dkf244hwjntr0`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

你应该会看到 `200` 响应。这需要 10-30 秒。

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro (2nd Generation)",
      "asin": "B0CHHSFMRL",
      "price": 189.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 85420,
      "seller_name": "Amazon.com",
      "brand": "Apple",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/...",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL"
    }
  ]
  ```
</Accordion>

[完整产品响应模式](/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url)

## 评价

**数据集 ID:** `gd_le8e811kzy4ggddlq`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_le8e811kzy4ggddlq&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
```

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "title": "Best noise cancellation ever",
      "text": "These earbuds have incredible noise cancellation. The fit is comfortable and battery life is outstanding.",
      "rating": 5,
      "date": "2024-08-15T00:00:00.000Z",
      "author_name": "TechReviewer42",
      "verified_purchase": true,
      "helpful_count": 234,
      "asin": "B0CHHSFMRL",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL"
    }
  ]
  ```
</Accordion>

[完整评价响应模式](/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url)

## 卖家信息

**数据集 ID:** `gd_lhotzucw1etoe5iw1k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lhotzucw1etoe5iw1k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/sp?seller=A2FE5N3LOEXQRU"}]'
```

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "seller_name": "TechGadgets Direct",
      "seller_id": "A2FE5N3LOEXQRU",
      "rating": 4.5,
      "ratings_count": 12450,
      "positive_feedback_pct": 95,
      "business_name": "TechGadgets LLC",
      "business_address": "123 Commerce St, Seattle, WA 98101",
      "url": "https://www.amazon.com/sp?seller=A2FE5N3LOEXQRU"
    }
  ]
  ```
</Accordion>

[完整卖家信息响应模式](/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url)

## 全球产品

**数据集 ID:** `gd_lwhideng15g8jg63s7`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.co.uk/dp/B0CHHSFMRL"}]'
```

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro (2nd Generation)",
      "asin": "B0CHHSFMRL",
      "price": 229.00,
      "currency": "GBP",
      "rating": 4.7,
      "reviews_count": 32150,
      "seller_name": "Amazon.co.uk",
      "brand": "Apple",
      "availability": "In Stock",
      "domain": "amazon.co.uk",
      "url": "https://www.amazon.co.uk/dp/B0CHHSFMRL"
    }
  ]
  ```
</Accordion>

[完整全球产品响应模式](/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url)

## 产品搜索

**数据集 ID:** `gd_lwdb4vjm1ehb499uxs`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwdb4vjm1ehb499uxs&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "wireless earbuds", "url": "https://www.amazon.com", "pages_to_search": 1}]'
```

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro (2nd Generation)",
      "asin": "B0CHHSFMRL",
      "price": 189.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 85420,
      "sponsored": false,
      "position": 1,
      "keyword": "wireless earbuds",
      "url": "https://www.amazon.com/dp/B0CHHSFMRL"
    },
    {
      "title": "Samsung Galaxy Buds2 Pro",
      "asin": "B0B2SH4CN6",
      "price": 159.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 42300,
      "sponsored": false,
      "position": 2,
      "keyword": "wireless earbuds",
      "url": "https://www.amazon.com/dp/B0B2SH4CN6"
    }
  ]
  ```
</Accordion>

[完整产品搜索响应模式](/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url)

## 快速参考:数据集 ID

| 端点   | 数据集 ID                  | 输入格式                                  |
| :--- | :---------------------- | :------------------------------------ |
| 产品   | `gd_l7q7dkf244hwjntr0`  | `amazon.com/dp/{ASIN}`                |
| 评价   | `gd_le8e811kzy4ggddlq`  | `amazon.com/dp/{ASIN}`                |
| 卖家信息 | `gd_lhotzucw1etoe5iw1k` | `amazon.com/sp?seller={SELLER_ID}`    |
| 全球产品 | `gd_lwhideng15g8jg63s7` | `amazon.{domain}/dp/{ASIN}`           |
| 产品搜索 | `gd_lwdb4vjm1ehb499uxs` | `keyword` + `url` + `pages_to_search` |

## 输出格式

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

| 值        | 描述                |
| :------- | :---------------- |
| `json`   | JSON 数组(默认)       |
| `ndjson` | 换行分隔的 JSON,每行一条记录 |
| `csv`    | 逗号分隔值             |

## 后续步骤

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

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