SeerMarTech API 文档

主题

merchant/amazon/asin/live/advanced ​

POST /v3/merchant/amazon/asin/live/advanced

Live Amazon ASIN Advanced ​

POST https://api.seermartech.cn/v3/merchant/amazon/asin/live/advanced

本接口根据指定的 Amazon ASIN，返回该产品不同变体对应的完整 ASIN 列表，并提供产品信息、价格区间、评分、分类、产品以及本地和评论等数据。

所有请求体使用 UTF-8 编码的 JSON 格式，并以 JSON 数组提交。每次调用只能一个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准。

认证方式 ​

请求头中使用 Bearer Token：

http
Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

计费说明 ​

本接口按任务提交计费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

请求体格式：

json
[
  {
    "asin": "B0756FCPPN",
    "location_name": "United States",
    "language_name": "English (United States)"
  }
]

任务参数 ​

参数类型填说明
asinstring是Amazon 产品唯一标识符（ASIN）。可通过 /v3/merchant/amazon/products/live/advanced 获取。
location_namestring条件填搜索位置的完整名称。当未指定 location_code 或 location_coordinate 时填。使用该参数后，无需再传另外两个位置参数。可通过 https://api.seermartech.cn/v3/merchant/amazon/locations 获取可用位置。示例：HA1,England,United Kingdom
location_codeinteger条件填搜索位置代码。当未指定 location_name 或 location_coordinate 时填。示例：9045969
location_coordinatestring条件填GPS 坐标，格式为 "纬度,经度,半径"。纬度和经度最多 7 位小数，半径最小值为 199.9。示例：53.476225,-2.243572,200
language_namestring条件填搜索语言的完整名称。当未指定 language_code 时填。可通过 https://api.seermartech.cn/v3/merchant/amazon/languages 获取可用语言。示例：English (United Kingdom)
language_codestring条件填搜索语言代码。当未指定 language_name 时填。示例：en_GB
se_domainstring否Amazon 站点域名。平台会根据位置和语言自动选择对应域名，也可以手动指定，例如 amazon.com、amazon.co.uk、amazon.fr。
tagstring否用户自定义任务标识，最长 255 个字符。可用于任务与结果，该值会原样返回在响应的 data 对象中。

> location_name、location_code、location_coordinate 三只能选择一。
> language_name 和 language_code 二只能选择一。

响应结构 ​

接口返回 JSON 对象 tasks 任务数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用响应状态码。成功时通常为 20000。
status_messagestring通用状态说明。
timestring接口执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

任务字段 ​

字段类型说明
idstring任务唯一标识符，UUID 格式。
status_codeinteger任务状态码，通常在 10000 至 60000 范围。
status_messagestring任务状态说明。
timestring任务执行耗时。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharray请求 URL 路径信息。
dataobject创建任务时提交的参数。
resultarray任务结果数组。

结果字段 ​

结果概览 ​

字段类型说明
asinstring请求中提交的 ASIN。
typestring搜索引擎结果类型，可能为 asin。
se_domainstringAmazon 站点域名。
location_codeinteger位置代码。
language_codestring语言代码。
check_urlstringAmazon 结果页面的直接 URL，可用于核验返回数据。
datetimestring数据获取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
spellobject搜索引擎自动纠错信息。
item_typesarray返回结果中的结果类型，可能 amazon_product_info。
items_countintegeritems 数组中的产品数量。
itemsarray产品信息数组。

产品信息项 ​

items 中的产品信息项通常以下字段：

字段类型说明
typestring素类型，固定为 amazon_product_info。
rank_groupinteger在相同 type素组的排名。不同类型不会计该字段。
rank_absoluteinteger在结果中的绝对排名。
positionstring在 Amazon 结果页中的对齐方式，可为 left 或 right。
xpathstring结果在页面中的 XPath。
titlestring产品标题。
detailsstring产品规格及。
image_urlstring产品主图 URL。
authorstring产品品牌或店铺名称。
data_asinstring结果产品的 ASIN。
parent_asinstring产品父 ASIN。
product_asinsarray检测到的所有产品变体 ASIN。
price_fromfloat产品价格区间下限，例如 49.98。
price_tofloat产品价格区间上限，例如 384.99。
percentage_discountfloat折扣百分比。
currencystring价格货币代码，采用 ISO 4217 格式，例如 USD。
is_amazon_choiceboolean是否带有 Amazon's Choice 标签。
ratingobject产品评分信息。
is_newer_model_availableboolean是否存在更新型号。
is_prime_videoboolean是否带有 Amazon Prime Video 标签。
applicable_vouchersarray/null当前适用的优惠券信息。
newer_modelobject/null更新型号信息。
categoriesarray产品所属分类。
product_informationarray产品详细信息。
product_images_listarray产品主图左侧展示的图片 URL。
product_videos_listarray/null产品主视频右侧展示的视频 URL。
descriptionstring产品描述。
is_availableboolean产品是否可下单。

rating 评分对象 ​

字段类型说明
typestring素类型，固定为 rating_element。
positionstring在结果页中的对齐方式，可为 left 或 right。
rating_typestring评分类型，可为 Max5、Percents 或 CustomMax。
valuestring/float评分值。
votes_countinteger评分或反馈数量。
rating_maxstring/integer当前评分类型的最大值。

applicable_vouchers 优惠券数组 ​

字段类型说明
typestring素类型，可能为 amazon_applicable_vouchers_item。
textstring优惠券文本。
fixed_discountfloat固定金额折扣。
fixed_discount_currencystring固定金额折扣的货币代码。
percentage_discountfloat百分比折扣。若为固定金额折扣，则为 null。
important_detailsstring优惠券使用条件及重要说明。

newer_model 更新型号对象 ​

字段类型说明
titlestring更新型号的产品标题。
newer_model_asinstring更新型号的 ASIN。

categories 分类数组 ​

字段类型说明
categorystring产品分类名称。
urlstring产品分类 URL，表示 Amazon 上唯一浏览节点 ID 的分类路径。

产品详细信息 ​

product_information ​

该数组产品页面上的扩展信息和信息。

字段类型说明
typestring素类型，可能为 product_information_extended_item 或 product_information_details_item。
section_namestring产品信息所属章节名称。
contentsarray章节中的，适用于 product_information_extended_item。
bodyobject章节中的详细键值信息，适用于 product_information_details_item。

contents数组 ​

字段类型说明
typestring类型，可能为 product_information_rows。
titlestring产品信息在页面中显示的标题。
rowsarray该标题下的信息行。

rows 信息行 ​

信息行的 type 及字段如下：

type字段说明
product_information_text_rowtext指定章节和标题下的文本。
product_information_image_rowalt、url产品图片的替代文本和图片 URL。
product_information_video_rowpreview、url视频预览图 URL 和视频 URL。

评论字段 ​

接口分别返回目标位置的热门评论和热门评论。

字段类型说明
top_local_reviewsarray目标位置的热门评论。
top_global_reviewsarray热门评论。

评论对象字段如下：

字段类型说明
typestring素类型，固定为 amazon_review_item。
rank_groupinteger相同类型评论组的排名。
rank_absoluteinteger在评论中的绝对排名。
positionstring评论在结果页中的位置，通常为 right 或 left。
xpathstring评论的 XPath。
verifiedboolean是否带有“已验证购买”标记。
subtitlestring评论副标题，通常评论地点和日期。
helpful_votesinteger“有帮助”投票数量。
imagesarray/null评论中提交的图片。
videosarray/null评论中提交的视频。
user_profileobject评论用户资料。
titlestring评论标题。
urlstring评论 URL。
review_textstring评论正文。
publication_datestring评论发布时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
ratingobject评论提交的评分。

评论图片与视频 ​

images ​

字段类型说明
typestring素类型，固定为 images_element。
altstring图片替代文本。
urlstring图片 URL。
image_urlstring评论中展示的产品图片 URL。

videos ​

字段类型说明
typestring素类型，固定为 video_element。
sourcestring视频源 URL。
previewstring视频预览图 URL。

user_profile 用户资料 ​

字段类型说明
namestring用户名称。
avatarstring用户头像 URL。
urlstring用户资料页 URL。
reviews_countinteger用户评论数量。
locationsstring用户所在位置或国家/地区代码。

评论评分对象 ​

字段类型说明
rating_typestring评分类型，评论评分通常为 Max5。
valuefloat评分值。
votes_countinteger/null反馈数量；评论评分场景下通常为 null。
rating_maxinteger评分最大值，Max5 类型通常为 5。

请求示例 ​

cURL ​

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

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

# 每次调用只能提交一个任务
payload = [
    {
        "location_name": "United States",
        "language_name": "English (United States)",
        "asin": "B0756FCPPN",
    }
]

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

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "错误。状态码：%s，消息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript ​

typescript
import axios from "axios";

const response = await axios.post(
  "https://api.seermartech.cn/v3/merchant/amazon/asin/live/advanced",
  [
    {
      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);

响应示例 ​

以下示例展示主要响应结构，部分数组已省略：

json
{
  "version": "0.1.20260610",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "43.1209 sec.",
  "cost": 0.005,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "43.1209 sec.",
      "cost": 0.005,
      "result_count": 1,
      "path": [
        "v3",
        "merchant",
        "amazon",
        "asin",
        "live",
        "advanced"
      ],
      "data": {
        "api": "merchant",
        "function": "asin",
        "se": "amazon",
        "language_code": "en_US",
        "location_code": 2840,
        "asin": "B0756FCPPN",
        "se_type": "asin",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "items_count": 1,
          "items": [
            {
              "type": "amazon_product_info",
              "title": "Skechers Classic Fit-Delson-Camden Shoe",
              "details": "Product details ...",
              "image_url": "https://m.media-amazon.com/images/I/711cGcmnZqL._AC_SX395_SY395_QL70_FMwebp_.jpg",
              "author": "Visit the Skechers Store",
              "data_asin": "B0756FCPPN",
              "parent_asin": "B07568JYPN",
              "product_asins": [],
              "price_from": 49.99,
              "price_to": 61.01,
              "percentage_discount": 18,
              "currency": "USD",
              "is_amazon_choice": false,
              "rating": {
                "type": "rating_element",
                "position": "left",
                "rating_type": "Max5",
                "value": 4.6,
                "votes_count": 38769,
                "rating_max": 5
              },
              "is_newer_model_available": false,
              "is_prime_video": false,
              "applicable_vouchers": null,
              "newer_model": null,
              "categories": [],
              "product_information": [],
              "product_images_list": [],
              "product_videos_list": null,
              "description": "Product description ...",
              "is_available": true,
              "top_local_reviews": [],
              "top_global_reviews": []
            }
          ]
        }
      ]
    }
  ]
}

状态码与错误处理 ​

请根据顶层 status_code 和任务级 status_code 判断请求是否成功：

  • 20000：请求成功。
  • 状态码：请求或任务处理失败，应结合 status_message 定位原因。
  • tasks_error：表示返回错误的任务数量。

建议客户端对网络异常、鉴权失败、参数错误、任务处理失败和空结果进行分别处理，并记录 id、status_code、status_message 便于排查。

实用场景 ​

  • 识别产品变体 ASIN：获取同一产品不同颜色、尺码或对应的 ASIN，完善 Amazon 商品目录和变体。
  • 监控竞品价格区间：采集 price_from、price_to 和折扣信息，评估竞品定价与促销策略，动态调价。
  • 分析产品评价表现：汇总评分、投票数及本地/热门评论，提炼用户反馈，支持产品改进和优化。
  • 核验商品可售状态：结合 is_available、产品和站点信息，监测目标市场的库存或下单可用性。
  • 完善商品 SEO 素材：利用产品标题、、分类、图片、视频和描述字段，优化商品页、结构化数据与站搜索展示。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API