Skip to main content
POST
关键词交集
此端点将提供目标商品在 Amazon SERP 中相交的关键词列表。返回结果特定于 POST 请求中指定的 asins。有关 ASIN 的更多信息,请参阅此帮助中心文章。

示例

授权

Authorization
string
header
必填

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

请求体

application/json
asins
object
必填

目标产品的 asins;必填字段;需要查找关键词交集的产品 ID;请按以下示例指定 ASIN:"asins": { "1": "019005476X", "2": "0190074442" };此对象中最多可指定 20 个 ASIN;有关此参数的更多信息,请参阅此帮助中心页面

location_name
string
必填

位置的完整名称;如果未指定 location_code,则为必填字段。您可以向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发出请求,以获取可用位置及其 location_name 列表;注意:此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国;示例:United Kingdom

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

limit
integer

结果数组中的最大产品数量,可选字段,默认值:100;最大值:1000

intersection_mode
string

查找 asin 交集的模式,可选字段。可选值:union、intersect;默认值:intersect;有关此参数的更多信息,请参阅此帮助中心指南

filters
string[]

结果过滤参数数组,可选字段;可以同时添加多个过滤器(最多 8 个);应在条件之间设置逻辑运算符 and、or;支持以下运算符:regex, not_regex, , , >, >=, =, , in, not_in, ilike, not_ilike, like, not_like, match, not_match;可以将 % 运算符与 like 和 not_like,以及 ilike 和 not_ilike 配合使用,以匹配由零个或多个字符组成的任意字符串;示例:["avg_position",";有关过滤器的更多信息,请参阅 Dataforseo Labs – Filters 或此帮助中心指南

order_by
string[]

结果排序规则 可选字段 可使用与 filters 数组中相同的值对结果进行排序 支持的排序类型:asc – 结果将按升序排列 desc – 结果将按降序排列 应使用逗号设置排序参数 示例:["sum_position,desc"] 请注意,单次请求最多可设置三条排序规则 应使用逗号分隔多条排序规则 示例:["intersections,desc","avg_position,asc"] 默认规则:["intersections,desc"]

offset
integer

返回关键词的结果数组中的偏移量,可选字段,默认值:0。如果指定值 10,结果数组中的前十个关键词将被省略,并提供后续关键词的数据

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.asins
object

POST 数组中的 ASIN

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[]

包含检测到的 Amazon 产品竞争对手及相关数据

tasks.result.items.keyword_data
object

返回关键词的关键词数据

tasks.result.items.keyword_data.se_type
string

搜索引擎类型

tasks.result.items.keyword_data.keyword
string

返回的关键词

tasks.result.items.keyword_data.location_code
integer

在 POST 数组中的位置

tasks.result.items.keyword_data.language_code
string

POST 数组中的 language

tasks.result.items.keyword_data.keyword_info
object

返回关键词的关键词数据

tasks.result.items.keyword_data.keyword_info.se_type
string

搜索引擎类型

tasks.result.items.keyword_data.keyword_info.last_updated_time
string

keyword 数据更新的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

tasks.result.items.keyword_data.keyword_info.search_volume
integer

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

tasks.result.items.intersection_result
object

交集数据

tasks.result.items.intersection_result.$asin_number
object

POST 请求中某个 ASIN 的交集数据

tasks.result.items.intersection_result.$asin_number.se_type
string

搜索引擎类型

tasks.result.items.intersection_result.$asin_number.type
string

元素类型 = ‘amazon_serp’

tasks.result.items.intersection_result.$asin_number.rank_group
integer

在 type 值相同的元素组内的位置;type 值不同的元素位置不会计入 rank_group。

tasks.result.items.intersection_result.$asin_number.rank_absolute
integer

Amazon SERP 中的绝对排名,即在 SERP 所有元素中的绝对位置

tasks.result.items.intersection_result.$asin_number.position
string

元素在 Amazon SERP 中的对齐方式可取以下值:left、right

tasks.result.items.intersection_result.$asin_number.xpath
string

元素的 XPath

tasks.result.items.intersection_result.$asin_number.domain
string

Amazon 域名

tasks.result.items.intersection_result.$asin_number.title
string

产品标题

tasks.result.items.intersection_result.$asin_number.url
string

产品页面的 URL

tasks.result.items.intersection_result.$asin_number.description
string

产品描述

tasks.result.items.intersection_result.$asin_number.asin
string

产品的 ASIN;有关 ASIN 的更多信息,请参阅此帮助中心指南

tasks.result.items.intersection_result.$asin_number.image_url
string

结果中展示的产品图片 URL

tasks.result.items.intersection_result.$asin_number.price_from
number

产品的常规价格,例如:49.98

tasks.result.items.intersection_result.$asin_number.price_to
number

产品价格范围的上限,示例:384.99

tasks.result.items.intersection_result.$asin_number.currency
string

ISO 格式的货币,例如:USD

tasks.result.items.intersection_result.$asin_number.special_offers
string[]

特别优惠详情,包含优惠券和 Subscribe & Save 折扣等特别优惠信息

tasks.result.items.intersection_result.$asin_number.is_best_seller
boolean

“Best Seller”标签;如果值为 true,则产品会被标记为“Best Seller”

tasks.result.items.intersection_result.$asin_number.is_amazon_choice
boolean

“Amazon’s choice”标签,如果值为 true,则产品会标有“Amazon’s choice”标签

tasks.result.items.intersection_result.$asin_number.rating
object

该条目的评分,即基于评论得出的热度评分,并显示在 SERP 中

tasks.result.items.intersection_result.$asin_number.rating.rating_type
string

评分类型;可使用以下值:Max5、Percents、CustomMax

tasks.result.items.intersection_result.$asin_number.rating.value
integer

评级值

tasks.result.items.intersection_result.$asin_number.rating.votes_count
integer

反馈数量

tasks.result.items.intersection_result.$asin_number.rating.rating_max
integer

rating_type 的最大值

tasks.result.items.intersection_result.$asin_number.delivery_info
object

配送信息,包括免费配送和快速配送的日期范围

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_message
string

配送信息;卖家发布的配送信息所附消息

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price
object

配送价格 根据你在 POST 请求中指定的位置计算的配送价格;如果提供免费配送,则值为 null

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.current
number

当前交割价格

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.regular
number

常规未折扣配送价格

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.max_value
number

未折现最高交割价格

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.currency
string

ISO 格式的货币代码

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.is_price_range
boolean

指示配送价格是否为区间

tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.displayed_price
string

Amazon 商品信息中显示的价格行