Skip to main content
POST
Amazon 批量搜索量
此端点可在一次 API 请求中提供最多 1,000 个关键词的搜索量值。此处的搜索量表示某个关键词在 Amazon 上每月的大致搜索次数。返回结果特定于 POST 请求中指定的 keywordslocationlanguage 参数。

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
keywords
string[]
必填

目标关键词 必填字段 UTF-8 编码 此数组中最多可指定 1000 个关键词;关键词将转换为小写格式 有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制,请参阅此帮助中心文章

location_name
string
必填

位置的完整名称,必填字段(如果未指定 location_code)。您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发出请求,获取包含 location_name 的可用位置列表;注意:此端点目前仅支持以下位置和语言: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。示例:United States

location_code
integer
必填

位置代码;如果未指定 location_name,则此字段为必填项。你可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求,获取可用位置及其 location_code 列表。注意:此端点目前仅支持这些位置和语言。示例:2840

language_name
string
必填

语言的完整名称;如果未指定 language_code,则为必填字段;您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求,获取可用语言及其 language_name 的列表;注意:此端点目前仅支持这些位置和语言;示例:English

language_code
string
必填

语言代码;如果未指定 language_name,则为必填字段;可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求,获取可用语言及其 language_code 的列表。注意:此端点目前仅支持这些位置和语言;示例:en

tag
string

用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值

响应

成功响应

version
string

API 的当前版本

status_code
integer

通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况

status_message
string

常规信息消息;可在此处查看常规信息消息的完整列表

time
string

执行时间(秒)

cost
number

任务总成本(美元)

tasks_count
integer

tasks 数组中的任务数量

tasks_error
integer

返回错误的 tasks 数组中的任务数量

tasks
string[]

任务数组

tasks.id
string

任务标识符,系统中采用 UUID 格式的唯一任务标识符

tasks.status_code
integer

DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看

tasks.status_message
string

任务的信息性消息,你可以在此处查看通用信息性消息的完整列表

tasks.time
string

执行时间(秒)

tasks.cost
number

任务成本(美元)

tasks.result_count
integer

结果数组中的元素数量

tasks.path
string[]

URL 路径

tasks.data
object

包含您在 POST 请求中指定的相同参数

tasks.result
string[]

结果数组

tasks.result.se_type
string

搜索引擎类型

tasks.result.location_code
integer

POST 数组中的位置代码;如果没有数据,则值为 null

tasks.result.language_code
string

POST 数组中的语言代码;如果没有数据,则值为 null

tasks.result.total_count
integer

数据库中与您的请求相关的结果总量

tasks.result.items_count
integer

items 数组中返回的结果数量

tasks.result.items
string[]

包含关键词搜索量数据

tasks.result.items.se_type
string

搜索引擎类型

tasks.result.items.keyword
string

POST 数组中的关键词

tasks.result.items.search_volume
integer

平均每月搜索量,表示返回的关键词在 Amazon 上的(近似)搜索次数