SeerMarTech API 文档

主题

亚马逊 ASIN 任务创建 ​

接口说明 ​

该接口用于提交亚马逊 ASIN 查询任务，返回某个商品不同变体所对应的完整 ASIN 列表。

接口路径：

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

你只会在创建任务时被扣费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

所有 POST 数据使用 UTF-8 编码的 JSON 格式，且请求体为 JSON 数组：[{ ... }]

请求限制 ​

  • 每分钟最多发送 2000 次 API 调用
  • 每次 POST 请求最多 100 个任务
  • 如果单次请求 100 个任务，出部分会返回错误 40006

结果获取方式 ​

任务提交成功后，你可以通过返回的唯一任务 ID id 获取结果。

也可以在创建任务时指定以下回调方式之一：

  • postback_url：任务完成后，本平台将结果以 gzip 压缩的 POST 请求发送到该地址
  • pingback_url：任务完成后，本平台会向该地址发送 GET 通知请求

如果你的服务器在 10 秒未响应，连接会因时中断，任务会被转 /v3/merchant/amazon/asin/tasks_ready/ 列表中主动拉取。错误码和错误信息取决于你的服务器。更多说明可参考回调文档。

请求参数 ​

字段名类型说明
asinstring填。商品 ID，即 Amazon 的唯一商品标识（ASIN）。可通过 /v3/merchant/amazon/products/task_post/ 获取。
priorityinteger可选。任务优级。可选值：1 = 普通优级（默认），2 = 高优级。高优级会产生额外费用，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
location_namestring当未指定 location_code 或 location_coordinate 时填。搜索位置名。若使用该字段，则无需再传 location_code 或 location_coordinate。可通过 /v3/merchant/amazon/locations 获取可用位置列表。示例：HA1,England,United Kingdom
location_codeinteger当未指定 location_name 或 location_coordinate 时填。搜索位置编码。若使用该字段，则无需再传 location_name 或 location_coordinate。可通过 /v3/merchant/amazon/locations 获取。示例：9045969
location_coordinatestring当未指定 location_name 或 location_code 时填。GPS 坐标，格式为 latitude,longitude,radius。latitude 和 longitude 最多保留 7 位小数，radius 最小值为 199.9。示例：53.476225,-2.243572,200
language_namestring当未指定 language_code 时填。搜索语言名。若使用该字段，则无需再传 language_code。可通过 /v3/merchant/amazon/languages 获取。示例：English (United Kingdom)
language_codestring当未指定 language_name 时填。搜索语言编码。若使用该字段，则无需再传 language_name。可通过 /v3/merchant/amazon/languages 获取。示例：en_GB
se_domainstring可选。搜索引擎域名。本平台会根据你指定的位置和语言自动选择合适域名，你也可以手动指定。示例：amazon.com、amazon.co.uk、amazon.fr
tagstring可选。自定义任务标识，最长 255 个字符。便于结果对账和业务。返回结果中的 data 对象会带回该值。
postback_urlstring可选。任务完成后，平台会将结果以 gzip 压缩的 POST 请求发送到该地址。支持在 URL 中使用 $id 和 $tag 变量，发送前会替换为真实值。示例：http://your-server.com/postbackscript?id=$id 或 http://your-server.com/postbackscript?id=$id&tag=$tag。注意：postback_url 中的特殊字符会被 URL 编码，例如 # 会编码为 %23。
postback_datastring指定了 postback_url 时填。回传数据类型。可选值：advanced、html
pingback_urlstring可选。任务完成后，平台会向该地址发送 GET 通知。支持在 URL 中使用 $id 和 $tag 变量，发送前会替换为真实值。示例：http://your-server.com/pingscript?id=$id 或 http://your-server.com/pingscript?id=$id&tag=$tag。注意：pingback_url 中的特殊字符会被 URL 编码，例如 # 会编码为 %23。

响应结构 ​

接口返回 JSON 数据， tasks 数组，用于描述已创建任务的信息。

顶层字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码。完整错误码请参考 /v3/appendix/errors
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结果数组。对于创建任务接口，该值通常为 null

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/merchant/amazon/asin/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": "B0756FCPPN"
 },
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN",
 "priority": 2,
 "tag": "some_string_123",
 "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
 },
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN",
 "postback_data": "html",
 "postback_url": "https://your-server.com/postbackscript"
 }
]'

Python ​

python
import requests

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

data = [
 {
 # 示例 1：最简任务
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN"
 },
 {
 # 示例 2：高优级 + pingback 通知
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN",
 "priority": 2,
 "tag": "some_string_123",
 "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
 },
 {
 # 示例 3：通过 postback 接收结果
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN",
 "postback_data": "html",
 "postback_url": "https://your-server.com/postbackscript"
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postArray = [
 {
 // 示例 1：最简任务
 location_name: "United States",
 language_name: "English (United States)",
 asin: "B0756FCPPN"
 },
 {
 // 示例 2：高优级 + pingback 通知
 location_name: "United States",
 language_name: "English (United States)",
 asin: "B0756FCPPN",
 priority: 2,
 tag: "some_string_123",
 pingback_url: "https://your-server.com/pingscript?id=$id&tag=$tag"
 },
 {
 // 示例 3：通过 postback 接收结果
 location_name: "United States",
 language_name: "English (United States)",
 asin: "B0756FCPPN",
 postback_data: "html",
 postback_url: "https://your-server.com/postbackscript"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/merchant/amazon/asin/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.response?.data || error.message);
 });

响应示例 ​

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

状态码说明 ​

状态码说明
20000请求成功
20100任务创建成功
40006单次 POST 请求中的任务数 100 个
10000-60000任务级状态码范围，需结合 status_message 判断

建议对 status_code、tasks_error、任务级 status_code 建立完整的异常处理逻辑。完整错误码定义可参考 /v3/appendix/errors。

使用说明补 ​

  • location_name、location_code、location_coordinate 三传一即可
  • language_name 与 language_code 二选一
  • 如果指定 postback_url，则同时提供 postback_data
  • 创建任务接口本身通常不直接返回业务结果，result 一般为 null
  • 如需查询已完成任务结果，可使用返回的任务 id 到对应结果接口或 ready 列表继续获取

实用场景 ​

  • 识别商品变体 ASIN：查询同一商品不同颜色、尺寸、版本对应的 ASIN，便于建立商品变体映射。
  • 监控竞品变体覆盖：批量抓取竞品商品的变体 ASIN 列表，分析 SKU 结构和上架完整度。
  • 广告投放对象：将父商品下的多个子 ASIN 自动补齐到投放或监测系统中，减少漏投漏监控问题。
  • 构建商品主子体数据库：把变体级 ASIN 数据沉淀到商品中心，支持后续排名、评论、价格等多维分析。
  • 校验采集结果完整性：对已有商品库执行 ASIN 反查，确认不同变体是否采集齐，提高电商数据质量。

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

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