SeerMarTech API 文档

主题

亚马逊实时接口 ​

接口说明 ​

/v3/dataforseo_labs/amazon/related_keywords/live 用于获取 Amazon 搜索结果页中 “Related Searches（搜索）” 区域出现的。

你可以基于一个种子词，通过设置搜索深度 depth 扩展出。接口最多可返回约 1554 个创意，并为每个提供搜索量信息。

  • 数据源：本平台 Amazon SERP 数据库
  • 搜索算法：基于指定种子词，对 Amazon “Related Searches” 中出现的查询执行深度优搜索

示例说明 ​

当 depth=1，种子词为：

computer mouse

可能返回的：

  • computer mouse wired
  • computer mouse wireless
  • computer mouse pad
  • wireless computer mouse
  • mouse pad
  • gaming mouse

请求方式 ​

POST https://api.seermartech.cn/v3/dataforseo_labs/amazon/related_keywords/live

计费说明 ​

该接口按请求计费。

参考价约 ¥0.1680 / 次。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制 ​

  • 每分钟最多可发起 2000 次 API 调用
  • 最大并发请求数为 30

请求体格式 ​

所有 POST 数据使用 JSON（UTF-8 编码），并以 JSON 数组 形式提交：

json
[
 {
 "keyword": "computer mouse",
 "language_name": "English",
 "location_code": 2840,
 "limit": 5,
 "include_seed_keyword": true
 }
]

你可以通过参数控制：

  • 返回结果数量
  • 结果过滤
  • 结果排序（如平台容能力支持）

请求参数 ​

字段名类型说明
keywordstring填。种子。使用 UTF-8 编码，且应使用小写格式。
location_namestring地区名。未提供 location_code 时填。location_name 与 location_code 二选一。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用地区列表。当前支持美国、埃及、沙特阿拉伯、阿联。示例：United States
location_codeinteger地区编码。未提供 location_name 时填。location_name 与 location_code 二选一。可通过 /v3/dataforseo_labs/locations_and_languages 获取。当前支持美国、埃及、沙特阿拉伯、阿联。示例：2840
language_namestring语言名。未提供 language_code 时填。language_name 与 language_code 二选一。可通过 /v3/dataforseo_labs/locations_and_languages 获取。示例：English
language_codestring语言代码。未提供 language_name 时填。language_name 与 language_code 二选一。可通过 /v3/dataforseo_labs/locations_and_languages 获取。示例：en
depthinteger可选。搜索深度，默认值 1。可设置范围：0 到 4。返回结果数量随深度增加而增加。预计最大数量：0 → 返回 keyword 本身；1 → 6 个；2 → 42 个；3 → 258 个；4 → 1554 个。
include_seed_keywordboolean可选。是否在响应中的 seed_keyword_data 返回种子词数据。默认 false。
ignore_synonymsboolean可选。是否忽略高度相似。设为 true 时返回核心，排除高度相似词。默认 false。
limitinteger可选。返回数量上限。默认 100，最大 1000。
offsetinteger可选。结果偏移量，默认 0。例如设为 10 时，将跳过前 10 条结果并返回后续数据。
tagstring可选。自定义任务标识，最大长度 255。便于在响应中进行任务匹与追踪。

响应结构 ​

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

顶层字段 ​

字段名类型说明
versionstring当前 API 版本。
status_codeinteger通用状态码。完整错误码请参考 /v3/appendix/errors。建议在系统中做好异常与错误处理。
status_messagestring通用状态信息。完整说明请参考 /v3/appendix/errors。
timestring执行耗时，单位秒。
costfloat本次请求总费用，单位 USD。
tasks_countintegertasks 数组中的任务数量。
tasks_errorinteger返回错误的任务数量。
tasksarray任务结果数组。

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式。
status_codeinteger任务状态码，范围通常为 10000-60000。完整错误码请参考 /v3/appendix/errors。
status_messagestring任务状态说明。
timestring任务执行耗时，单位秒。
costfloat当前任务费用，单位 USD。
result_countintegerresult 数组中的数量。
patharrayURL 路径。
dataobject与请求体中提交的参数一致。
resultarray结果数组。

result[] 字段 ​

字段名类型说明
se_typestring搜索引擎类型，此处为 amazon。
seed_keywordstring请求中提交的种子词。
seed_keyword_dataobject种子词数据对象。当 include_seed_keyword=true 时返回。字段结构与 keyword_data 相同。
location_codeinteger请求中的地区编码。
language_codestring请求中的语言代码。
total_countinteger数据库中与请求匹的总结果数。
items_countintegeritems 数组返回的结果数。
itemsarray及数据列表。

items[] 字段 ​

字段名类型说明
se_typestring搜索引擎类型。
keyword_dataobject当前返回的数据对象。
depthinteger当前所在搜索深度。
related_keywordsarray与当前的搜索词列表。

keyword_data 字段 ​

字段名类型说明
se_typestring搜索引擎类型。
keywordstring。
location_codeinteger请求中的地区编码。
language_codestring请求中的语言代码。
keyword_infoobject信息对象。

keyword_info 字段 ​

字段名类型说明
se_typestring搜索引擎类型。
last_updated_timestring数据最近更新时间，UTC 格式：yyyy-mm-dd hh:mm:ss +00:00。示例：2019-11-15 12:57:46 +00:00
search_volumeinteger平均月搜索量，表示该在 Amazon 上的大致搜索次数。

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/amazon/related_keywords/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "keyword": "computer mouse",
 "language_name": "English",
 "location_code": 2840,
 "limit": 5,
 "include_seed_keyword": true
 }
]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/amazon/related_keywords/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "keyword": "computer mouse",
 "location_name": "United States",
 "language_name": "English",
 "limit": 5,
 "include_seed_keyword": True
 }
]

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

if result.get("status_code") == 20000:
 print(result)
else:
 print(f'error. Code: {result.get("status_code")} Message: {result.get("status_message")}')

TypeScript ​

typescript
import axios from "axios";

const postArray = [
 {
 keyword: "computer mouse",
 language_name: "English",
 location_code: 2840,
 limit: 5,
 include_seed_keyword: true
 }
];

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

响应示例 ​

json
{
 "version": "0.1.20220216",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1167 sec.",
 "cost": 0.0105,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "related_keywords",
 "se_type": "amazon",
 "keyword": "computer mouse",
 "language_name": "English",
 "location_code": 2840,
 "limit": 5,
 "include_seed_keyword": true
 },
 "result": [
 {
 "se_type": "amazon",
 "seed_keyword": "computer mouse",
 "location_code": 2840,
 "language_code": "en",
 "items": [
 {
 "se_type": "amazon",
 "keyword_data": {
 "se_type": "amazon",
 "keyword": "computer mouse wireless",
 "location_code": 2840,
 "language_code": "en",
 "keyword_info": {
 "se_type": "amazon",
 "last_updated_time": "2022-02-15 20:56:16 +00:00",
 "search_volume": 3100
 }
 },
 "depth": 1,
 "related_keywords": []
 },
 {
 "se_type": "amazon",
 "keyword_data": {
 "se_type": "amazon",
 "keyword": "computer mouse wired",
 "location_code": 2840,
 "language_code": "en",
 "keyword_info": {
 "se_type": "amazon",
 "last_updated_time": "2022-02-15 20:56:10 +00:00",
 "search_volume": 2200
 }
 },
 "depth": 1,
 "related_keywords": []
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理 ​

  • 顶层 status_code 表示整次请求的执行状态
  • tasks[].status_code 表示单个任务的执行状态
  • 建议同时校验：
  • HTTP 状态码
  • 顶层 status_code
  • tasks_error
  • 各任务的 status_code

完整错误码与说明请参考：

  • /v3/appendix/errors

使用建议 ​

  1. 优控制 depth：深度越高，可扩展的越多，但结果集也会明显增大。
  2. 合 ignore_synonyms 去重：适合做词库洗或核心词提取。
  3. 使用 limit + offset 分页：当结果较多时，建议分页获取。
  4. 开启 include_seed_keyword 做对比分析：便于同时拿到种子词本身与扩展词的搜索量数据。

实用场景 ​

  • 扩展 Amazon 选品：基于核心商品词批量挖掘搜索词，快速补标题、五点描述和后台搜索词。
  • 筛选高搜索量长尾词：结合 search_volume 找出更的购买意图词，提升商品和自然流量。
  • 洗重复或近义词流量词：通过 ignore_synonyms 保留核心词，减少投放或布局中的冗余词。
  • 分析不同市场的搜索偏好：按 location_code 和 language_code 比较美国、中东等市场的搜索差异，跨境站点本地化。
  • 构建类目词根扩展网络：利用 depth 和 related_keywords 逐层扩展词簇，为类目页、专题页和广告组搭建更完整的结构。

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

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