Amazon 商品数据库

GET /v3/dataforseo_labs/locations_and_languages

Amazon 商品数据库提供亚马逊搜索结果中的与商品排名数据商品标题、价格、评分、信息、针对指定的排名位置等。

本数据库提供 JSON 格式。

本页为数据库结构说明，不定义独立的实时查询接口路径。数据库文件中的数据结构如下。

> 数据库样例及支持的地点、语言列表请参考本平台的数据库资源说明。可用的地点和语言以接口返回结果为准。

计费说明

费用取决于数据库的规模和地点参数。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

地点与语言代码

可通过以下接口获取支持的地点和语言列表：

http

GET https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages

location 使用地点代码，例如 2840 表示美国。
language 使用指定地点支持的语言代码，例如 en 表示英语。
编码统一使用 UTF-8。

数据库字段

顶层字段

字段	类型	说明
`keyword`	string	返回结果对应的，使用 UTF-8 编码。
`location`	integer	地点代码，是对应地点的唯一标识。
`language`	string	语言代码，是指定地点可用语言的唯一标识。
`spell`	string	搜索引擎自动修正后的。如果搜索引擎对原始进行了修正，则返回修正后的及修正提示；未修正时通常为 `null`。
`spell_type`	string	自动修正类型。可选值：`did_you_mean`、`showing_results_for`、`no_results_found_for`、`including_results_for`。
`keyword_info`	object	返回的数据。
`serp_info`	object	返回对应的搜索结果页数据。

`keyword_info` 对象

字段	类型	说明
`search_volume`	integer	亚马逊上该的平均月搜索量，为估算值。
`time_update`	string	数据的最后更新时间，使用 ISO 8601 格式，例如 `2020-09-12T00:07:43.0733218Z`。

`serp_info` 对象

字段	类型	说明
`check_url`	string	搜索结果页的直接 URL，可用于核验返回结果。
`items_count`	integer	`serp` 数组中返回的结果数量。
`se_results_count`	integer	搜索结果页中的结果总数。
`time_update`	string	搜索结果数据的最后更新时间，使用 ISO 8601 格式。
`previous_updated_time`	string	搜索结果数据上一次更新的时间，使用 ISO 8601 格式。
`item_types`	array	当前搜索结果页中的结果类型。
`serp`	array	当前对应的搜索结果数组。

item_types 可能以下值：

amazon_serp：自然搜索结果
amazon_paid：付费搜索结果
editorial_recommendations：编辑推荐
top_rated_from_our_brands：品牌精选高评分商品
related_searches：搜索商品

`serp` 商品结果字段

amazon_serp、amazon_paid、editorial_recommendations 和 top_rated_from_our_brands 类型的商品使用相同的基础字段。

字段	类型	说明
`type`	string	结果类型，分别为 `amazon_serp`、`amazon_paid`、`editorial_recommendations` 或 `top_rated_from_our_brands`。
`url`	string	商品页 URL。
`domain`	string	亚马逊域名。
`title`	string	商品标题。
`is_best_seller`	boolean	是否带有“销商品”标签。为 `true` 时表示商品带有该标签。
`image_url`	string	搜索结果中展示的商品图片 URL。
`data_asin`	string	亚马逊商品的唯一标识符。该值由亚马逊动态分，不存在固定的完整枚举列表。例如：`B07G82D89J`。
`price_from`	float	商品常规起始价格。例如：`49.98`。
`price_to`	float	商品价格区间的上限。例如：`384.99`。无价格区间时通常为 `null`。
`currency`	string	价格币种，使用 ISO 4217 格式，例如 `USD`。
`rating`	object	商品评分信息。
`is_amazon_choice`	boolean	是否带有“亚马逊之选”标签。为 `true` 时表示商品带有该标签。
`delivery_info`	object	送信息、快速及日期范围；无信息时为 `null`。
`displayed_price`	string	亚马逊商品列表中展示的原始价格文本。
`rank_group`	integer	在相同 `type` 结果中的分组排名。不同 `type`素之间不会合并计算此排名。
`rank_absolute`	integer	在整个搜索结果页所有中的绝对排名。
`xpath`	string	结果在页面中的 XPath。
`is_first`	boolean	该 ASIN 是否首次出现在当前结果区域中。为 `true` 表示首次出现；为 `false` 表示此前已在同一结果区域中出现。

不同结果类型中的 `is_first` 含义

`type`	`is_first` 的判断范围
`amazon_serp`	ASIN 是否首次出现在自然搜索结果中。
`amazon_paid`	ASIN 是否首次出现在付费搜索结果中。
`editorial_recommendations`	ASIN 是否首次出现在编辑推荐区域中。
`top_rated_from_our_brands`	ASIN 是否首次出现在品牌精选高评分区域中。

`rating` 对象

字段	类型	说明
`rating_type`	string	评分类型。可能为 `Max5`、`Percents` 或 `CustomMax`。
`value`	string / number	商品评分值。无评分时可能为 `null`。
`votes_count`	integer	商品收到的评价数量。无评价数据时可能为 `null`。
`rating_max`	string / number	对应 `rating_type` 的最大评分值。

`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	亚马逊列表中展示的原始价格文本。

`related_searches` 结果字段

当 type 为 related_searches 时，该搜索商品数组。

字段	类型	说明
`type`	string	固定为 `related_searches`。
`items`	array	搜索商品数组。

`related_searches.items`素

字段	类型	说明
`type`	string	固定为 `related_searches_element`。
`title`	string	商品标题。
`url`	string	商品页 URL。
`image_url`	string	商品图片 URL。
`image_alt`	string	商品图片的 `alt` 文本。
`rank_group`	integer	在相同类型结果中的分组排名。
`rank_absolute`	integer	在整个搜索结果页中的绝对排名。
`xpath`	string	结果在页面中的 XPath。
`is_first`	boolean	该商品是否首次出现在搜索区域中。为 `true` 表示首次出现；为 `false` 表示此前已在同一区域中出现。

JSON 数据示例

以下示例展示一个及部分搜索结果数据。数据库文件可能更多结果和字段。

json

{
  "keyword": "glass c shaped side table",
  "location": 2840,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 0,
    "time_update": "2023-07-03T00:18:03.5381554Z"
  },
  "serp_info": {
    "check_url": "https://www.amazon.com/s?k=glass+c+shaped+side+table",
    "items_count": 68,
    "se_results_count": 1319,
    "time_update": "2023-06-20T04:55:25.5122172Z",
    "previous_updated_time": "2023-05-17T14:51:59.9706599Z",
    "item_types": [
      "amazon_serp",
      "amazon_paid"
    ],
    "serp": [
      {
        "type": "amazon_serp",
        "url": "https://www.amazon.com/HOOBRO-Shaped-Tempered-Modern-GD03SF01/dp/B09X37V65V",
        "domain": "www.amazon.com",
        "title": "C Shaped End Table, Tempered Glass Snack Side Table with Metal Frame",
        "is_best_seller": false,
        "image_url": "https://m.media-amazon.com/images/I/61V+f-c7vNL._AC_UL400_.jpg",
        "data_asin": "B09X37V65V",
        "price_from": 39.99,
        "price_to": null,
        "currency": "USD",
        "rating": {
          "rating_type": "Max5",
          "value": 4.4,
          "votes_count": 276,
          "rating_max": 5
        },
        "is_amazon_choice": false,
        "delivery_info": {
          "delivery_message": "FREE delivery Sat, Jun 24 Or fastest delivery Fri, Jun 23",
          "delivery_price": null
        },
        "displayed_price": "$39.99",
        "rank_group": 1,
        "rank_absolute": 2,
        "xpath": "/html/body/div/div/div/div/div/span/div/div",
        "is_first": true
      },
      {
        "type": "amazon_paid",
        "url": "https://www.amazon.com/sspa/click?url=%2Fproduct%2Fdp%2FB0BG4S2S6N",
        "domain": "www.amazon.com",
        "title": "C Shaped End Table with Charging Station",
        "is_best_seller": false,
        "image_url": "https://m.media-amazon.com/images/I/81fAF1FhuNL._AC_UL400_.jpg",
        "data_asin": "B0BG4S2S6N",
        "price_from": 49.98,
        "price_to": null,
        "currency": "USD",
        "rating": {
          "rating_type": "Max5",
          "value": 4.5,
          "votes_count": 31,
          "rating_max": 5
        },
        "is_amazon_choice": false,
        "delivery_info": {
          "delivery_message": "FREE delivery Mon, Jun 26",
          "delivery_price": null
        },
        "displayed_price": "$49.98",
        "rank_group": 3,
        "rank_absolute": 25,
        "xpath": "/html/body/div/div/div/div/div/span/div/div",
        "is_first": true
      }
    ]
  }
}

数据处理注意事项

data_asin 是动态商品标识，不应根据固定枚举值校验。
price_to、评分值、评价数量及价格字段可能为 null。
delivery_info 整体可能为 null；时，delivery_price 通常为 null。
rank_group 在相同 type 的结果中计算。
rank_absolute 反映在完整搜索结果页中的绝对位置。
搜索引擎可能自动修正，应结合 spell 和 spell_type 判断返回。
check_url 可用于抽样核验搜索结果，但页面可能因时间、地点、登录状态或个性化因素发生变化。

实用场景

监控商品自然排名：按、地点和语言批量记录 ASIN 的 rank_absolute，评估商品在亚马逊自然搜索中的变化。
分析竞品价格区间：提取 price_from、price_to 和 currency，比较竞品定价、价格带分布与自身商品的市场位置。
评估商品口碑竞争力：结合 rating.value、rating_max 和 votes_count，筛选高评分、高评价量的竞品商品。
识别付费搜索竞争：区分 amazon_serp 与 amazon_paid，统计下的广告商品数量、排名和商品重复出现。
优化跨地点选品策略：结合地点代码、价格、文案和搜索结果排名，比较不同市场的需求、价格与履约竞争状况。

Amazon 商品数据库 ​

计费说明 ​

地点与语言代码 ​

数据库字段 ​

顶层字段 ​

keyword_info 对象 ​

serp_info 对象 ​

serp 商品结果字段 ​

不同结果类型中的 is_first 含义 ​

rating 对象 ​

delivery_info 对象 ​

delivery_price 对象 ​

related_searches 结果字段 ​

related_searches.items素 ​

JSON 数据示例 ​

数据处理注意事项 ​

实用场景 ​