电商零售可调用

Amazon Product Search

Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.

查看每个接口的请求示例、参数和单次价格。一个 API Key 即可调用全部接口，账户限额适用。

API 参考文档在 Playground 中调用

要点

接口地址: POST https://api.serpbase.dev/amazon/search
价格: 2 积分 / 请求
鉴权方式: X-API-Key
返回类型: schemas.source_data

API 地址与计费规则

POSThttps://api.serpbase.dev/amazon/search

单次调用扣费

2 积分 / 请求

每请求按目录固定价格计费，不按返回页数计费。Web Crawl 和 User Agent 当前均为每请求 1 积分；User Agent 并非免费。有来源和资源身份依据的真实不存在结果正常收费。仅有 no_results、HTTP 404 或缺少 hydration/解析数据不能证明不存在。目前已执行的失败可能扣费，并非所有失败都保证退款。credits_charged 表示实际扣费：0 表示报告为零，null 或缺失表示未知。charge_status 为 UNKNOWN 时即使有扣费数值也仍是未知。请核对账户记录并提供 request_id 联系支持，不要假定已退款或盲目重试。

请求参数示例

示例不是完整参数列表或必填规则。已知字段会被校验，额外参数允许传入。

请求参数示例
参数	示例类型	示例值
domain	string	"amazon.com"
q	string	"wireless headphones"

JSON

{
  "domain": "amazon.com",
  "q": "wireless headphones"
}

示例不是完整参数列表或必填规则。已知字段会被校验，额外参数允许传入。
兼容写法	参数	类型
amazon_domain	domain	string
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
type	search_type	string

支持设备：desktop；默认：desktop。

调用示例

cURL

curl -X POST 'https://api.serpbase.dev/amazon/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"domain":"amazon.com","q":"wireless headphones"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/amazon/search", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"domain\":\"amazon.com\",\"q\":\"wireless headphones\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

响应与调用结果

响应为 JSON。HTTP 200 不代表搜索成功，请检查 status 和 error。字段取决于产品契约和上游数据。

查看响应说明

常见问题

Amazon Product Search API 怎么收费？

每次请求消耗 2 积分。积分来自预付积分包或月度套餐，新账号自带免费积分。

如何调用 Amazon Product Search API？

向 https://api.serpbase.dev/amazon/search 发送 POST 请求，并在 X-API-Key 请求头中带上你的 API Key。返回 JSON，请检查 status（0 表示成功）。

支持哪些设备？

支持的设备：desktop，默认 desktop。

Amazon Product Search API 现在可以用吗？

可以，任何有效的 API Key 都能调用。