Amazon API

Amazon API 允许你搜索商品并通过 ASIN 获取详细的商品信息。两个端点均支持多区域定向、货币本地化和设备模拟。

端点

端点	描述
`POST /api/v1/amazon/search`	搜索 Amazon 商品，支持排序、分页和分类筛选
`POST /api/v1/amazon/product`	通过 ASIN 获取详细商品信息

身份验证

Header	值	必填
`Authorization`	`Bearer YOUR_API_KEY`	是
`Content-Type`	`application/json`	是

商品搜索

Bash

POST https://api.scavio.dev/api/v1/amazon/search

搜索 Amazon 商品并获取结构化结果，包括价格、评分和商品详情。

请求体

参数	类型	默认值	描述
`query`	`string`	--	必填。搜索查询（1-500 字符）。
`domain`	`string`	`com`	Amazon 域名后缀（如 `com`、`co.uk`、 `de`、`fr`、`co.jp`）。
`sort_by`	`string`	--	排序方式。可选值：`most_recent`、 `price_low_to_high`、`price_high_to_low`、 `featured`、`average_review`、 `bestsellers`
`start_page`	`integer`	`1`	起始页码（从 1 开始）。
`pages`	`integer`	`1`	返回的页数。
`category_id`	`string`	--	Amazon 分类/部门 ID，用于缩小结果范围。
`merchant_id`	`string`	--	按特定 Amazon 商家筛选。
`country`	`string`	--	本地化的国家代码。
`language`	`string`	--	结果的语言代码。
`currency`	`string`	--	ISO 4217 货币代码（如 `USD`、`EUR`、 `GBP`）。
`device`	`string`	`desktop`	设备类型。可选值：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	邮政编码，用于获取本地化的价格和库存信息。
`autoselect_variant`	`boolean`	--	自动选择默认商品变体。

示例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

响应示例

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

商品详情

Bash

POST https://api.scavio.dev/api/v1/amazon/product

通过 ASIN 获取特定 Amazon 商品的详细信息。返回价格、描述、规格、图片、评分和卖家信息。

请求体

参数	类型	默认值	描述
`query`	`string`	--	必填。 Amazon ASIN（如 `B09XS7JWHH`）。
`domain`	`string`	`com`	Amazon 域名后缀（如 `com`、`co.uk`、 `de`）。
`country`	`string`	--	本地化的国家代码。
`language`	`string`	--	结果的语言代码。
`currency`	`string`	--	ISO 4217 货币代码（如 `USD`、`EUR`）。
`device`	`string`	`desktop`	设备类型。可选值：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	邮政编码，用于获取本地化价格。
`autoselect_variant`	`boolean`	--	自动选择默认商品变体。

示例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

响应示例

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

支持的域名

使用 domain 参数来指定特定的 Amazon 市场：

域名	市场
`com`	美国
`co.uk`	英国
`de`	德国
`fr`	法国
`co.jp`	日本
`ca`	加拿大
`it`	意大利
`es`	西班牙
`in`	印度
`com.au`	澳大利亚
`com.br`	巴西
`com.mx`	墨西哥

响应格式

两个端点返回一致的响应包装结构：

字段	类型	描述
`data`	`object \| null`	响应载荷。如果上游请求失败则为 `null`。搜索返回 `{page, products, html}`；商品详情直接返回商品对象。
`response_time`	`number`	服务端响应时间（毫秒）
`credits_used`	`number`	消耗的积分数量
`credits_remaining`	`number`	当前计费周期剩余积分

错误响应

状态码	描述
`401`	未授权 -- API 密钥缺失或无效
`429`	超出当前套餐的速率或用量限制
`502`	上游错误 -- 请稍后重试
`503`	上游不可用 -- 请稍后重试

参阅错误参考获取完整的错误说明和重试最佳实践。

Amazon API

Amazon API 允许你搜索商品并通过 ASIN 获取详细的商品信息。两个端点均支持多区域定向、货币本地化和设备模拟。

端点

端点	描述
`POST /api/v1/amazon/search`	搜索 Amazon 商品，支持排序、分页和分类筛选
`POST /api/v1/amazon/product`	通过 ASIN 获取详细商品信息

身份验证

Header	值	必填
`Authorization`	`Bearer YOUR_API_KEY`	是
`Content-Type`	`application/json`	是

商品搜索

Bash

POST https://api.scavio.dev/api/v1/amazon/search

搜索 Amazon 商品并获取结构化结果，包括价格、评分和商品详情。

请求体

参数	类型	默认值	描述
`query`	`string`	--	必填。搜索查询（1-500 字符）。
`domain`	`string`	`com`	Amazon 域名后缀（如 `com`、`co.uk`、 `de`、`fr`、`co.jp`）。
`sort_by`	`string`	--	排序方式。可选值：`most_recent`、 `price_low_to_high`、`price_high_to_low`、 `featured`、`average_review`、 `bestsellers`
`start_page`	`integer`	`1`	起始页码（从 1 开始）。
`pages`	`integer`	`1`	返回的页数。
`category_id`	`string`	--	Amazon 分类/部门 ID，用于缩小结果范围。
`merchant_id`	`string`	--	按特定 Amazon 商家筛选。
`country`	`string`	--	本地化的国家代码。
`language`	`string`	--	结果的语言代码。
`currency`	`string`	--	ISO 4217 货币代码（如 `USD`、`EUR`、 `GBP`）。
`device`	`string`	`desktop`	设备类型。可选值：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	邮政编码，用于获取本地化的价格和库存信息。
`autoselect_variant`	`boolean`	--	自动选择默认商品变体。

示例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

响应示例

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

商品详情

Bash

POST https://api.scavio.dev/api/v1/amazon/product

通过 ASIN 获取特定 Amazon 商品的详细信息。返回价格、描述、规格、图片、评分和卖家信息。

请求体

参数	类型	默认值	描述
`query`	`string`	--	必填。 Amazon ASIN（如 `B09XS7JWHH`）。
`domain`	`string`	`com`	Amazon 域名后缀（如 `com`、`co.uk`、 `de`）。
`country`	`string`	--	本地化的国家代码。
`language`	`string`	--	结果的语言代码。
`currency`	`string`	--	ISO 4217 货币代码（如 `USD`、`EUR`）。
`device`	`string`	`desktop`	设备类型。可选值：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	邮政编码，用于获取本地化价格。
`autoselect_variant`	`boolean`	--	自动选择默认商品变体。

示例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

响应示例

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

支持的域名

使用 domain 参数来指定特定的 Amazon 市场：

域名	市场
`com`	美国
`co.uk`	英国
`de`	德国
`fr`	法国
`co.jp`	日本
`ca`	加拿大
`it`	意大利
`es`	西班牙
`in`	印度
`com.au`	澳大利亚
`com.br`	巴西
`com.mx`	墨西哥

响应格式

两个端点返回一致的响应包装结构：

字段	类型	描述
`data`	`object \| null`	响应载荷。如果上游请求失败则为 `null`。搜索返回 `{page, products, html}`；商品详情直接返回商品对象。
`response_time`	`number`	服务端响应时间（毫秒）
`credits_used`	`number`	消耗的积分数量
`credits_remaining`	`number`	当前计费周期剩余积分

错误响应

状态码	描述
`401`	未授权 -- API 密钥缺失或无效
`429`	超出当前套餐的速率或用量限制
`502`	上游错误 -- 请稍后重试
`503`	上游不可用 -- 请稍后重试

参阅错误参考获取完整的错误说明和重试最佳实践。

Amazon API

端点

身份验证

商品搜索

请求体

示例

响应示例

商品详情

请求体

示例

响应示例

支持的域名

响应格式

错误响应

相关文档

Amazon API

端点

身份验证

商品搜索

请求体

示例

响应示例

商品详情

请求体

示例

响应示例

支持的域名

响应格式

错误响应

相关文档