APIMUX文档Amazon 商品 API
Amazon 商品搜索与商品详情查询
搜索商品
根据关键词在指定的亚马逊站点上搜索商品，返回商品列表，支持排序、筛选和分页。
- 接口路径：
GET /amazon/search
请求参数
| 参数名 | 位置 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
query | Query | string | 是 | 搜索关键词。 |
domain | Query | string | 否 | 亚马逊站点域名，默认为 amazon.com。支持 amazon.cn, amazon.co.jp 等。 |
language | Query | string | 否 | 页面显示语言。 |
delivery_country | Query | string | 否 | 配送目标国家代码（两位 ISO 3166-1 alpha-2）。 |
sort_by | Query | string | 否 | 排序方式，可选值：featured (默认), price_low_to_high, price_high_to_low, average_review, newest_arrivals, bestsellers。 |
price_min | Query | number | 否 | 筛选最低价格。 |
price_max | Query | number | 否 | 筛选最高价格。 |
page | Query | number | 否 | 结果页码，默认为 1。 |
请求示例
curl --request GET \
--url 'https://api.apimux.io/v1/amazon/search?query=MacBook+Pro&domain=amazon.com&sort_by=average_review&page=1' \
--header 'Authorization: Bearer YOUR_API_KEY'响应示例
{
"code": 200,
"message": "success",
"data": {
"organic_results": [
{
"position": 1,
"asin": "B0CM5JV26D",
"title": "2023 MacBook Pro Laptop M3 Pro chip with 11‑core CPU, 14‑core GPU",
"brand": "Apple",
"rating": 4.7,
"reviews": 229,
"recent_sales": "1K+ bought in past month",
"price": "$1,799.00",
"extracted_price": 1799,
"original_price": "$1,999.00",
"is_prime": true,
"is_overall_pick": true,
"thumbnail": "https://m.media-amazon.com/images/I/61RJn0ofUsL._AC_UY218_.jpg",
"fulfillment": {
"standard_delivery": { "text": "FREE delivery Mon, May 6", "type": "FREE delivery" },
"fastest_delivery": { "text": "Or fastest delivery Tomorrow, May 1" }
},
"attributes": [
{ "name": "Display Size", "value": "14.2 inches" }
]
}
],
"pagination": {
"current": 1,
"next_page": 2
}
}
}获取商品详情
根据商品的 ASIN (Amazon Standard Identification Number) 获取其完整的商品详情信息。
- 接口路径：
GET /amazon/product
请求参数
| 参数名 | 位置 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
asin | Query | string | 是 | 目标商品的 ASIN。 |
domain | Query | string | 否 | 亚马逊站点域名，默认为 amazon.com。 |
language | Query | string | 否 | 页面显示语言。 |
delivery_country | Query | string | 否 | 配送目标国家代码。 |
请求示例
curl --request GET \
--url 'https://api.apimux.io/v1/amazon/product?asin=B0CM5JV26D&domain=amazon.com' \
--header 'Authorization: Bearer YOUR_API_KEY'响应示例
{
"code": 200,
"message": "success",
"data": {
"asin": "B0CM5JV26D",
"title": "2023 MacBook Pro Laptop M3 Pro chip with 11‑core CPU",
"brand_store": {
"text": "Visit the Apple Store",
"link": "https://www.amazon.com/stores/Apple/page/..."
},
"rating": 4.7,
"reviews": 229,
"reviews_histogram": {
"5": { "reviews": 180, "percentage": 79 },
"4": { "reviews": 28, "percentage": 12 },
"3": { "reviews": 10, "percentage": 4 },
"2": { "reviews": 5, "percentage": 2 },
"1": { "reviews": 6, "percentage": 3 }
},
"buybox": {
"price": { "raw": "$1,799.00", "value": 1799, "currency": "USD" },
"original_price": { "raw": "$1,999.00", "value": 1999 },
"fulfillment": {
"standard_delivery": { "text": "FREE delivery Mon, May 6" },
"availability": "In Stock"
}
},
"feature_bullets": [
"商品卖点文案 1",
"商品卖点文案 2"
],
"attributes": [
{ "name": "Brand", "value": "Apple" },
{ "name": "Display Size", "value": "14.2 inches" }
],
"specifications": [
{ "name": "Processor", "value": "Apple M3 Pro" }
],
"variants": [
{
"asin": "B0CM5JV26D",
"title": "Space Black",
"dimensions": [{ "name": "Color", "value": "Space Black" }],
"main_image": "https://m.media-amazon.com/images/I/61RJn0ofUsL.jpg"
}
],
"categories": [
{ "id": "172282", "title": "Electronics" }
],
"bestsellers_rank": [
{ "name": "Computers & Accessories", "rank": 12 }
],
"main_image": "https://m.media-amazon.com/images/I/61RJn0ofUsL.jpg",
"images": [
{ "link": "https://m.media-amazon.com/images/I/61RJn0ofUsL.jpg", "variant": "MAIN" }
]
}
}