Amazon 批量搜索量查询（实时）

本接口用于一次性查询最多 1,000 个在 Amazon 站的月均搜索量。这里的搜索量表示某在 Amazon 上的近似月搜索次数。

返回结果与请求中提交的 keywords、location、language 参数严格对应。

请求方法：POST
请求地址：https://api.seermartech.cn/v3/dataforseo_labs/amazon/bulk_search_volume/live

计费与调用限制

本接口按请求计费
参考价请以参考单价换算，扣费以响应头 X-SeerMarTech-Charge-CNY 为准
调用频率上限：2000 次 / 分钟
最大并发请求数：30

请求格式

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

json

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

请求参数

字段名	类型	说明
`keywords`	array	目标列表。填。最多可提交 1000 个。使用 UTF-8 编码。系统会自动将转换为小写。
`location_name`	string	地区完整名称。未提供 `location_code` 时填。可通过 `/v3/dataforseo_labs/locations_and_languages` 查询可用地区。示例：`United States`
`location_code`	integer	地区编码。未提供 `location_name` 时填。可通过 `/v3/dataforseo_labs/locations_and_languages` 查询可用地区。示例：`2840`
`language_name`	string	语言完整名称。未提供 `language_code` 时填。可通过 `/v3/dataforseo_labs/locations_and_languages` 查询可用语言。示例：`English`
`language_code`	string	语言代码。未提供 `language_name` 时填。可通过 `/v3/dataforseo_labs/locations_and_languages` 查询可用语言。示例：`en`
`tag`	string	自定义任务标识。可选，最大长度 255 个字符。可用于结果追踪，响应中的 `data` 对象会返回该值。

当前支持的地区与语言

该端点当前支持以下地区与语言组合：

地区	编码	语言代码
Australia	2036	`en`
Austria	2040	`de`
Canada	2124	`en`
Egypt	2818	`ar`
France	2250	`fr`
Germany	2276	`de`
India	2356	`en`
Italy	2380	`it`
Mexico	2484	`es`
Netherlands	2528	`nl`
Saudi Arabia	2682	`ar`
Singapore	2702	`en`
Spain	2724	`es`
United Arab Emirates	2784	`ar`
United Kingdom	2826	`en`
United States	2840	`en`

响应结构

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

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码。完整列表参考 `/v3/appendix/errors`
`status_message`	string	通用状态信息。完整列表参考 `/v3/appendix/errors`
`time`	string	执行耗时，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`tasks`	array	任务结果数组

`tasks[]` 字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`，完整列表参考 `/v3/appendix/errors`
`status_message`	string	任务状态信息
`time`	string	任务执行耗时，单位秒
`cost`	float	任务费用，单位 USD
`result_count`	integer	`result` 数组中的数量
`path`	array	URL 路径
`data`	object	与 POST 请求中提交的参数一致
`result`	array	获取结果数组

`result[]` 字段

字段名	类型	说明
`se_type`	string	搜索引擎类型
`location_code`	integer	请求中的地区编码；若无数据则为 `null`
`language_code`	string	请求中的语言代码；若无数据则为 `null`
`total_count`	integer	数据库中与本次请求的结果总数
`items_count`	integer	`items` 数组中的结果数量
`items`	array	搜索量明细

`items[]` 字段

字段名	类型	说明
`se_type`	string	搜索引擎类型
`keyword`	string	请求中的
`search_volume`	integer	月均搜索量，表示该在 Amazon 上的近似月搜索次数

请求示例

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"
}
data = [
 {
 "keywords": ["phone", "iphone", "samsung"],
 "location_name": "United States",
 "language_name": "English"
 }
]

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

TypeScript

typescript

import axios from "axios";

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

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

响应示例

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": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1129 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_name": "English",
 "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": 5400
 },
 {
 "se_type": "amazon",
 "keyword": "iphone",
 "search_volume": 18100
 },
 {
 "se_type": "amazon",
 "keyword": "samsung",
 "search_volume": 9900
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整个请求的处理状态
tasks[].status_code 表示任务状态
建议同时检查：
HTTP 状态码
顶层 status_code
tasks_error
每个任务的 tasks[].status_code

常见成功状态：

状态码	说明
`20000`	请求成功

完整错误码与状态说明请参考 /v3/appendix/errors。生产环境中建议建立统一的异常处理与重试机制。

使用说明

单次最多支持 1000 个，适合批量获取 Amazon 搜索量
location_name 与 location_code 二选一即可
language_name 与 language_code 二选一即可
返回的搜索量为近似月均值
若某在指定地区/语言下无数据，对应结果可能为空或字段为 null

实用场景

批量评估选品词需求：一次获取大量商品词在 Amazon 的搜索量，快速判断市场需求强弱，选品优级排序。
筛选高潜力：结合搜索量识别高需求，为 Listing 标题、五点描述和后台 Search Terms 提供依据。
对比多热度差异：对一组同类词、近义词或品牌词做批量对比，帮助确定主推词与长尾词布局策略。
监控重点词流量变化基础值：定期拉取核心搜索量，建立趋势样本，用于评估类目热度变化。
支持站点本地化运营：按不同国家站点和语言查询搜索量，指导跨境团队制定本地化上架与投放策略。

Amazon 批量搜索量查询（实时） ​

计费与调用限制 ​

请求格式 ​

请求参数 ​

当前支持的地区与语言 ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

items[] 字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用说明 ​

实用场景 ​