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

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

前置条件

一个Bright Data 账户,拥有有效的 API 密钥
已完成快速开始

请求结构

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

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

/scrape 端点专为实时的单 URL 请求设计。它最多支持 20 个 URL，最多等待 1 分钟。如果采集耗时更长，响应将返回 snapshot_id 而不是数据，采集将继续以异步方式进行。请通过异步请求获取结果，或使用 Webhook 投递接收结果。

产品

数据集 ID: gd_l7q7dkf244hwjntr0

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/B0FQFB8FMG"}]'

你应该会看到 200 响应。处理时间取决于目标网站状况和爬虫负载。

示例响应

[
  {
    "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
    "asin": "B0FQFB8FMG",
    "brand": "Apple",
    "initial_price": 249,
    "final_price": 199.99,
    "currency": "USD",
    "rating": 4.4,
    "reviews_count": 14302,
    "seller_name": "Amazon.com",
    "availability": "In Stock",
    "image_url": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_SL1500_.jpg",
    "url": "https://www.amazon.com/dp/B0FQFB8FMG"
  }
]

完整产品响应模式

评价

数据集 ID: gd_le8e811kzy4ggddlq

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/B0FQFB8FMG"}]'

示例响应

[
  {
    "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": "B0FQFB8FMG",
    "url": "https://www.amazon.com/dp/B0FQFB8FMG"
  }
]

完整评价响应模式

卖家信息

数据集 ID: gd_lhotzucw1etoe5iw1k

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"}]'

示例响应

[
  {
    "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"
  }
]

完整卖家信息响应模式

全球产品

数据集 ID: gd_lwhideng15g8jg63s7

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/B0FQFB8FMG"}]'

示例响应

[
  {
    "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
    "asin": "B0FQFB8FMG",
    "final_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/B0FQFB8FMG"
  }
]

完整全球产品响应模式

产品搜索

数据集 ID: gd_lwdb4vjm1ehb499uxs

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}]'

示例响应

[
  {
    "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
    "asin": "B0FQFB8FMG",
    "final_price": 199.99,
    "currency": "USD",
    "rating": 4.7,
    "reviews_count": 14302,
    "sponsored": false,
    "position": 1,
    "keyword": "wireless earbuds",
    "url": "https://www.amazon.com/dp/B0FQFB8FMG"
  },
  {
    "title": "Samsung Galaxy Buds2 Pro",
    "asin": "B0B2SH4CN6",
    "final_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"
  }
]

完整产品搜索响应模式

快速参考:数据集 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`	逗号分隔值

异步批量请求

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

API 参考

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

开始使用

数据提取

Web 访问

AI 训练数据

代理网络

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

前置条件

请求结构

产品

评价

卖家信息

全球产品

产品搜索

快速参考:数据集 ID

输出格式

相关内容

异步批量请求

API 参考

​前置条件

​请求结构

​产品

​评价

​卖家信息

​全球产品

​产品搜索

​快速参考:数据集 ID

​输出格式

​相关内容

异步批量请求

API 参考

前置条件

请求结构

产品

评价

卖家信息

全球产品

产品搜索

快速参考:数据集 ID

输出格式

相关内容