SeerMarTech API 文档

主题

亚马逊卖家任务提交 ​

接口说明 ​

该接口用于提交亚马逊卖家采集任务，返回指定商品在 Amazon 上的卖家列表。每个卖家结果中可商品成色、价格、方式以及评分等信息。

结果与所选地区和语言，因此创建任务时需要指定对应的地域与语言参数。

注意： 提交本接口任务前，拿到商品的 asin。该值可通过单独调用 /v3/merchant/amazon/products/task_post 获取。

接口支持两种任务优级，用于控制执行速度：

  • 1：普通优级（默认）
  • 2：高优级（执行更快，费用更高）

请求地址 ​

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

计费说明 ​

本接口按任务提交计费。 参考价约 ¥0.0320 / 次。

如使用高优级任务，通常会产生更高费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求规则 ​

  • 请求方法：POST
  • 请求体格式：JSON 数组 [{ ... }]
  • 编码：UTF-8
  • 单次 POST 最多可提交 100 个任务
  • 频率上限：2000 次 API 调用/分钟
  • 若单次请求中任务数 100，出部分将返回错误 40006

任务提交成功后，可以通过返回的任务唯一标识 id 获取结果。 如果创建任务时设置了 postback_url 或 pingback_url，本平台也可在任务完成后主动通知或推送结果。

如果回调服务器在 10 秒未响应，请求会因时中断，任务将转 /v3/merchant/amazon/sellers/tasks_ready/ 列表，后续可自行获取结果。报错信息取决于你的服务端。

请求参数 ​

任务级参数 ​

字段名类型填说明
asinstring是Amazon 商品唯一标识。需通过 /v3/merchant/amazon/products/task_post 获取。示例：B085RFFC9Q
priorityinteger否任务优级。1=普通优级（默认）；2=高优级
location_namestring条件填地区完整名称。当未提供 location_code 或 location_coordinate 时填。填写后无需再传另外两个字段。示例：London,England,United Kingdom
location_codeinteger条件填地区编码。当未提供 location_name 或 location_coordinate 时填。填写后无需再传另外两个字段。示例：2840
location_coordinatestring条件填GPS 坐标。当未提供 location_name 或 location_code 时填。格式：latitude,longitude,radius；latitude 与 longitude 最多 7 位小数；radius 最小值为 199.9。示例：53.476225,-2.243572,200
language_namestring条件填语言完整名称。当未提供 language_code 时填。填写后无需再传 language_code。示例：English (United States)
language_codestring条件填语言编码。当未提供 language_name 时填。填写后无需再传 language_name。示例：en_US
se_domainstring否自定义搜索域名。通常会根据地区和语言自动选择，也可手动指定。示例：amazon.co.uk、amazon.com.au、amazon.de
tagstring否自定义任务标识，最长 255 字符。可用于结果对账和业务，响应的 data 对象中会返回该值
postback_urlstring否结果推送地址。任务完成后，本平台会将结果以 gzip 压缩后的 POST 请求发送到该地址
postback_datastring条件填当指定 postback_url 时填。表示推送到你服务器的数据类型，可选值：advanced、html
pingback_urlstring否完成通知地址。任务完成后，本平台会向该地址发送 GET 请求通知

地区与语言查询接口 ​

可用地区与语言可通过以下容路径获取：

  • 地区列表：/v3/merchant/amazon/locations
  • 语言列表：/v3/merchant/amazon/languages

回调参数说明 ​

postback_url ​

任务完成后，本平台会向该地址发送 POST 请求，并附带压缩结果数据。

支持以下占位变量：

  • $id：任务 ID
  • $tag：URL 编码后的任务标签

示例：

  • http://your-server.com/postbackscript?id=$id
  • http://your-server.com/postbackscript?id=$id&tag=$tag

说明：

  • postback_url 中的特殊字符会被 URL 编码
  • 例如 # 会被编码为 %23

pingback_url ​

任务完成后，本平台会向该地址发送 GET 请求通知。

同样支持：

  • $id
  • $tag

示例：

  • http://your-server.com/pingscript?id=$id
  • http://your-server.com/pingscript?id=$id&tag=$tag

响应说明 ​

接口返回 JSON 数据，核心位于 tasks 数组中。

顶层响应字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码
status_messagestring通用状态消息
timestring执行耗时，单位秒
costfloat本次请求总费用，单位 USD
tasks_countintegertasks 数组中的任务数量
tasks_errorinteger返回错误的任务数量
tasksarray任务数组

tasks 数组字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000
status_messagestring任务状态说明
timestring任务耗时，单位秒
costfloat该任务费用，单位 USD
result_countintegerresult 数组中的数量
patharray接口路径
dataobject回显创建任务时传的参数
resultarray | null结果数组。创建任务接口中通常为 null，需后续通过任务结果接口获取

请求示例 ​

curl ​

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

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/merchant/amazon/sellers/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# 示例 1：基础任务
payload = [
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B085RFFC9Q"
 }
]

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

Python（带高优级与 pingback） ​

python
import requests

url = "https://api.seermartech.cn/v3/merchant/amazon/sellers/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

payload = [
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B085RFFC9Q",
 "priority": 2,
 "tag": "some_string_123",
 "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postArray = [
 {
 location_name: "United States",
 language_name: "English (United States)",
 asin: "B085RFFC9Q",
 priority: 2,
 tag: "some_string_123",
 pingback_url: "https://your-server.com/pingscript?id=$id&tag=$tag"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/merchant/amazon/sellers/task_post",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postArray
})
 .then((response) => {
 // 返回任务提交结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

带 postback 的请求示例 ​

json
[
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B085RFFC9Q",
 "postback_data": "html",
 "postback_url": "https://your-server.com/postbackscript"
 }
]

响应示例 ​

json
{
 "version": "0.1.20200416",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0883 sec.",
 "cost": 0.002,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20100,
 "status_message": "Task Created.",
 "time": "0.0031 sec.",
 "cost": 0.002,
 "result_count": 0,
 "path": [
 "v3",
 "merchant",
 "amazon",
 "sellers",
 "task_post"
 ],
 "data": {
 "api": "merchant",
 "function": "sellers",
 "se": "amazon",
 "language_code": "en_US",
 "location_code": 2840,
 "asin": "B085RFFC9Q",
 "priority": 2,
 "se_type": "shops_list",
 "device": "desktop",
 "os": "windows"
 },
 "result": null
 }
 ]
}

状态码说明 ​

状态码含义
20000请求成功
20100任务已创建
40006单次 POST 中任务数 100 的限制

完整错误码体系请参考 /v3/appendix/errors。 建议在业务侧对通用状态码、任务状态码、回调时和任务重试机制做好异常处理。

使用建议 ​

  1. 获取 ASIN 再提交卖家任务 该接口依赖 asin，通常应调用 /v3/merchant/amazon/products/task_post 获取目标商品标识。

  2. 优使用 location_code 与 language_code 对程序化接更稳定，能减少名称拼写差异带来的错误。

  3. 大批量任务按 100 条分批提交 避触发 40006 错误，同时更便于队列管理与失败重试。

  4. 异步结果建议使用回调机制 若任务量大，建议通过 pingback_url 或 postback_url 提升处理效率。

实用场景 ​

  • 监控商品卖家结构：定时拉取指定 ASIN 的卖家列表，识别自营、第三方及跟卖卖家变化，帮助电商团队及时发现渠道波动。
  • 分析价格与竞争力：获取卖家的价格、与成色信息，用于比对竞品报价策略，制定更有竞争力的定价方案。
  • 追踪区域化卖家差异：按不同国家、地区和语言创建任务，比较同一商品在不同市场的卖家分布，支持跨境电商本地化运营。
  • 识别高评分卖家机会：结合卖家评分信息筛选优质卖家，品牌合作、分销拓展或渠道评估。
  • 建立异步采集流水线：通过 postback_url 或 pingback_url 自动接收任务完成通知，把亚马逊卖家数据接 BI、选品或监控系统。

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

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