Amazon 卖家页面 HTML 实时结果

接口说明

该接口用于实时获取 Amazon 卖家页面的 HTML 结果，返回为原始 HTML。

注意：调用本接口前，拿到商品的 asin。你可以调用 /v3/merchant/amazon/products/task_post 获取对应商品的 asin 值。

接口支持两种任务优级，对应不同的执行速度：

• normal：普通优级
• high：高优级

请求地址

POST https://api.seermartech.cn/v3/merchant/amazon/sellers/live/html

计费说明

该接口按任务提交计费在成功创建任务时扣费。

参考价约 ¥0.0800 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求规则

• 请求方法：POST
• 请求体格式：JSON 数组 [{ ... }]
• 编码：UTF-8
• 实时接口每次调用支持 1 个任务
• 接口速率上限：2000 次 API 调用/分钟

---

请求参数

任务参数说明

字段名	类型	说明
asin	string	Amazon 商品唯一标识。填。可通过 /v3/merchant/amazon/products/task_post 单独查询获得。asin 为平台动态分值，没有固定枚举。示例：B085RFFC9Q
location_name	string	地区名。当未提供 location_code 或 location_coordinate 时填。如果使用该字段，则无需传 location_code 和 location_coordinate。可通过 /v3/merchant/amazon/locations 获取可用地区列表。示例：London,England,United Kingdom
location_code	integer	地区编码。当未提供 location_name 或 location_coordinate 时填。如果使用该字段，则无需传 location_name 和 location_coordinate。可通过 /v3/merchant/amazon/locations 获取可用地区编码。示例：2840
location_coordinate	string	地理坐标。当未提供 location_name 或 location_code 时填。如果使用该字段，则无需传 location_name 和 location_code。格式为 "latitude,longitude,radius"。 latitude、longitude 最多支持 7 位小数，radius 最小值为 199.9。示例：53.476225,-2.243572,200
language_name	string	语言名。当未提供 language_code 时填。如果使用该字段，则无需传 language_code。可通过 /v3/merchant/amazon/languages 获取可用语言列表。示例：English (United States)
language_code	string	语言编码。当未提供 language_name 时填。如果使用该字段，则无需传 language_name。可通过 /v3/merchant/amazon/languages 获取可用语言编码。示例：en_US
se_domain	string	搜索域名。可选。默认会根据你指定的地区和语言自动选择对应域名，也可以手动指定。示例：amazon.co.uk、amazon.com.au、amazon.de
tag	string	自定义任务标识。可选，最长 255 个字符。可用于业务侧请求与返回结果，响应中的 data 对象会返回该值。

---

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段说明

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码。完整错误码请参考 /v3/appendix/errors。建议业务侧做好异常与错误处理
status_message	string	通用状态信息
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务结果数组

tasks[] 字段说明

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000，完整列表参考 /v3/appendix/errors
status_message	string	任务状态说明
time	string	任务执行耗时，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组数量
path	array	请求路径
data	object	你在 POST 中提交的参数回显
result	array	结果数组

result[] 字段说明

字段名	类型	说明
asin	string	请求中传的 ASIN
type	string	请求中的搜索引擎类型
se_domain	string	请求中的搜索域名
location_code	integer	请求中的地区编码
language_code	string	请求中的语言编码
datetime	string	获取结果的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
items_count	integer	items 数组中的结果数量
items	array	Amazon 页面结果项

items[] 字段说明

字段名	类型	说明
page	integer	返回的 HTML 页序号
date	string	抓取该 HTML 页的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
html	string	页面原始 HTML

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/merchant/amazon/sellers/live/html" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/merchant/amazon/sellers/live/html"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN"
 }
]

response = requests.post(url, json=data, headers=headers)
result = response.json

if result.get("status_code") == 20000:
 print(result)
else:
 print(f"error. Code: {result.get('status_code')} Message: {result.get('status_message')}")

TypeScript

import axios from "axios";

async function fetchAmazonSellersHtml {
 const response = await axios.post(
 "https://api.seermartech.cn/v3/merchant/amazon/sellers/live/html",
 [
 {
 location_name: "United States",
 language_name: "English (United States)",
 asin: "B0756FCPPN"
 }
 ],
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
 }
 );

 const result = response.data;

 if (result.status_code === 20000) {
 console.log(result);
 } else {
 console.error(`error. Code: ${result.status_code} Message: ${result.status_message}`);
 }
}

fetchAmazonSellersHtml;

---

响应示例

{
 "version": "0.1.20260520",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "15.1520 sec.",
 "cost": 0.005,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "merchant",
 "function": "sellers",
 "se": "amazon",
 "language_code": "en_US",
 "location_code": 2840,
 "asin": "B0756FCPPN",
 "se_type": "sellers",
 "device": "desktop",
 "os": "windows"
 },
 "result": []
 }
 ]
}

---

状态码与错误处理

• 顶层 status_code 表示整个请求的执行状态
• tasks[].status_code 表示单个任务的执行状态
• 建议同时校验：
• HTTP 状态码
• 顶层 status_code
• 任务级 tasks[].status_code

常见成功状态：

• 20000：成功

完整错误码与状态信息请参考 /v3/appendix/errors。

---

使用建议

1. 查 ASIN 再抓卖家页 HTML 本接口不负责商品识别，通过 /v3/merchant/amazon/products/task_post 获取有效 asin。

2. 地区与语言建议成对指定 这样更容易命中正确的 Amazon 站点与本地化页面。

3. 在需要页面原始结构时使用本接口 如果你只心结构化字段，建议优使用非 HTML 类接口；如果你需要页面模板、模块布局、卖家区块原文或后续自定义解析，则使用本接口更合适。

实用场景

• 抓取卖家页面原始 HTML：获取 Amazon 卖家模块的完整页面源码，用于自定义解析 Buy Box、卖家列表、信息等字段。
• 监控不同地区卖家展示差异：按国家、语言或坐标抓取页面，识别本地化卖家排序、承诺和可售状态差异。
• 复盘页面结构变化：保存历史 HTML 快，追踪平台页面模板调整，降低解析规则失效风险。
• 构建竞品卖家监测流程：基于指定 ASIN 周期性拉取卖家页面，分析第三方卖家分布与价格竞争环境。
• 校验结构化抽取结果：将 HTML 原文作为审计依据，对解析结果进行排错与质量验收。