SeerMarTech API 文档

主题

获取 Amazon Sellers 高级结果（按任务 ID） ​

本接口用于根据任务 ID 获取 Amazon 商品卖家列表结果。返回的数据每个卖家的商品状态、价格、信息、评分等。

接口说明 ​

  • 请求方式：GET
  • 接口地址：https://api.seermartech.cn/v3/merchant/amazon/sellers/task_get/advanced/$id

计费说明 ​

该类任务在创建任务时扣费，任务结果在后续 30 天可反复获取。

由于本接口为取回已完成任务结果接口，通常本次请求返回中的 cost 可能为 0。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

路径参数 ​

字段名类型说明
idstring任务唯一标识，UUID 格式。在任务创建后，可在 30 天随时通过该 ID 获取结果。

沙箱调试 ​

你可以通过以下沙箱地址查看该接口可返回的完整字段结构，返回为模拟数据，不会扣费：

https://api.seermartech.cn/v3/merchant/amazon/sellers/task_get/advanced/00000000-0000-0000-0000-000000000000

返回结构 ​

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

顶层字段 ​

字段名类型说明
versionstring当前 API 版本。
status_codeinteger通用状态码。建议接时做好异常和错误处理。
status_messagestring通用状态说明。
timestring执行耗时，单位秒。
costfloat本次请求总成本，单位 USD。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

tasks[] 字段 ​

字段名类型说明
idstring任务 ID，UUID 格式。
status_codeinteger任务状态码，范围通常为 10000-60000。
status_messagestring任务状态信息。
timestring任务执行耗时，单位秒。
costfloat当前任务成本，单位 USD。
result_countintegerresult 数组中的结果数量。
patharray请求路径。
dataobject与创建任务时传参数一致的数据对象。
resultarray结果数组。

tasks[].result[] 字段 ​

字段名类型说明
asinstringPOST 创建任务时传的 asin。
typestring搜索类型，固定为 sellers_list。
se_domainstring创建任务时指定的搜索引擎域名。
location_codeinteger创建任务时指定的位置编码。
language_codestring创建任务时指定的语言编码。
check_urlstringAmazon 结果直达链接，可用于人工校验结果。
datetimestring结果抓取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
titlestring对应 asin 的商品标题。
imagestring对应商品图片 URL。
item_typesarray当前结果页中出现的卖家结果类型列表。
items_countintegeritems 数组中的结果数量。
itemsarray卖家列表明细。

item_types 可选值 ​

  • amazon_seller_main_item
  • amazon_seller_item

items[] 字段说明 ​

items[] 中的可能为以下两类：

  • amazon_seller_main_item
  • amazon_seller_item

两类字段结构基本一致，含义如下。

字段名类型说明
typestring素类型，可能为 amazon_seller_main_item 或 amazon_seller_item。
rank_groupinteger在相同 type素组的位置。不同类型之间不用该排序。
rank_absoluteinteger在整个卖家结果页中的绝对位置。
positionstring素在页面中的位置，可选值：left、right。
xpathstring当前在页面中的 XPath。
seller_namestring卖家名称。
seller_urlstring跳转到 Amazon 卖家页的链接。
ships_fromstring发货方名称。
priceobject商品价格信息；若无则为 null。
ratingobject卖家评分信息。
conditionstring商品状态，如 New。
condition_descriptionstring商品状态补说明。
delivery_infoobject送信息。

price 字段 ​

字段名类型说明
currentfloat当前成交价/折后价。
regularfloat原价/未折扣价格。
max_valuefloat展示价格中的最大值。
currencystring货币代码，ISO 4217 格式，如 USD。
is_price_rangeboolean是否以价格区间形式展示。
displayed_pricestring页面展示的原始价格文本。
percentage_discountfloat百分比折扣值。
applicable_vouchersarray可用优惠券信息数组。

applicable_vouchers[] 字段 ​

字段名类型说明
typestring素类型，固定为 amazon_applicable_vouchers_item。
textstring优惠券文案。
fixed_discountfloat固定金额优惠值。
fixed_discount_currencystring固定优惠金额对应币种。
percentage_discountfloat百分比优惠值；若为固定金额优惠则可能为 null。
important_detailsstring优惠券适用条件等重要说明。

rating 字段 ​

字段名类型说明
typestring素类型，固定为 rating_element。
rating_typestring评分类型，目前可见值如 Max5。
valuestring当前评分值。
votes_countinteger评价/反馈数量。
rating_maxinteger当前评分体系下的满分值。

delivery_info 字段 ​

字段名类型说明
delivery_date_fromstring最早送达日期。
delivery_date_tostring最晚送达日期。
fastest_delivery_date_fromstring最快方式下的最早送达日期。
fastest_delivery_date_tostring最快方式下的最晚送达日期。
delivery_messagestring页面展示的说明文本。
delivery_priceobject送费用；若支持运费则通常为 null。

delivery_price 字段 ​

字段名类型说明
currentfloat当前价格。
regularfloat原始价格。
max_valuefloat最高价格。
currencystring货币代码，ISO 4217 格式。
is_price_rangeboolean是否为价格区间。
displayed_pricestring页面展示的价格文本。

请求示例 ​

cURL ​

bash
id="04171157-0696-0183-0000-4f63affdd40a"

curl --location --request GET "https://api.seermartech.cn/v3/merchant/amazon/sellers/task_get/advanced/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw ""

Python ​

python
import requests

task_id = "04171157-0696-0183-0000-4f63affdd40a"
url = f"https://api.seermartech.cn/v3/merchant/amazon/sellers/task_get/advanced/{task_id}"

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

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json)

TypeScript ​

typescript
import axios from "axios";

const taskId = "02231453-2604-0066-2000-64d39c6677d4";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/merchant/amazon/sellers/task_get/advanced/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
})
 .then((response) => {
 // 返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

获取已完成任务后再获取结果 ​

通常建议调用已完成任务列表接口，再根据返回的任务 ID 或结果地址拉取：

  • GET /v3/merchant/amazon/sellers/tasks_ready
  • GET /v3/merchant/amazon/sellers/task_get/advanced/$id

Python 示例：取 ready 任务，再取结果 ​

python
import requests

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

# 1. 获取已完成任务
ready_resp = requests.get(
 "https://api.seermartech.cn/v3/merchant/amazon/sellers/tasks_ready",
 headers=headers
)

ready_data = ready_resp.json

results = []

if ready_data.get("status_code") == 20000:
 for task in ready_data.get("tasks", []):
 for item in task.get("result", []) if task.get("result") else []:
 endpoint = item.get("endpoint_advanced")
 task_id = item.get("id")

 # 2. 方式一：直接请求返回的 endpoint_advanced
 if endpoint:
 detail_resp = requests.get(
 f"https://api.seermartech.cn{endpoint}" if endpoint.startswith("/v3/") else endpoint,
 headers=headers
 )
 results.append(detail_resp.json)

 # 3. 方式二：按任务 ID 拼接查询地址
 # if task_id:
 # detail_resp = requests.get(
 # f"https://api.seermartech.cn/v3/merchant/amazon/sellers/task_get/advanced/{task_id}",
 # headers=headers
 # )
 # results.append(detail_resp.json)

print(results)

响应示例 ​

json
{
 "version": "0.1.20250812",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0779 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "sellers",
 "se": "amazon",
 "api": "merchant",
 "function": "sellers",
 "language_code": "en_US",
 "location_code": 9004056,
 "asin": "B07D528W98",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "items_count": 2,
 "items": [
 {
 "seller_name": "MASOU",
 "seller_url": "http://amazon.com/gp/aag/main?ie=UTF8&seller=A2XS9KO5PUQHMV&isAmazonFulfilled=1&asin=B07D528W98&ref_=olp_merch_name_1",
 "ships_from": "Amazon.com",
 "price": {
 "current": 399.99,
 "regular": null,
 "max_value": null,
 "currency": "USD",
 "is_price_range": false,
 "displayed_price": "$399.99"
 },
 "percentage_discount": null,
 "applicable_vouchers": null,
 "rating": {
 "type": "rating_element",
 "position": "left",
 "rating_type": "Max5",
 "value": 5,
 "votes_count": 3619,
 "rating_max": 5
 },
 "condition": "New",
 "condition_description": null,
 "delivery_info": {
 "delivery_date_from": "2025-09-01T00:00:00+00:00",
 "delivery_date_to": null,
 "fastest_delivery_date_from": "2025-08-29T00:00:00+00:00",
 "fastest_delivery_date_to": null,
 "delivery_message": "FREE delivery Monday, September 1 Or Prime members get FREE delivery Friday, August 29. Order within 14 hrs 51 mins. Join Prime",
 "delivery_price": null
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理 ​

  • 顶层 status_code 表示本次 API 请求总体状态。
  • tasks[].status_code 表示任务状态。
  • 建议同时校验：
  • HTTP 状态码
  • 顶层 status_code
  • tasks[].status_code
  • result 是否为空

当 tasks[].status_code 大于等于 40000，或 result 为空时，通常应按失败任务处理并记录错误信息。

使用说明 ​

  1. 通过对应的 POST 接口提交 Amazon sellers 采集任务。
  2. 通过 GET /v3/merchant/amazon/sellers/tasks_ready 查询已完成任务。
  3. 使用本接口按任务 ID 获取高级结果。
  4. 在任务创建后的 30 天，可重复获取结果且通常不会重复扣费。

实用场景 ​

  • 监控卖家竞争格局：按 ASIN 拉取当前卖家列表，识别主卖家、跟卖商家和发货方变化，帮助运营及时发现竞争加剧或 Buy Box 外围卖家增加。
  • 分析价格与优惠策略：提取卖家价格、折扣、优惠券信息，评估不同卖家的定价方式，为调价、促销和利润控制提供依据。
  • 评估时效表现：抓取最早送达时间、最快时间和运费信息，对比不同卖家的履约能力，优化仓与区域供给策略。
  • 筛选高质量卖家样本：结合评分、评价数、商品成色和承诺，建立卖家质量画像，用于招商、渠道监控或竞品研究。
  • 校验商品页销售环境：通过 check_url 和卖家明细回溯指定 ASIN 的销售页面状态，便于质检、异常排查和数据复核。

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

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