Amazon 國際商品詳情 API（主要指Product Advertising API v5，PA-API v5）是獲取全球亞馬遜商品數(shù)據(jù)的核心接口，返回值為 JSON 格式，包含商品基礎(chǔ)信息、價格、庫存、評價等多維度數(shù)據(jù)。以下按核心數(shù)據(jù)模塊詳細解析返回值字段及業(yè)務(wù)含義，適用于跨境電商選品、價格監(jiān)控、競品分析等場景：
一、頂層結(jié)構(gòu)與基礎(chǔ)標識
PA-API v5 的返回值以Items數(shù)組為核心，每個元素代表一個商品，頂層包含請求狀態(tài)與元數(shù)據(jù)：
{
"Items": [/* 商品詳情數(shù)組 */],
"RequestId": "xxx-xxx-xxx", // 請求唯一標識（用于排查問題）
"Errors": [] // 錯誤信息（無錯誤時為空數(shù)組）
}二、核心數(shù)據(jù)模塊與字段解析
1. 商品基礎(chǔ)標識（唯一識別與定位）
| 字段路徑 | 類型 | 說明 | 業(yè)務(wù)價值 |
|---|---|---|---|
| Items[].ASIN | string | 亞馬遜標準識別號（全球唯一，10 位字符） | 商品唯一標識，用于后續(xù)查詢評論、價格等 |
| Items[].DetailPageURL | string | 商品詳情頁 URL（帶地區(qū)前綴，如https://www.amazon.com/dp/B07VGRJDFY） | 直接跳轉(zhuǎn)商品頁面，用于前端展示 |
| Items[].ParentASIN | string | 父 ASIN（變體商品的主標識，如同一商品的不同顏色共享一個 ParentASIN） | 識別變體關(guān)系，獲取全系列商品數(shù)據(jù) |
2. 商品信息（標題、描述、分類）
| 字段路徑 | 類型 | 說明 | 示例 |
|---|---|---|---|
| Items[].ItemInfo.Title.DisplayValue | string | 商品標題（含品牌、型號、核心特性） | "Apple AirPods Pro 2 with MagSafe Charging Case" |
| Items[].ItemInfo.Brand.DisplayValue | string | 品牌名稱 | "Apple" |
| Items[].ItemInfo.ProductTypeName | string | 亞馬遜內(nèi)部商品類型（用于分類） | "WIRELESS_HEADPHONES" |
| Items[].ItemInfo.Features.DisplayValues | array | 核心功能列表（bullet points） | ["主動降噪", "空間音頻", "防水等級 IP54"] |
| Items[].ItemInfo.Description.DisplayValue | string | 詳細描述（HTML 格式，含規(guī)格、使用說明） | "<p>主動降噪技術(shù)可阻隔 90% 環(huán)境噪音...</p>" |
3. 圖片資源（多尺寸與變體圖）
| 字段路徑 | 類型 | 說明 | 應(yīng)用場景 |
|---|---|---|---|
| Items[].Images.Primary.Large.URL | string | 主圖 URL（大尺寸，通常 800x800 像素） | 商品列表頁主圖展示 |
| Items[].Images.Variants | array | 變體圖片數(shù)組（如不同顏色 / 角度的圖片） | 展示商品多維度外觀 |
| Items[].Images.Primary.Small.URL | string | 小圖 URL（通常 100x100 像素） | 縮略圖展示，節(jié)省加載帶寬 |
4. 技術(shù)規(guī)格與屬性（細分參數(shù)）
| 字段路徑 | 類型 | 說明 | 示例 |
|---|---|---|---|
| Items[].ItemInfo.TechnicalInfo.TechnicalDetails | array | 技術(shù)參數(shù)鍵值對 | [{"Name":"電池續(xù)航","Value":"6 小時"}, {"Name":"藍牙版本","Value":"5.3"}] |
| Items[].ItemInfo.Color.DisplayValue | string | 顏色 | "White"、"星空藍" |
| Items[].ItemInfo.Size.DisplayValue | string | 尺寸 | "One Size"、"XL" |
| Items[].ItemInfo.Weight.DisplayValue | string | 重量（帶單位） | "150 grams"、"0.3 磅" |
5. 變體商品信息（多規(guī)格商品）
對于有多個規(guī)格（如顏色、尺寸）的商品，返回Variations字段：
{
"Variations": {
"Items": [
{
"ASIN": "B016LO4UTA", // 變體ASIN（具體規(guī)格的唯一標識）
"ItemInfo": {
"Color": {"DisplayValue": "White"},
"Size": {"DisplayValue": "M"}
},
"Offers": {
"Listings": [{"Price": {"DisplayAmount": "$249.99"}}]
}
},
// 更多變體...
]
}
}三、關(guān)鍵使用說明
- 地區(qū)差異：
- 不同國家站點（美國、德國、日本等）的字段可能有本地化差異（如貨幣、語言、配送規(guī)則）。
- 調(diào)用時需指定
Marketplace參數(shù)（如www.amazon.com對應(yīng)美國，www.amazon.co.jp對應(yīng)日本）。
四、示例：提取核心商品數(shù)據(jù)（Python）
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請求示例 url 默認請求參數(shù)已經(jīng)做URL編碼
# 封裝好API供應(yīng)商demo url=o0b.cn/ibrad 復(fù)制鏈接test
url = "https://api-gw.cn/amazon/item_get/?key=自己的key&secret=秘鑰&num_iid=B016LO4UTA&domain=com"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)通過解析以上字段，可全面獲取亞馬遜國際商品的核心信息，支撐跨境電商選品決策、價格監(jiān)控、競品分析等業(yè)務(wù)場景。實際使用時需結(jié)合具體國家站點的特性，合理處理本地化數(shù)據(jù)與異常情況。
