SeerMarTech API 文档

主题

Amazon 批量搜索量 ​

POST /v3/dataforseo_labs/amazon/bulk_search_volume/live

本接口使用 POST 方法，路径为：

/v3/dataforseo_labs/amazon/bulk_search_volume/live

一次请求最多可查询 1,000 个在 Amazon 上的月均搜索量。返回数据由请求中的 keywords、位置和语言参数决定。搜索量表示指定在 Amazon 上的近似月搜索次数。

接口限制与计费 ​

  • 每个 Live API 请求只能 1 个任务。
  • 单个任务最多 1,000 个。
  • 每分钟最多可发起 2,000 次 API 调用。
  • 同时发送的请求数最多为 30 个。
  • 所有 POST 数据使用 UTF-8 编码的 JSON 格式。
  • 每次请求都会产生费用。
  • 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

请求体是 JSON 数组，示例：

json
[
  {
    "keywords": [
      "phone",
      "iphone",
      "samsung"
    ],
    "location_code": 2840,
    "language_code": "en"
  }
]

任务参数 ​

参数类型说明
keywordsarray目标数组。填，使用 UTF-8 编码，最多支持 1,000 个。会被转换为小写格式。
location_namestring位置的完整名称。当未指定 location_code 时填。
location_codeinteger位置代码。当未指定 location_name 时填。
language_namestring语言的完整名称。当未指定 language_code 时填。
language_codestring语言代码。当未指定 language_name 时填。
tagstring用户自定义任务标识，可选，最长 255 个字符。该值会原样返回在响应的 data 对象中，可用于请求与结果。

位置和语言参数成对使用：

  • location_name 与 location_code 二选一。
  • language_name 与 language_code 二选一。

可通过以下接口获取可用的位置和语言列表：

/v3/dataforseo_labs/locations_and_languages

支持的位置与语言 ​

位置位置代码语言代码
澳大利亚2036en
奥地利2040de
加拿大2124en
埃及2818ar
法国2250fr
德国2276de
印度2356en
意大利2380it
墨西哥2484es
荷2528nl
沙特阿拉伯2682ar
新加坡2702en
西班牙2724es
阿联2784ar
英国2826en
美国2840en

示例：

json
{
  "location_name": "United States",
  "language_name": "English"
}

或：

json
{
  "location_code": 2840,
  "language_code": "en"
}

响应字段 ​

接口返回 JSON 数据 tasks 任务数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用响应状态码。
status_messagestring通用状态说明。
timestring接口执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

tasks 中的字段 ​

字段类型说明
idstring任务唯一标识，使用 UUID 格式。
status_codeinteger任务状态码，通常为 10000 至 60000。
status_messagestring任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharray请求 URL 路径。
dataobject请求任务中提交的参数。
resultarray当前任务的结果数组。

result 中的字段 ​

字段类型说明
se_typestring搜索引擎类型，本接口返回 amazon。
location_codeinteger请求中使用的位置代码。无对应数据时可能为 null。
language_codestring请求中使用的语言代码。无对应数据时可能为 null。
total_countinteger数据库中与请求条件的结果总数。
items_countintegeritems 数组中返回的结果数量。
itemsarray搜索量数据数组。

items 中的字段 ​

字段类型说明
se_typestring搜索引擎类型，本接口返回 amazon。
keywordstring请求中的。
search_volumeinteger在 Amazon 上的平均月搜索量，表示近似搜索次数。

完整状态码列表请参考错误码文档。建议客户端根据 status_code 和 status_message 实现异常及错误处理。

请求示例 ​

cURL ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/dataforseo_labs/amazon/bulk_search_volume/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "keywords": [
        "phone",
        "iphone",
        "samsung"
      ],
      "location_code": 2840,
      "language_code": "en"
    }
  ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/amazon/bulk_search_volume/live"

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

payload = [
    {
        "keywords": [
            "phone",
            "iphone",
            "samsung",
        ],
        "location_name": "United States",
        "language_name": "English",
    }
]

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

if response.ok:
    result = response.json()
    if result.get("status_code") == 20000:
        print(result)
    else:
        print(
            "接口错误：代码 %s，消息：%s"
            % (result.get("status_code"), result.get("status_message"))
        )
else:
    print("HTTP 错误：", response.status_code, response.text)

TypeScript ​

typescript
import axios from "axios";

const url =
  "https://api.seermartech.cn/v3/dataforseo_labs/amazon/bulk_search_volume/live";

const payload = [
  {
    keywords: ["phone", "iphone", "samsung"],
    location_code: 2840,
    language_code: "en",
  },
];

axios
  .post(url, payload, {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  })
  .then((response) => {
    const result = response.data;

    if (result.status_code === 20000) {
      console.log(result);
    } else {
      console.error(
        `接口错误：代码 ${result.status_code}，消息：${result.status_message}`
      );
    }
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.message);
  });

响应示例 ​

json
{
  "version": "0.1.20220216",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1129 sec.",
  "cost": 0.0103,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0987 sec.",
      "cost": 0.0103,
      "result_count": 1,
      "path": [
        "v3",
        "dataforseo_labs",
        "amazon",
        "bulk_search_volume",
        "live"
      ],
      "data": {
        "api": "dataforseo_labs",
        "function": "bulk_search_volume",
        "se_type": "amazon",
        "language_code": "en",
        "location_code": 2840,
        "keywords": [
          "phone",
          "iphone",
          "samsung"
        ]
      },
      "result": [
        {
          "se_type": "amazon",
          "location_code": 2840,
          "language_code": "en",
          "total_count": 3,
          "items_count": 3,
          "items": [
            {
              "se_type": "amazon",
              "keyword": "phone",
              "search_volume": 100000
            },
            {
              "se_type": "amazon",
              "keyword": "iphone",
              "search_volume": 80000
            },
            {
              "se_type": "amazon",
              "keyword": "samsung",
              "search_volume": 60000
            }
          ]
        }
      ]
    }
  ]
}

实用场景 ​

  • 批量筛选 Amazon 商品的月均搜索量，为选品和优级排序提供依据。
  • 比较 不同国家或语言市场的搜索需求，评估跨境电商市场价值。
  • 扩展 商品标题、五点描述和后台搜索词候选列表，优覆盖高搜索量词。
  • 评估 多个竞品类目的需求规模，制定 Amazon SEO策略。
  • 监测 核心商品词与长尾词的搜索量数据，为广告投放和自然流量预算分提供参考。

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

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