> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 关键词交集

> 此端点将提供目标产品在 Amazon SERP 中存在交集的关键词列表。



## OpenAPI

````yaml openapi/zh/dataforseo.json POST /dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live
openapi: 3.0.3
info:
  title: DataForSEO API
  version: 1.0.0
  description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live:
    post:
      summary: 关键词交集
      description: >-
        此端点将提供目标商品在 Amazon SERP 中相交的关键词列表。返回结果特定于 POST 请求中指定的 `asins`。有关 ASIN
        的更多信息，请参阅[此帮助中心文章。](https://dataforseo.com/help-center/asin-in-amazon-api)
      operationId: >-
        post_dataforseo_dataforseo_labs_amazon_product_keyword_intersections_live
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                asins:
                  type: object
                  description: >-
                    目标产品的 asins；必填字段；需要查找关键词交集的产品 ID；请按以下示例指定 ASIN："asins": {
                    "1": "019005476X", "2": "0190074442" }；此对象中最多可指定 20 个
                    ASIN；有关此参数的更多信息，请参阅此帮助中心页面
                location_name:
                  type: string
                  description: >-
                    位置的完整名称；如果未指定 location_code，则为必填字段。您可以向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发出请求，以获取可用位置及其 location_name
                    列表；注意：此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国；示例：United Kingdom
                location_code:
                  type: integer
                  description: >-
                    位置代码；如果未指定 location_name，则为必填字段；您可以通过向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发出请求，获取可用位置及其 location_code
                    的列表；注意：此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置；示例：2840
                language_name:
                  type: string
                  description: >-
                    语言全名 必填字段 如果未指定 language_code，可以向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发送请求，以获取可用语言及其 language_name 的列表 示例：English
                language_code:
                  type: string
                  description: >-
                    语言代码；如果未指定 language_name，则为必填字段；可通过向
                    https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
                    单独发起请求，获取可用语言及其 language_code 列表；示例：en
                limit:
                  type: integer
                  description: 结果数组中的最大产品数量，可选字段，默认值：100；最大值：1000
                intersection_mode:
                  type: string
                  description: >-
                    查找 asin
                    交集的模式，可选字段。可选值：union、intersect；默认值：intersect；有关此参数的更多信息，请参阅此帮助中心指南
                filters:
                  type: array
                  items:
                    type: string
                  description: >-
                    结果过滤参数数组，可选字段；可以同时添加多个过滤器（最多 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:
                  type: array
                  items:
                    type: string
                  description: >-
                    结果排序规则 可选字段 可使用与 filters 数组中相同的值对结果进行排序 支持的排序类型：asc –
                    结果将按升序排列 desc – 结果将按降序排列 应使用逗号设置排序参数
                    示例：["sum_position,desc"] 请注意，单次请求最多可设置三条排序规则 应使用逗号分隔多条排序规则
                    示例：["intersections,desc","avg_position,asc"]
                    默认规则：["intersections,desc"]
                offset:
                  type: integer
                  description: >-
                    返回关键词的结果数组中的偏移量，可选字段，默认值：0。如果指定值
                    10，结果数组中的前十个关键词将被省略，并提供后续关键词的数据
                tag:
                  type: string
                  description: >-
                    用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data
                    对象中找到指定的 tag 值
              required:
                - asins
                - location_name
                - location_code
                - language_name
                - language_code
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    type: string
                    description: API 的当前版本
                  status_code:
                    type: integer
                    description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况
                  status_message:
                    type: string
                    description: 常规信息消息；可在此处查看常规信息消息的完整列表
                  time:
                    type: string
                    description: 执行时间（秒）
                  cost:
                    type: number
                    description: 任务总成本（美元）
                  tasks_count:
                    type: integer
                    description: tasks 数组中的任务数量
                  tasks_error:
                    type: integer
                    description: 返回错误的 tasks 数组中的任务数量
                  tasks:
                    type: array
                    items:
                      type: string
                    description: 任务数组
                  tasks.id:
                    type: string
                    description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符
                  tasks.status_code:
                    type: integer
                    description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看
                  tasks.status_message:
                    type: string
                    description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表
                  tasks.time:
                    type: string
                    description: 执行时间（秒）
                  tasks.cost:
                    type: number
                    description: 任务成本（美元）
                  tasks.result_count:
                    type: integer
                    description: 结果数组中的元素数量
                  tasks.path:
                    type: array
                    items:
                      type: string
                    description: URL 路径
                  tasks.data:
                    type: object
                    description: 包含您在 POST 请求中指定的相同参数
                  tasks.result:
                    type: array
                    items:
                      type: string
                    description: 结果数组
                  tasks.result.se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks.result.asins:
                    type: object
                    description: POST 数组中的 ASIN
                  tasks.result.location_code:
                    type: integer
                    description: POST 数组中的位置代码；如果没有数据，则值为 null
                  tasks.result.language_code:
                    type: string
                    description: POST 数组中的语言代码；如果没有数据，则值为 null
                  tasks.result.total_count:
                    type: integer
                    description: 数据库中与您的请求相关的结果总量
                  tasks.result.items_count:
                    type: integer
                    description: items 数组中返回的结果数量
                  tasks.result.items:
                    type: array
                    items:
                      type: string
                    description: 包含检测到的 Amazon 产品竞争对手及相关数据
                  tasks.result.items.keyword_data:
                    type: object
                    description: 返回关键词的关键词数据
                  tasks.result.items.keyword_data.se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks.result.items.keyword_data.keyword:
                    type: string
                    description: 返回的关键词
                  tasks.result.items.keyword_data.location_code:
                    type: integer
                    description: 在 POST 数组中的位置
                  tasks.result.items.keyword_data.language_code:
                    type: string
                    description: POST 数组中的 language
                  tasks.result.items.keyword_data.keyword_info:
                    type: object
                    description: 返回关键词的关键词数据
                  tasks.result.items.keyword_data.keyword_info.se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks.result.items.keyword_data.keyword_info.last_updated_time:
                    type: string
                    description: >-
                      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:
                    type: integer
                    description: 平均每月搜索量，表示返回的关键词在 Amazon 上的（近似）搜索次数
                  tasks.result.items.intersection_result:
                    type: object
                    description: 交集数据
                  tasks.result.items.intersection_result.$asin_number:
                    type: object
                    description: POST 请求中某个 ASIN 的交集数据
                  tasks.result.items.intersection_result.$asin_number.se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks.result.items.intersection_result.$asin_number.type:
                    type: string
                    description: 元素类型 = ‘amazon_serp’
                  tasks.result.items.intersection_result.$asin_number.rank_group:
                    type: integer
                    description: 在 type 值相同的元素组内的位置；type 值不同的元素位置不会计入 rank_group。
                  tasks.result.items.intersection_result.$asin_number.rank_absolute:
                    type: integer
                    description: Amazon SERP 中的绝对排名，即在 SERP 所有元素中的绝对位置
                  tasks.result.items.intersection_result.$asin_number.position:
                    type: string
                    description: 元素在 Amazon SERP 中的对齐方式可取以下值：left、right
                  tasks.result.items.intersection_result.$asin_number.xpath:
                    type: string
                    description: 元素的 XPath
                  tasks.result.items.intersection_result.$asin_number.domain:
                    type: string
                    description: Amazon 域名
                  tasks.result.items.intersection_result.$asin_number.title:
                    type: string
                    description: 产品标题
                  tasks.result.items.intersection_result.$asin_number.url:
                    type: string
                    description: 产品页面的 URL
                  tasks.result.items.intersection_result.$asin_number.description:
                    type: string
                    description: 产品描述
                  tasks.result.items.intersection_result.$asin_number.asin:
                    type: string
                    description: 产品的 ASIN；有关 ASIN 的更多信息，请参阅此帮助中心指南
                  tasks.result.items.intersection_result.$asin_number.image_url:
                    type: string
                    description: 结果中展示的产品图片 URL
                  tasks.result.items.intersection_result.$asin_number.price_from:
                    type: number
                    description: 产品的常规价格，例如：49.98
                  tasks.result.items.intersection_result.$asin_number.price_to:
                    type: number
                    description: 产品价格范围的上限，示例：384.99
                  tasks.result.items.intersection_result.$asin_number.currency:
                    type: string
                    description: ISO 格式的货币，例如：USD
                  tasks.result.items.intersection_result.$asin_number.special_offers:
                    type: array
                    items:
                      type: string
                    description: 特别优惠详情，包含优惠券和 Subscribe & Save 折扣等特别优惠信息
                  tasks.result.items.intersection_result.$asin_number.is_best_seller:
                    type: boolean
                    description: “Best Seller”标签；如果值为 true，则产品会被标记为“Best Seller”
                  tasks.result.items.intersection_result.$asin_number.is_amazon_choice:
                    type: boolean
                    description: “Amazon’s choice”标签，如果值为 true，则产品会标有“Amazon’s choice”标签
                  tasks.result.items.intersection_result.$asin_number.rating:
                    type: object
                    description: 该条目的评分，即基于评论得出的热度评分，并显示在 SERP 中
                  tasks.result.items.intersection_result.$asin_number.rating.rating_type:
                    type: string
                    description: 评分类型；可使用以下值：Max5、Percents、CustomMax
                  tasks.result.items.intersection_result.$asin_number.rating.value:
                    type: integer
                    description: 评级值
                  tasks.result.items.intersection_result.$asin_number.rating.votes_count:
                    type: integer
                    description: 反馈数量
                  tasks.result.items.intersection_result.$asin_number.rating.rating_max:
                    type: integer
                    description: rating_type 的最大值
                  tasks.result.items.intersection_result.$asin_number.delivery_info:
                    type: object
                    description: 配送信息，包括免费配送和快速配送的日期范围
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_message:
                    type: string
                    description: 配送信息；卖家发布的配送信息所附消息
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price:
                    type: object
                    description: 配送价格 根据你在 POST 请求中指定的位置计算的配送价格；如果提供免费配送，则值为 null
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.current:
                    type: number
                    description: 当前交割价格
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.regular:
                    type: number
                    description: 常规未折扣配送价格
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.max_value:
                    type: number
                    description: 未折现最高交割价格
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.currency:
                    type: string
                    description: ISO 格式的货币代码
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.is_price_range:
                    type: boolean
                    description: 指示配送价格是否为区间
                  tasks.result.items.intersection_result.$asin_number.delivery_info.delivery_price.displayed_price:
                    type: string
                    description: Amazon 商品信息中显示的价格行
        '400':
          description: 错误请求
        '401':
          description: 未授权
        '429':
          description: 超出速率限制
        '500':
          description: 内部服务器错误
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````