SeerMarTech API 文档

主题

按任务 ID 获取 Amazon 商品高级结果 ​

GET /v3/merchant/amazon/products/task_get/advanced/{id}

接口说明 ​

用于根据任务 ID 获取 Amazon 商品搜索任务的高级结果。

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

该接口用于获取已创建任务的结果。费用只在创建任务时产生；任务结果在生成后的 30 天可重复获取，不额外收费。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

路径参数 ​

参数类型说明
idstring任务唯一标识符，UUID 格式。可在任务创建后的 30 天随时用于请求结果。

沙箱调试 ​

可通过以下沙箱地址查看该端点可能返回的完整字段结构，字段为模拟数据：

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

沙箱调用不扣费。

响应结构 ​

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

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用状态码。建议接时建立完整的异常与错误处理机制。
status_messagestring通用状态信息。
timestring执行耗时，单位秒。
costfloat本次请求总成本，单位 USD。获取结果通常为 0，以响应为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

tasks[] 字段 ​

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

result[] 字段说明 ​

字段类型说明
keywordstringPOST 提交时的。返回时会对 %## 进行解码，+ 会被还原为空格。
typestring创建任务时的搜索引擎类型。
se_domainstring创建任务时的搜索引擎域名。
location_codeinteger创建任务时的位置编码。
language_codestring创建任务时的语言编码。
check_urlstring对应 Amazon 搜索结果直达地址，可用于人工核验结果准确性。
datetimestring结果抓取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
spellobject搜索引擎自动纠错信息。
item_typesarray当前 Amazon SERP 中检测到的结果类型列表。
se_results_countinteger搜索引擎结果总量。
categoriesarrayAmazon 商品部门与子分类信息。
items_countintegeritems 数组中的结果数量。
itemsarrayAmazon 商品结果项。

spell 字段 ​

字段类型说明
keywordstring搜索引擎纠正后的。结果基于该返回。
typestring自动纠错类型。

spell.type 可选值：

  • did_you_mean
  • showing_results_for
  • no_results_found_for
  • including_results_for

item_types 可选值 ​

  • amazon_serp
  • amazon_paid
  • editorial_recommendations
  • top_rated_from_our_brands
  • related_searches

items[] 结果类型说明 ​

不同类型的 Amazon 结果块会以不同 type 返回。

1）editorial_recommendations ​

表示编辑推荐模块。

字段类型说明
typestring固定为 editorial_recommendations
rank_groupinteger相同 type素组排名。
rank_absoluteinteger在整个 Amazon SERP 中的绝对排名。
positionstring结果展示位置，可选：left、right。
xpathstring该的 XPath。
itemsarray该推荐模块中的商品列表。

items[]商品类型为 amazon_serp_element，字段如下：

字段类型说明
typestring固定为 amazon_serp_element
xpathstring素 XPath。
domainstringAmazon 域名。
titlestring商品标题。
urlstring商品页链接。
image_urlstring商品图片链接。
bought_past_monthinteger过去一个月购买量。
price_fromfloat商品常规价格下限，如 49.98。
price_tofloat商品价格区间上限，如 384.99。
currencystring币种，ISO 4217 格式，如 USD。
special_offersarray特惠信息，如优惠券、订省折扣等。
data_asinstringAmazon 商品唯一标识。示例：B07G82D89J。
ratingobject商品评分信息。
is_amazon_choiceboolean是否带有 “Amazon’s choice” 标记。
is_best_sellerboolean是否带有 “Best Seller” 标记。
delivery_infoobject送信息。
labelsarray商品标签信息；若无标签则为 null。

2）amazon_serp ​

表示自然商品结果。

字段与上面的商品基本一致：

字段类型说明
typestring固定为 amazon_serp
rank_groupinteger相同类型分组排名。
rank_absoluteintegerSERP 绝对排名。
xpathstring素 XPath。
domainstringAmazon 域名。
titlestring商品标题。
urlstring商品页链接。
image_urlstring商品图片链接。
bought_past_monthinteger过去一个月购买量。
price_fromfloat商品价格下限。
price_tofloat商品价格区间上限。
currencystring币种，ISO 4217 格式。
special_offersarray特惠信息。
data_asinstringAmazon 商品唯一标识。
ratingobject商品评分信息。
is_amazon_choiceboolean是否为 Amazon’s choice。
is_best_sellerboolean是否为 Best Seller。
delivery_infoobject送信息。
labelsarray商品标签信息。

3）amazon_paid ​

表示赞助广告商品结果。

字段与 amazon_serp 基本一致：

字段类型说明
typestring固定为 amazon_paid
rank_groupinteger相同类型分组排名。
rank_absoluteintegerSERP 绝对排名。
xpathstring素 XPath。
domainstringAmazon 域名。
titlestring商品标题。
urlstring商品页链接。
image_urlstring商品图片链接。
bought_past_monthinteger过去一个月购买量。
price_fromfloat商品价格下限。
price_tofloat商品价格区间上限。
currencystring币种，ISO 4217 格式。
special_offersarray特惠信息。
data_asinstringAmazon 商品唯一标识。
ratingobject商品评分信息。
is_amazon_choiceboolean是否为 Amazon’s choice。
is_best_sellerboolean是否为 Best Seller。
delivery_infoobject送信息。
labelsarray商品标签信息。

4）top_rated_from_our_brands ​

表示 “Top rated from our brands” 模块。

字段类型说明
typestring固定为 top_rated_from_our_brands
rank_groupinteger相同类型分组排名。
rank_absoluteintegerSERP 绝对排名。
xpathstring素 XPath。
itemsarray该模块中的商品列表。

该模块下的 items[] 商品类型同样为 amazon_serp_element，字段与前述商品一致。

5）related_searches ​

表示搜索模块。

字段类型说明
typestring固定为 related_searches
rank_groupinteger相同类型分组排名。
rank_absoluteintegerSERP 绝对排名。
positionstring结果展示位置，可选：left、right。
xpathstring素 XPath。
itemsarray搜索项列表。

related_searches.items[] 字段：

字段类型说明
typestring固定为 related_searches_element
titlestring搜索标题。
urlstring链接地址。
image_altstring图片 alt 文本。
image_urlstring图片链接。

通用嵌套字段说明 ​

rating ​

字段类型说明
typestring固定为 rating_element
positionstring展示位置，可选：left、right。
rating_typestring评分类型，可见值 Max5、Percents、CustomMax。
valuestring评分值。
votes_countinteger评价数量。
rating_maxstring该评分类型的最大值。

delivery_info ​

字段类型说明
delivery_messagestring送文案。
delivery_priceobject送费用信息；若支持运费则为 null。

delivery_price ​

字段类型说明
currentfloat当前价格。
regularfloat原始未折扣价格。
max_valuefloat送价格区间上限。
currencystring币种，ISO 4217 格式。
is_price_rangeboolean是否为价格区间。
displayed_pricestringAmazon 页面展示的原始价格文案。

labels ​

字段类型说明
typestring固定为 amazon_label_element
titlestring标签标题，例如 "Audiobook"。
urlstring标签中的商品链接。
domainstring标签链接中的域名；Amazon 自身标签通常为 null。

调用示例 ​

curl ​

bash
id="04170913-0696-0179-0000-707d6a06f64b"

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

Python ​

python
import requests

task_id = "02201115-0001-0066-0000-c06c8f23fce5"

url = f"https://api.seermartech.cn/v3/merchant/amazon/products/task_get/advanced/{task_id}"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json

print(data)

TypeScript ​

typescript
import axios from "axios";

const taskId = "02201115-0001-0066-0000-c06c8f23fce5";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/merchant/amazon/products/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);
 });

响应示例 ​

json
{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1189 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "organic",
 "se": "amazon",
 "api": "merchant",
 "function": "products",
 "priority": 2,
 "language_code": "en_US",
 "location_code": 2840,
 "keyword": "gaming keyboard",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 50544,
 "categories": [],
 "items_count": 130,
 "items": [
 {
 "type": "amazon_paid",
 "rank_absolute": 1,
 "domain": "www.amazon.com",
 "title": "REGAL Premiere Movie Ticket – Digital Ticket, Instant Delivery – Save Up To 40%",
 "url": "https://www.amazon.com/sspa/click?ie=UTF8&spc=MTo4NTMxNDQ3MTc4MTQxMzUwOjE3NzAyMTg5ODI6c3BfYXRmOjMwMDgxNTEyMzgwNTAwMjo6MDo6&url=%2FREGAL-Premiere-Movie-Ticket-Delivery%2Fdp%2FB0F3RQY7CH%2Fref%3Dsr_1_1_sspa%3Fcrid%3D7KYYE525QXOF%26dib%3DeyJ2IjoiMSJ9.hG5E_Ec62G8b02AC4HJo0SM6OM7nuQWJMPTkLz81z2s4CZX0yVSe1XdRGPtsJAKaHmhAOtKCgF7UXwevStkK8Z0ffBXB-O5GN5gTcQK5oI2IqECT0XHTs_1zXb--cNnlGt4nmXB4XV2-H6Hei_JDK5fhdZljJMlDWBi7aftLZXmAuK8ZDMggOuYSNxZj1fUnHhCAgacfJ6WDsHDvCjWfGVagvauWqEvVWtvZ4D7deBE.lmDknqFNOFg5MDsV-HUuBCDA7ShnHg8mWsVeFRP49t0%26dib_tag%3Dse%26keywords%3Dmovie%26qid%3D1770218982%26sprefix%3Dmovie%252Caps%252C205%26sr%3D8-1-spons%26sp_csd%3Dd2lkZ2V0TmFtZT1zcF9hdGY%26psc%3D1",
 "image_url": "https://m.media-amazon.com/images/I/61lcBjAMlLL._AC_UY218_.jpg",
 "bought_past_month": null,
 "price_from": 12.5,
 "price_to": null,
 "currency": "USD",
 "special_offers": null,
 "data_asin": "B0F3RQY7CH",
 "rating": {
 "type": "rating_element",
 "position": "left",
 "rating_type": "Max5",
 "value": 4.3,
 "votes_count": 25,
 "rating_max": 5
 },
 "is_amazon_choice": false,
 "is_best_seller": false,
 "delivery_info": null,
 "labels": []
 },
 {
 "type": "amazon_serp",
 "rank_group": 1,
 "rank_absolute": 3,
 "xpath": "/html/body/div/div/div/div/div/span/div/div",
 "domain": "www.amazon.com",
 "title": "Redragon S101 Wired Gaming Keyboard and Mouse Combo RGB Backlit Gaming Keyboard with Multimedia Keys Wrist Rest and Red Backlit Gaming Mouse 3200 DPI for Windows PC Gamers (Black)",
 "url": "https://www.amazon.com/Redragon-S101-Keyboard-Ergonomic-Programmable/dp/B00NLZUM36/ref=sr_1_3?dchild=1&keywords=gaming+keyboard&qid=1601038543&sr=8-3",
 "image_url": "https://m.media-amazon.com/images/I/71kr3WAj1FL._AC_UY218_.jpg",
 "bought_past_month": 100,
 "price_from": 36.98,
 "price_to": null,
 "currency": "USD",
 "special_offers": null,
 "data_asin": "B00NLZUM36",
 "rating": {
 "type": "rating_element",
 "position": "left",
 "rating_type": "Max5",
 "value": "4.5",
 "votes_count": 12162,
 "rating_max": "5"
 },
 "is_amazon_choice": false,
 "is_best_seller": true,
 "delivery_info": {
 "delivery_message": "Get it as soon as Tue, Sep 28 FREE Shipping by Amazon",
 "delivery_price": null
 },
 "labels": null
 },
 {
 "type": "editorial_recommendations",
 "rank_group": 1,
 "rank_absolute": 5,
 "position": "left",
 "xpath": "/html/body/div/div/div/div/div/span/div/div",
 "items": [
 {
 "type": "amazon_serp_element",
 "xpath": "/html/body/div/div/div/div/div/span/div/div/div/span/div/div/span/div/div/div/div/div/ol/li",
 "domain": "www.amazon.com",
 "title": "NPET K10 Gaming Keyboard USB Wired Floating Keyboard, Quiet Ergonomic Water-Resistant Mechanical Feeling Keyboard, Ultra-Slim Rainbow LED Backlit Keyboard for Desktop, Computer, PC",
 "url": "https://www.amazon.com/NPET-Floating-Keyboard-Mechanical-Illuminated/dp/B01ALLT2W4/ref=sxin_9_ac_d_pm?ac_md=1-0-VW5kZXIgJDI1-ac_d_pm&cv_ct_cx=gaming+keyboard&dchild=1&keywords=gaming+keyboard&pd_rd_i=B01ALLT2W4&pd_rd_r=5394dc15-8ee7-4f66-bfe1-974f06f024b0&pd_rd_w=3w89s&pd_rd_wg=kcCLl&pf_rd_p=7bce1efb-5229-4289-8758-b64b1d02cfb8&pf_rd_r=A1EMMY83FEN781WGNBY0&psc=1&qid=1601038543&sr=1-1-22d05c05-1231-4126-b7c4-3e7a9c0027d0",
 "image_url": "https://m.media-amazon.com/images/I/61w0BypBzrL._AC_UL320_.jpg",
 "bought_past_month": 100,
 "price_from": 21.99,
 "price_to": null,
 "currency": "USD",
 "special_offers": null,
 "data_asin": "B01ALLT2W4",
 "rating": {
 "type": "rating_element",
 "position": "left",
 "rating_type": "Max5",
 "value": "4.5",
 "votes_count": 4223,
 "rating_max": "5"
 },
 "is_amazon_choice": false,
 "is_best_seller": false,
 "delivery_info": {
 "delivery_message": "Fast Delivery To Your Door",
 "delivery_price": null
 },
 "labels": null
 }
 ]
 },
 {
 "type": "related_searches",
 "rank_group": 1,
 "rank_absolute": 35,
 "position": "left",
 "xpath": "/html/body/div/div/div/div/div/span/div/div",
 "items": []
 }
 ]
 }
 ]
 }
 ]
}

错误处理建议 ​

  • 顶层使用 status_code / status_message 判断请求是否成功。
  • 每个任务需继续检查 tasks[].status_code 与 tasks[].status_message。
  • 若任务尚未完成，可通过 /v3/merchant/amazon/products/tasks_ready 获取已完成任务列表，再逐个调用本接口获取。
  • 建议对 40000+ 级别状态码建立重试、告警和降级处理逻辑。

获取已完成任务的推荐流程 ​

  1. 调用：GET /v3/merchant/amazon/products/tasks_ready
  2. 获取已完成任务的结果地址或任务 ID
  3. 再调用：GET /v3/merchant/amazon/products/task_get/advanced/$id
  4. 解析 result[].items[] 中的不同 type，区分自然结果、广告结果、编辑推荐、品牌模块和搜索

实用场景 ​

  • 监控商品排名：按抓取 Amazon 搜索结果，持续追踪自有商品和竞品在自然位、广告位中的排名变化。
  • 识别广告占位强度：区分 amazon_paid 与 amazon_serp，评估某类目下广告挤压自然流量的程度。
  • 提取竞品特征：分析标题、价格、评分、评论数、信息、Best Seller 标签等字段，建立竞品画像。
  • 发现推荐：识别 editorial_recommendations、top_rated_from_our_brands 等模块，判断品牌是否高推荐区。
  • 扩展选品与投放词库：基于 related_searches 和分类信息挖掘需求词，站 SEO、广告投放和选品策略。

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

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