Amazon 产品交集（实时）

POST /v3/dataforseo_labs/amazon/product_keyword_intersections/live

接口说明

POST /v3/dataforseo_labs/amazon/product_keyword_intersections/live

本接口用于查询多个 Amazon 产品在搜索结果页（SERP）中出现的，并返回每个对应的产品排名、商品信息、搜索量等数据。查询范围由请求中的 asins 指定。

ASIN 是 Amazon 商品的唯一标识。接口数据每周更新，最新更新时间可通过 /v3/dataforseo_labs/status 查询。

接口当前支持以下地区：

美国
埃及
沙特阿拉伯
阿拉伯联合长国

请求限制与计费

每个请求按调用次数计费。
每次实时接口调用只能 1 个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准。
同时发送的请求数最多为 30。
请求体使用 UTF-8 编码的 JSON 数组。
参考价约 ¥0.0756 / 次（示例费用供参考）。
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

请求体格式为 JSON 数组：

json

[
  {
    "asins": {
      "1": "B09172433Z",
      "2": "B07GBZ4Q68",
      "3": "B07GCKQD77"
    },
    "location_code": 2840,
    "language_code": "en"
  }
]

参数	类型	填	说明
`asins`	object	是	目标产品的 ASIN 映射。键为自定义序号，值为产品 ASIN。最多指定 20 个 ASIN。
`location_name`	string	条件填	地区名称。未指定 `location_code` 时填，例如 `United States`。
`location_code`	integer	条件填	地区代码。未指定 `location_name` 时填，例如美国为 `2840`。
`language_name`	string	条件填	语言名称。未指定 `language_code` 时填，例如 `English`。
`language_code`	string	条件填	语言代码。未指定 `language_name` 时填，例如 `en`。
`limit`	integer	否	返回结果中的最大数量。默认值为 `100`，最大值为 `1000`。
`intersection_mode`	string	否	ASIN 交集查询模式。可选值：`union`、`intersect`。默认值为 `intersect`。
`filters`	array	否	结果过滤条件。最多设置 8 个过滤条件，并使用 `and` 或 `or` 连接。
`order_by`	array	否	结果排序规则。最多设置 3 条排序规则。
`offset`	integer	否	结果偏移量，默认值为 `0`。例如设置为 `10` 时，将跳过前 10 条结果。
`tag`	string	否	用户自定义任务标识，最长 255 个字符。该值会原样返回在响应的 `data` 对象中。

地区和语言代码可通过以下接口获取：

/v3/dataforseo_labs/locations_and_languages

`asins`

asins须为对象，示例：

json

{
  "1": "019005476X",
  "2": "0190074442"
}

对象中的键用于标识每个目标产品，值是对应的 ASIN。单次请求最多支持 20 个 ASIN。

`intersection_mode`

值	说明
`intersect`	返回所有指定 ASIN 覆盖的，默认值。
`union`	返回任一指定 ASIN 覆盖的。

`filters`

过滤条件使用数组表达式，可同时设置多个条件，最多 8 个。支持以下运算符：

regex、not_regex、<、<=、>、>=、=、<>、in、not_in、ilike、not_ilike、like、not_like、match、not_match

示例：

json

[
  "keyword_info.search_volume",
  ">=",
  100
]

使用 like、not_like、ilike 或 not_ilike 时，可以使用 % 匹零个或多个字符。

多个条件示例：

json

[
  [
    "keyword_info.search_volume",
    ">=",
    100
  ],
  "and",
  [
    "keyword",
    "like",
    "%mouse%"
  ]
]

更多过滤规则可参考：

/v3/dataforseo_labs/filters

`order_by`

order_by 用于设置结果排序，可使用与 filters 相同的字段和表达式。排序方向支持：

asc：升序
desc：降序

示例：

json

[
  "keyword_info.search_volume,desc"
]

多条排序规则使用逗号分隔，单次请求最多设置 3 条：

json

[
  "keyword_info.search_volume,desc",
  "keyword,asc"
]

响应结构

接口返回 JSON 对象 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	请求级状态码。
`status_message`	string	请求级状态信息。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务总数。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

任务字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常在 `10000` 至 `60000` 范围。
`status_message`	string	任务状态信息。
`time`	string	任务执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的结果数量。
`path`	array	请求路径信息。
`data`	object	请求中提交的任务参数。
`result`	array	交集结果。

`result` 字段

字段	类型	说明
`se_type`	string	搜索引擎类型，Amazon 场景下为 `amazon`。
`asins`	object	请求中提交的 ASIN 映射。
`location_code`	integer	请求中的地区代码。无数据时可能为 `null`。
`language_code`	string	请求中的语言代码。无数据时可能为 `null`。
`total_count`	integer	数据库中与请求条件匹的结果总数。
`items_count`	integer	`items` 数组中的结果数量。
`items`	array	及对应的产品交集数据。

`items[].keyword_data`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`keyword`	string	返回的。
`location_code`	integer	对应的地区代码。
`language_code`	string	对应的语言代码。
`keyword_info`	object	指标信息。

`items[].keyword_data.keyword_info`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`last_updated_time`	string	数据更新时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`search_volume`	integer	Amazon 平均月搜索量，为近似值；无数据时可能为 `null`。

`items[].intersection_result`

intersection_result 是对象，键名对应请求中 asins 的序号，例如 "1"、"2"、"3"。每个对象表示该 ASIN 在对应下的 Amazon SERP 信息。

字段	类型	说明
`se_type`	string	搜索引擎类型。
`type`	string	结果类型，固定为 `amazon_serp`。
`rank_group`	integer	在相同 `type`素中的组排名。不同类型不会计此排名。
`rank_absolute`	integer	在 Amazon SERP 中的绝对排名。
`position`	string	SERP 中的对齐位置，可为 `left` 或 `right`。
`xpath`	string	SERP素的 XPath。
`domain`	string	Amazon 域名。
`title`	string	产品标题。
`url`	string	产品页 URL。
`description`	string	产品描述，可能为 `null`。
`asin`	string	产品 ASIN。
`image_url`	string	SERP 中展示的产品图片 URL，可能为 `null`。
`price_from`	float	产品常规起始价格。
`price_to`	float	产品价格区间上限，可能为 `null`。
`currency`	string	ISO 4217 货币代码，例如 `USD`。
`special_offers`	array	特价信息优惠券和订购省等优惠，可能为空。
`is_best_seller`	boolean	是否带有“销商品”标签。
`is_amazon_choice`	boolean	是否带有“Amazon's Choice”标签。
`rating`	object	产品评分信息。
`delivery_info`	object	送信息，可能为 `null`。

`rating`

字段	类型	说明
`rating_type`	string	评分类型，可为 `Max5`、`Percents` 或 `CustomMax`。
`value`	integer	评分值。
`votes_count`	integer	评价数量。
`rating_max`	integer	当前评分类型的最大值。

`delivery_info`

字段	类型	说明
`delivery_message`	string	卖家展示的说明。
`delivery_price`	object	送费用信息。时可能为 `null`。

`delivery_price`

字段	类型	说明
`current`	float	当前价格。
`regular`	float	未折扣的常规价格。
`max_value`	float	未折扣价格区间的最大值。
`currency`	string	ISO 4217 货币代码。
`is_price_range`	boolean	是否为价格区间。
`displayed_price`	string	Amazon 商品列表中原样展示的价格文本。

请求示例

cURL

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_keyword_intersections/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "asins": {
        "1": "B09172433Z",
        "2": "B07GBZ4Q68",
        "3": "B07GCKQD77"
      },
      "location_code": 2840,
      "language_code": "en",
      "limit": 100,
      "intersection_mode": "intersect"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_keyword_intersections/live"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

payload = [
    {
        "asins": {
            "1": "B09172433Z",
            "2": "B07GBZ4Q68",
            "3": "B07GCKQD77",
        },
        "location_name": "United States",
        "language_name": "English",
        "limit": 100,
    }
]

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()

result = response.json()
if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，状态码：%s，信息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

const payload = [
  {
    asins: {
      "1": "B09172433Z",
      "2": "B07GBZ4Q68",
      "3": "B07GCKQD77",
    },
    location_name: "United States",
    language_name: "English",
    limit: 100,
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_keyword_intersections/live",
    payload,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    // 处理接口返回结果
    console.log(response.data);
  })
  .catch((error) => {
    // 处理请求错误
    console.error(error.response?.data || error.message);
  });

响应示例

以下示例展示主要响应结构：

json

{
  "version": "0.1.20220216",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.2532 sec.",
  "cost": 0.0105,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.2450 sec.",
      "cost": 0.0105,
      "result_count": 1,
      "path": [
        "v3",
        "dataforseo_labs",
        "amazon",
        "product_keyword_intersections",
        "live"
      ],
      "data": {
        "api": "dataforseo_labs",
        "function": "product_keyword_intersections",
        "se_type": "amazon",
        "language_name": "English",
        "location_code": 2840,
        "asins": {
          "1": "B09172433Z",
          "2": "B07GBZ4Q68",
          "3": "B07GCKQD77"
        }
      },
      "result": [
        {
          "se_type": "amazon",
          "asins": {
            "1": "B09172433Z",
            "2": "B07GBZ4Q68",
            "3": "B07GCKQD77"
          },
          "location_code": 2840,
          "language_code": "en",
          "total_count": 5,
          "items_count": 5,
          "items": [
            {
              "keyword_data": {
                "se_type": "amazon",
                "keyword": "pc mouse gaming",
                "location_code": 2840,
                "language_code": "en",
                "keyword_info": {
                  "se_type": "amazon",
                  "last_updated_time": "2022-02-05 18:00:12 +00:00",
                  "search_volume": 500
                }
              },
              "intersection_result": {
                "1": {
                  "se_type": "amazon",
                  "type": "amazon_serp",
                  "rank_group": 4,
                  "rank_absolute": 6,
                  "position": "left",
                  "domain": "www.amazon.com",
                  "title": "示例产品标题",
                  "url": "https://www.amazon.com/dp/B09172433Z",
                  "asin": "B09172433Z",
                  "price_from": 12.99,
                  "price_to": 87.98,
                  "currency": "USD",
                  "is_best_seller": false,
                  "is_amazon_choice": false,
                  "rating": {
                    "rating_type": "Max5",
                    "value": 4,
                    "votes_count": 610,
                    "rating_max": 5
                  },
                  "delivery_info": null
                },
                "2": {
                  "se_type": "amazon",
                  "type": "amazon_serp",
                  "rank_group": 1,
                  "rank_absolute": 3,
                  "position": "left",
                  "domain": "www.amazon.com",
                  "title": "示例竞品标题",
                  "url": "https://www.amazon.com/dp/B07GBZ4Q68",
                  "asin": "B07GBZ4Q68",
                  "price_from": 39.9,
                  "price_to": null,
                  "currency": "USD",
                  "is_best_seller": false,
                  "is_amazon_choice": true
                }
              }
            }
          ]
        }
      }
    }
  ]
}

响应中的 cost 为成本数值字段，人民币扣费请读取响应头 X-SeerMarTech-Charge-CNY。应用程序应根据 status_code 和 status_message 处理请求级及任务级异常。

实用场景

挖掘排名：识别多个目标产品同时覆盖的 Amazon 搜索词，用于制定产品标题、五点描述和后台策略。
比较竞品覆盖：分析自有产品与竞品在相同下的排名差异，定位需要提升的搜索结果页位置。
筛选高搜索量交集词：结合 keyword_info.search_volume 和 filters，优提取有流量价值的，提升选词效率。
发现跨产品机会：使用 union 模式汇总任一产品覆盖的，扩展产品页和广告投放的池。
监测排名变化：定期保存 rank_absolute、rank_group 和产品标签等字段，评估 SEO 优化或运营调整的效果。

Amazon 产品交集（实时） ​

接口说明 ​

请求限制与计费 ​

请求参数 ​

asins ​

intersection_mode ​

filters ​

order_by ​

响应结构 ​

顶层字段 ​

任务字段 ​

result 字段 ​

items[].keyword_data ​

items[].keyword_data.keyword_info ​

items[].intersection_result ​

rating ​

delivery_info ​

delivery_price ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

实用场景 ​

Amazon 产品交集（实时）

接口说明

请求限制与计费

请求参数

`asins`

`intersection_mode`

`filters`

`order_by`

响应结构

顶层字段

任务字段

`result` 字段

`items[].keyword_data`

`items[].keyword_data.keyword_info`

`items[].intersection_result`

`rating`

`delivery_info`

`delivery_price`

请求示例

cURL

Python

TypeScript

响应示例

实用场景