Amazon Product Search
Amazon Product Search 用于根据关键词获取 Amazon 商品搜索结果。
- 按关键词搜索 Amazon 商品
- 支持按地区获取对应结果
- 支持分页抓取搜索结果
- 返回商品列表和筛选项信息
使用 XCrawl 获取 Amazon 商品搜索结果
使用方式
curl -s -X POST 'https://run.xcrawl.com/v1/data' \
-H 'Authorization: Bearer $XCRAWL_API_KEY'\
-H 'Content-Type: application/json' \
-d '{
"engine": "amazon_search",
"keyword": "shoe",
"location": "US",
"start_page": 1,
"pages": 1
}'请求参数说明:
engine固定为amazon_searchkeyword用于指定搜索关键词location用于指定搜索地区start_page和pages用于控制抓取页范围
响应示例
{
"result": [
{
"content": {
"search_url": "https://www.amazon.com/s?k=shoe",
"keyword": "shoe",
"page": 1,
"pages": 7,
"products": [
{
"asin": "B0XXXXX",
"title": "Example Product",
"price": 39.99,
"currency": "USD",
"rating": 4.5,
"reviews": 1200,
"url": "https://www.amazon.com/..."
}
],
"refinements": {
"Brands": [
{
"name": "Nike",
"value": "n:7141123011,p_123:234394"
}
]
}
}
}
]
}参数说明
必填参数
| 参数 | 类型 | 说明 |
|---|---|---|
location | string | 指定搜索地区。 |
keyword | string | 指定搜索关键词。 |
start_page | number | 指定从第几页开始抓取。 |
pages | number | 指定连续抓取的页数。 |
参数补充说明
location默认值为USlocation支持多个地区值,例如US、HK、CA、AD、AEkeyword默认值为空字符串start_page默认值为1pages默认值为1
响应字段
响应数据位于 result[].content。
| 字段 | 类型 | 说明 |
|---|---|---|
search_url | string | 搜索结果页地址。 |
keyword | string | 当前搜索关键词。 |
page | number | 当前页码。 |
pages | number | 搜索结果总页数。 |
products | array | 商品列表。 |
refinements | object | 搜索筛选项。 |
商品字段
products[] 中每个元素通常包含以下字段:
| 字段 | 类型 | 说明 |
|---|---|---|
asin | string | 商品 ASIN。 |
title | string | 商品标题。 |
price | number | 商品价格。 |
currency | string | 价格货币。 |
rating | number | 商品评分。 |
reviews | number | 评论数量。 |
url | string | 商品详情页链接。 |
筛选项字段
refinements 用于返回可进一步筛选搜索结果的条件,例如品牌、部门、卖家等。
