Amazon ASIN 实时 HTML

POST /v3/merchant/amazon/asin/live/html

接口说明

该接口用于获取指定 Amazon 商品 ASIN 对应页面的 HTML 原始。

请求方式：POST
接口地址：https://api.seermartech.cn/v3/merchant/amazon/asin/live/html

该接口返回 JSON 结构 result.items[].html含抓取到的页面 HTML。

计费与调用限制

本接口按任务提交计费在成功设置任务时扣费。
参考价约 ¥0.0800 / 次
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
所有 POST 数据需使用 JSON（UTF-8 编码）。
请求体格式为 JSON 数组：[{ ... }]
每分钟最多可发送 2000 次 API 调用。
每次 Live 请求只能提交 1 个任务。

请求参数

以下字段用于设置任务。

字段名	类型	说明
`asin`	string	商品 ID，填。即 Amazon 商品唯一标识 ASIN。可通过 `/v3/merchant/amazon/products/task_post/` 获取。
`location_name`	string	搜索位置完整名称。当未提供 `location_code` 或 `location_coordinate` 时填。使用该字段时，无需再传 `location_code` 或 `location_coordinate`。可通过 `https://api.seermartech.cn/v3/merchant/amazon/locations` 获取可用位置列表。示例：`HA1,England,United Kingdom`
`location_code`	integer	搜索位置代码。当未提供 `location_name` 或 `location_coordinate` 时填。使用该字段时，无需再传 `location_name` 或 `location_coordinate`。可通过 `https://api.seermartech.cn/v3/merchant/amazon/locations` 获取可用位置列表。示例：`9045969`
`location_coordinate`	string	GPS 坐标。当未提供 `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`。可通过 `https://api.seermartech.cn/v3/merchant/amazon/languages` 获取可用语言列表。示例：`English (United Kingdom)`
`language_code`	string	搜索语言代码。当未提供 `language_name` 时填。使用该字段时，无需再传 `language_name`。可通过 `https://api.seermartech.cn/v3/merchant/amazon/languages` 获取可用语言列表。示例：`en_GB`
`se_domain`	string	搜索引擎域名，可选。本平台会根据位置和语言自动选择合适域名，也可手动指定，如 `amazon.com`、`amazon.co.uk`、`amazon.fr`。
`tag`	string	自定义任务标识，可选，最大 255 个字符。可用于请求结果匹，响应中的 `data` 对象会返回该值。

返回结果说明

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

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码。完整错误码见 `/v3/appendix/errors`
`status_message`	string	通用状态信息。完整说明见 `/v3/appendix/errors`
`time`	string	执行耗时，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`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	URL 路径
`data`	object	与 POST 请求中提交的参数一致
`result`	array	结果数组

`result[]` 字段

字段名	类型	说明
`product_id`	string	POST 请求中传的 ASIN
`type`	string	POST 请求中的搜索引擎类型
`se_domain`	string	POST 请求中的搜索域名
`location_code`	integer	POST 请求中的位置代码
`language_code`	string	POST 请求中的语言代码
`datetime`	string	获取结果的时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2019-11-15 12:57:46 +00:00`
`items_count`	integer	`items` 数组中的结果数量
`items`	array	HTML 页面及数据

`items[]` 字段

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

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/merchant/amazon/asin/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

python

import requests

url = "https://api.seermartech.cn/v3/merchant/amazon/asin/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, headers=headers, json=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

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

 console.log(response.data);
}

fetchAmazonAsinHtml.catch(console.error);

响应示例

json

{
 "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": "asin",
 "se": "amazon",
 "language_code": "en_US",
 "location_code": 2840,
 "asin": "B0756FCPPN",
 "se_type": "asin",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {}
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整个请求的处理状态。
tasks[].status_code 表示单个任务的执行状态。
建议同时校验顶层状态码与任务状态码，并为异常、限流、参数错误、抓取失败等设计重试或底逻辑。
完整错误码可参考：/v3/appendix/errors

使用说明

按 JSON 数组格式提交请求体。
每次请求提交一个任务。
至少提供一种位置参数：location_name、location_code、location_coordinate 三选一。
至少提供一种语言参数：language_name、language_code 二选一。
返回结果中的 items[].html 为页面原始 HTML，可用于后续解析、结构化抽取或页面审计。

实用场景

抓取商品页原始 HTML，用于解析标题、卖点、评分、评论数、价格区块等页面，支撑商品页 SEO 与监控。
监控不同国家站点的页面差异，比较同一 ASIN 在不同地区的文案、展示模块和结构变化，跨境电商本地化优化。
校验页面抓取可用性，通过定时获取 HTML 判断商品页是否下架、跳转、异常加载或缺失，提升商品监控效率。
提取页面模块变化，识别 A+、广告位、推荐位、信息等区块调整，为竞品分析和页面改版跟踪提供依据。
结合自定义解析规则，将 HTML库后进行结构化抽取，构建商品历史快，支持回溯与异常比对。

Amazon ASIN 实时 HTML ​

接口说明 ​

计费与调用限制 ​

请求参数 ​

返回结果说明 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

items[] 字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用说明 ​

实用场景 ​

Amazon ASIN 实时 HTML

接口说明

计费与调用限制

请求参数

返回结果说明

顶层字段

`tasks[]` 字段

`result[]` 字段

`items[]` 字段

请求示例

cURL

Python

TypeScript

响应示例

状态码与错误处理

使用说明

实用场景