关键词排名
此端点将提供目标产品在 Amazon 上获得排名的关键词列表。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
产品 ID 必填字段 Amazon 上的唯一产品标识符(ASIN);您可以通过单独请求 Amazon Products 端点获取 asin 参数
位置的完整名称。如果未指定 location_code,则为必填字段。可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求,获取包含 location_name 的可用位置列表。注意:此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置。示例:United States
位置代码;如果未指定 location_name,则为必填字段;您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发出请求,获取可用位置及其 location_code 的列表;注意:此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置;示例:2840
语言全名 必填字段 如果未指定 language_code,可以向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求,以获取可用语言及其 language_name 的列表 示例:English
语言代码;如果未指定 language_name,则为必填字段;可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求,获取可用语言及其 language_code 列表;示例:en
结果数组中的最大产品数量,可选字段,默认值:100;最大值:1000
忽略高度相似的关键词,可选字段。如果设置为 true,则仅返回核心关键词,并排除所有高度相似的关键词;默认值:false
结果过滤参数数组 可选字段 可以同时添加多个过滤器(最多 8 个过滤器)应在条件之间设置逻辑运算符 and、or 支持以下运算符:regex、not_regex、,、,、>、>=、=、,、in、not_in、like、not_like、match、not_match 可以将 % 运算符与 like 和 not_like 配合使用,以匹配由零个或多个字符组成的任意字符串 示例:["keyword_data.keyword_info.search_volume","in",[100,1000]];有关过滤器的更多信息,请参阅 Dataforseo Labs – Filters 或此帮助中心指南
结果排序规则,可选字段。你可以使用与 filters 数组中相同的值对结果进行排序。可用排序类型:asc – 结果将按升序排列;desc – 结果将按降序排列。应使用逗号设置排序参数。示例:["keyword_data.keyword_info.competition,desc"]。默认规则:["ranked_serp_element.serp_item.rank_group,asc"]。请注意,单个请求最多可以设置三个排序规则。应使用逗号分隔多个排序规则。示例:["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"]
返回关键词的结果数组中的偏移量,可选字段,默认值:0。如果指定值 10,结果数组中的前十个关键词将被省略,并提供后续关键词的数据
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息;可在此处查看常规信息消息的完整列表
执行时间(秒)
任务总成本(美元)
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符,系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看
任务的信息性消息,你可以在此处查看通用信息性消息的完整列表
执行时间(秒)
任务成本(美元)
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
搜索引擎类型
POST 数组中的 ASIN
POST 数组中的位置代码;如果没有数据,则值为 null
POST 数组中的语言代码;如果没有数据,则值为 null
数据库中与您的请求相关的结果总量
items 数组中返回的结果数量
包含检测到的 Amazon 产品竞争对手及相关数据
搜索引擎类型
返回关键词的关键词数据
搜索引擎类型
返回的关键词
POST 数组中的位置代码
POST 数组中的语言代码
返回关键词的关键词信息
搜索引擎类型
keyword 数据更新的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00
平均每月搜索量,表示返回的关键词在 Amazon 上的(近似)搜索次数
包含为返回的关键词找到的产品 SERP 元素相关数据
搜索引擎类型
包含 SERP 元素的数据,支持的 SERP 元素列表见下文
搜索引擎类型
元素类型 = ‘amazon_serp’
在 type 值相同的元素组内的位置;type 值不同的元素位置不会计入 rank_group。
Amazon SERP 中的绝对排名,即在 SERP 所有元素中的绝对位置
元素在 Amazon SERP 中的对齐方式可取以下值:left、right
元素的 XPath
Amazon 域名
产品标题
产品页面的 URL
产品描述
产品的 ASIN;有关 ASIN 的更多信息,请参阅此帮助中心指南
结果中展示的产品图片 URL
产品的常规价格,例如:49.98
产品价格范围的上限,示例:384.99
ISO 格式的货币,例如:USD
特别优惠详情,包含优惠券和 Subscribe & Save 折扣等特别优惠信息
“Best Seller”标签;如果值为 true,则产品会被标记为“Best Seller”
“Amazon’s choice”标签,如果值为 true,则产品会标有“Amazon’s choice”标签
该条目的评分,即基于评论得出的热度评分,并显示在 SERP 中
评分类型;可使用以下值:Max5、Percents、CustomMax
评级值
反馈数量
rating_type 的最大值
配送信息,包括免费配送和快速配送的日期范围
配送信息;卖家发布的配送信息所附消息
配送价格 根据你在 POST 请求中指定的位置计算的配送价格;如果提供免费配送,则值为 null
当前交割价格
常规未折扣配送价格
未折现最高交割价格
ISO 格式的货币代码
指示配送价格是否为区间
Amazon 商品信息中显示的价格行
Amazon 结果的直接 URL,您可以使用该 URL 确认我们提供的结果准确无误
Amazon 结果的直接 URL;包含返回的 SERP 中找到的所有搜索结果(项目)类型;可能的项目类型:amazon_serp、amazon_paid、editorial_recommendations、top_rated_from_our_brands、related_searches
Amazon SERP 中的结果总数
SERP 数据最后更新的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00
SERP 数据最近一次更新的前一次更新时间,采用 ISO 8601 格式:“YYYY-MM-DDThh:mm:ss.sssssssZ” 示例:2020-09-12T00:07:43.0733218Z
搜索引擎类型
元素类型 = ‘related_searches’
在 type 值相同的元素组内的位置;type 值不同的元素位置不会计入 rank_group。
Amazon SERP 中的绝对排名,即在 SERP 所有元素中的绝对位置
元素在 Amazon SERP 中的对齐方式可取以下值:left、right
元素的 XPath
Amazon 域名
产品标题
产品页面的 URL
产品描述
产品的 ASIN;有关 ASIN 的更多信息,请参阅此帮助中心指南
结果中展示的产品图片 URL
产品的常规价格,例如:49.98
产品价格范围的上限,示例:384.99
ISO 格式的货币,例如:USD
特别优惠详情,包含优惠券和 Subscribe & Save 折扣等特别优惠信息
“Best Seller”标签;如果值为 true,则产品会被标记为“Best Seller”
“Amazon’s choice”标签,如果值为 true,则产品会标有“Amazon’s choice”标签
该条目的评分,即基于评论得出的热度评分,并显示在 SERP 中
评分类型;可使用以下值:Max5、Percents、CustomMax
评级值
反馈数量
rating_type 的最大值
配送信息,包括免费配送和快速配送的日期范围
配送信息;卖家发布的配送信息所附消息
配送价格 根据你在 POST 请求中指定的位置计算的配送价格;如果提供免费配送,则值为 null
当前交割价格
常规未折扣配送价格
未折现最高交割价格
ISO 格式的货币代码
指示配送价格是否为区间
Amazon 商品信息中显示的价格行
包含
元素类型 = ‘related_searches_element’
产品标题
产品页面的 URL
结果中展示的产品图片的 alt 标签
结果中展示的产品图片 URL