Skip to content

Amazon 商品数据库

概述

Amazon 商品数据库提供及对应商品列表排名数据,适用于电商 SEO、选品分析、竞品监控等场景。数据中商品标题、价格、评分、信息、下的排名位置,以及与搜索结果的字段。

该数据库提供 JSON 格式

  • 数据样例:可联系平台获取美国地区、英文语言的数据库样例
  • 地域与语言列表:可通过接口 /v3/dataforseo_labs/locations_and_languages 获取支持的 location_codelanguage_code

计费说明

该数据库的费用取决于所请求数据库的数据规模地域参数

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

数据结构说明

顶层字段

字段名类型说明
keywordstring,使用 UTF-8 编码
locationinteger地域代码,对应目标地区的唯一标识
languagestring语言代码,对应目标语言的唯一标识
spellstring搜索引擎自动纠正后的;若未发生纠错则为 null
spell_typestring自动纠错类型,可选值:did_you_meanshowing_results_forno_results_found_forincluding_results_for
keyword_infoobject返回的数据
serp_infoobject返回对应的 SERP信息

locationlanguage

可通过以下接口获取支持的地区与语言列表:

  • GET /v3/dataforseo_labs/locations_and_languages

示例:

  • 2840 表示 United States
  • en 表示 English

keyword_info 对象

字段名类型说明
search_volumeinteger该在 Amazon 上的平均月搜索量近似值
time_updatestring数据的最近更新时间,ISO 8601 格式,例如 2020-09-12T00:07:43.0733218Z

serp_info 对象

字段名类型说明
check_urlstring直达搜索结果页的链接,可用于核验返回结果
items_countintegerserp 数组中返回的结果数量
se_results_countintegerSERP 中的总结果数
time_updatestringSERP 数据最近更新时间,ISO 8601 格式
previous_updated_timestring上一次 SERP 更新时间,ISO 8601 格式
item_typesarray当前 SERP 中的结果类型列表
serparray当前下抓取到的 SERP素数据

item_types 可选值

  • amazon_serp
  • amazon_paid
  • editorial_recommendations
  • top_rated_from_our_brands
  • related_searches

serp 数组说明

1) amazon_serp

自然商品结果。

字段名类型说明
typestring素类型,固定为 amazon_serp
urlstring商品页链接
domainstringAmazon 域名
titlestring商品标题
is_best_sellerboolean是否带有 “Best Seller” 标记
image_urlstring搜索结果中的商品图片链接
data_asinstringAmazon 商品唯一标识,示例:B07G82D89J
price_fromfloat商品常规价格
price_tofloat商品价格区间上限;非区间价格时可能为 null
currencystring币种,ISO 4217 格式,例如 USD
ratingobject商品评分信息
is_amazon_choiceboolean是否带有 “Amazon’s choice” 标记
delivery_infoobject送信息、快速和日期范围等
rank_groupinteger在相同 type素组的位置
rank_absoluteinteger在整个 SERP 中的绝对位置
xpathstring素的 XPath
is_firstboolean该 ASIN 是否首次出现在当前自然结果中

rating 对象

字段名类型说明
rating_typestring评分类型,可为 Max5PercentsCustomMax
valuestring / float评分值
votes_countinteger评价数量
rating_maxstring / integer当前评分类型对应的满分值

delivery_info 对象

字段名类型说明
delivery_messagestring卖家展示的文案
delivery_priceobject / null送费用信息;若支持则为 null

delivery_price 对象

字段名类型说明
currentfloat当前价格
regularfloat原始未折扣价格
max_valuefloat未折扣价格上限
currencystring币种,ISO 4217 格式
is_price_rangeboolean是否为价格区间
displayed_pricestringAmazon 页面展示的原始价格文案

2) amazon_paid

广告商品结果。

字段结构与 amazon_serp 基本一致,区别如下:

字段名类型说明
typestring素类型,固定为 amazon_paid
is_firstboolean该 ASIN 是否首次出现在当前广告结果中

余字段含义与 amazon_serp 相同。


3) editorial_recommendations

编辑推荐模块中的商品结果。

字段结构与 amazon_serp 基本一致,区别如下:

字段名类型说明
typestring素类型,固定为 editorial_recommendations
is_firstboolean该 ASIN 是否首次出现在当前编辑推荐模块中

余字段含义与 amazon_serp 相同。


4) top_rated_from_our_brands

品牌自营高评分商品模块中的结果。

字段结构与 amazon_serp 基本一致,区别如下:

字段名类型说明
typestring素类型,固定为 top_rated_from_our_brands
is_firstboolean该 ASIN 是否首次出现在当前模块中

余字段含义与 amazon_serp 相同。


搜索模块。

字段名类型说明
typestring素类型,固定为 related_searches
itemsarray搜索模块中的子列表
字段名类型说明
typestring素类型,固定为 related_searches_element
titlestring商品标题
urlstring商品页链接
image_urlstring商品图片链接
image_altstring商品图片的 alt 文本
rank_groupinteger在相同 type素组的位置
rank_absoluteinteger在整个 SERP 中的绝对位置
xpathstring素 XPath
is_firstboolean该 ASIN 是否首次出现在搜索模块中

获取地区与语言列表

可通过以下接口获取数据库支持的地区与语言:

bash
curl -X GET "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 -H "Authorization: Bearer smt_live_YOUR_KEY"

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",
 "related_searches"
 ],
 "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
 },
 "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?...",
 "domain": "www.amazon.com",
 "title": "C Shaped End Table, Sofa Table, Couch Table",
 "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
 },
 "rank_group": 3,
 "rank_absolute": 25,
 "xpath": "/html/body/div/div/div/div/div/span/div/div",
 "is_first": true
 }
 ]
 }
}

使用说明

该页面描述的是数据库文件结构,不是一个独立的实时查询端点。使用时,通常需要确认:

  1. 目标地区 location
  2. 目标语言 language
  3. 需要消费的数据规模
  4. 下游处理程序是否能解析 serp 中的多种结果类型

如果需要批量消费数据,建议在库时按以下维度拆表或建索引:

  • keyword
  • location
  • language
  • type
  • data_asin
  • rank_absolute
  • time_update

这样可以显著提升后续在选品、广告位分析和排名追踪中的查询效率。

注意事项

  • data_asin 为动态商品标识,不存在固定枚举列表。
  • price_todelivery_pricerating.valuevotes_count 等字段可能为 null
  • 同一 ASIN 可能在同一 SERP 中多次出现,例如同时出现在自然结果和广告结果中;可结合 is_first 判断是否为该模块中的首次出现。
  • rank_group 在相同 type 的结果组连续计数;跨类型比较请使用 rank_absolute
  • check_url 可用于人工核验结果是否与源搜索页一致。
  • 数据中的币种字段统一使用 ISO 4217 标准代码。

代码示例

curl

bash
curl -X GET "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 -H "Authorization: Bearer smt_live_YOUR_KEY"

Python

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY"
}

# 获取支持的地区和语言列表
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json)

TypeScript

typescript
const url = "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages";

async function fetchLocationsAndLanguages {
 // 获取支持的地区和语言列表
 const response = await fetch(url, {
 method: "GET",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY"
 }
 });

 const data = await response.json;
 console.log(response.status);
 console.log(data);
}

fetchLocationsAndLanguages;

实用场景

  • 监控商品排名:按持续跟踪自然位与广告位的 ASIN 排名变化,评估类目竞争强度与机会。
  • 分析竞品价格与策略:结合 price_fromdelivery_infodelivery_price 识别竞品在不同地区的价格带与履约策略,调价和仓决策。
  • 识别广告与自然流量重叠:对比 amazon_serpamazon_paid 中同一 ASIN 的出现,判断品牌是否同时占据自然位和付费位,提高投放效率评估能力。
  • 挖掘高转化商品特征:基于标题、评分、评论数、Best Seller / Amazon’s choice 标签,总结高排名商品的性,用于优化自有商品 Listing。
  • 发现需求与扩展词:利用 related_searches 和纠错字段 spellspell_type,补长尾词和近义需求,扩展站搜索优化与广告投放词库。

统一入口:官网 · LLM API · 控制台