主题
Amazon 商品数据库
概述
Amazon 商品数据库提供及对应商品列表排名数据,适用于电商 SEO、选品分析、竞品监控等场景。数据中商品标题、价格、评分、信息、下的排名位置,以及与搜索结果的字段。
该数据库提供 JSON 格式。
- 数据样例:可联系平台获取美国地区、英文语言的数据库样例
- 地域与语言列表:可通过接口
/v3/dataforseo_labs/locations_and_languages获取支持的location_code和language_code
计费说明
该数据库的费用取决于所请求数据库的数据规模与地域参数。
扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
数据结构说明
顶层字段
| 字段名 | 类型 | 说明 |
|---|---|---|
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 | 返回对应的 SERP信息 |
location 与 language
可通过以下接口获取支持的地区与语言列表:
GET /v3/dataforseo_labs/locations_and_languages
示例:
2840表示United Statesen表示English
keyword_info 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
search_volume | integer | 该在 Amazon 上的平均月搜索量近似值 |
time_update | string | 数据的最近更新时间,ISO 8601 格式,例如 2020-09-12T00:07:43.0733218Z |
serp_info 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
check_url | string | 直达搜索结果页的链接,可用于核验返回结果 |
items_count | integer | serp 数组中返回的结果数量 |
se_results_count | integer | SERP 中的总结果数 |
time_update | string | SERP 数据最近更新时间,ISO 8601 格式 |
previous_updated_time | string | 上一次 SERP 更新时间,ISO 8601 格式 |
item_types | array | 当前 SERP 中的结果类型列表 |
serp | array | 当前下抓取到的 SERP素数据 |
item_types 可选值
amazon_serpamazon_paideditorial_recommendationstop_rated_from_our_brandsrelated_searches
serp 数组说明
1) amazon_serp素
自然商品结果。
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 amazon_serp |
url | string | 商品页链接 |
domain | string | Amazon 域名 |
title | string | 商品标题 |
is_best_seller | boolean | 是否带有 “Best Seller” 标记 |
image_url | string | 搜索结果中的商品图片链接 |
data_asin | string | Amazon 商品唯一标识,示例:B07G82D89J |
price_from | float | 商品常规价格 |
price_to | float | 商品价格区间上限;非区间价格时可能为 null |
currency | string | 币种,ISO 4217 格式,例如 USD |
rating | object | 商品评分信息 |
is_amazon_choice | boolean | 是否带有 “Amazon’s choice” 标记 |
delivery_info | object | 送信息、快速和日期范围等 |
rank_group | integer | 在相同 type素组的位置 |
rank_absolute | integer | 在整个 SERP 中的绝对位置 |
xpath | string | 素的 XPath |
is_first | boolean | 该 ASIN 是否首次出现在当前自然结果中 |
rating 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
rating_type | string | 评分类型,可为 Max5、Percents、CustomMax |
value | string / float | 评分值 |
votes_count | integer | 评价数量 |
rating_max | string / integer | 当前评分类型对应的满分值 |
delivery_info 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
delivery_message | string | 卖家展示的文案 |
delivery_price | object / null | 送费用信息;若支持则为 null |
delivery_price 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
current | float | 当前价格 |
regular | float | 原始未折扣价格 |
max_value | float | 未折扣价格上限 |
currency | string | 币种,ISO 4217 格式 |
is_price_range | boolean | 是否为价格区间 |
displayed_price | string | Amazon 页面展示的原始价格文案 |
2) amazon_paid素
广告商品结果。
字段结构与 amazon_serp 基本一致,区别如下:
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 amazon_paid |
is_first | boolean | 该 ASIN 是否首次出现在当前广告结果中 |
余字段含义与 amazon_serp 相同。
3) editorial_recommendations素
编辑推荐模块中的商品结果。
字段结构与 amazon_serp 基本一致,区别如下:
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 editorial_recommendations |
is_first | boolean | 该 ASIN 是否首次出现在当前编辑推荐模块中 |
余字段含义与 amazon_serp 相同。
4) top_rated_from_our_brands素
品牌自营高评分商品模块中的结果。
字段结构与 amazon_serp 基本一致,区别如下:
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 top_rated_from_our_brands |
is_first | boolean | 该 ASIN 是否首次出现在当前模块中 |
余字段含义与 amazon_serp 相同。
5) related_searches素
搜索模块。
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 related_searches |
items | array | 搜索模块中的子列表 |
related_searches.items 子
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 related_searches_element |
title | string | 商品标题 |
url | string | 商品页链接 |
image_url | string | 商品图片链接 |
image_alt | string | 商品图片的 alt 文本 |
rank_group | integer | 在相同 type素组的位置 |
rank_absolute | integer | 在整个 SERP 中的绝对位置 |
xpath | string | 素 XPath |
is_first | boolean | 该 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
}
]
}
}使用说明
该页面描述的是数据库文件结构,不是一个独立的实时查询端点。使用时,通常需要确认:
- 目标地区
location - 目标语言
language - 需要消费的数据规模
- 下游处理程序是否能解析
serp中的多种结果类型
如果需要批量消费数据,建议在库时按以下维度拆表或建索引:
keywordlocationlanguagetypedata_asinrank_absolutetime_update
这样可以显著提升后续在选品、广告位分析和排名追踪中的查询效率。
注意事项
data_asin为动态商品标识,不存在固定枚举列表。price_to、delivery_price、rating.value、votes_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_from、delivery_info、delivery_price识别竞品在不同地区的价格带与履约策略,调价和仓决策。 - 识别广告与自然流量重叠:对比
amazon_serp与amazon_paid中同一 ASIN 的出现,判断品牌是否同时占据自然位和付费位,提高投放效率评估能力。 - 挖掘高转化商品特征:基于标题、评分、评论数、Best Seller / Amazon’s choice 标签,总结高排名商品的性,用于优化自有商品 Listing。
- 发现需求与扩展词:利用
related_searches和纠错字段spell、spell_type,补长尾词和近义需求,扩展站搜索优化与广告投放词库。