Amazon 国际商品详情 API（主要指Product Advertising API v5，PA-API v5）是获取全球亚马逊商品数据的核心接口，返回值为 JSON 格式，包含商品基础信息、价格、库存、评价等多维度数据。以下按核心数据模块详细解析返回值字段及业务含义，适用于跨境电商选品、价格监控、竞品分析等场景：
一、顶层结构与基础标识
PA-API v5 的返回值以Items数组为核心，每个元素代表一个商品，顶层包含请求状态与元数据：
{
"Items": [/* 商品详情数组 */],
"RequestId": "xxx-xxx-xxx", // 请求唯一标识（用于排查问题）
"Errors": [] // 错误信息（无错误时为空数组）
}二、核心数据模块与字段解析
1. 商品基础标识（唯一识别与定位）
| 字段路径 | 类型 | 说明 | 业务价值 |
|---|---|---|---|
| Items[].ASIN | string | 亚马逊标准识别号（全球唯一，10 位字符） | 商品唯一标识，用于后续查询评论、价格等 |
| Items[].DetailPageURL | string | 商品详情页 URL（带地区前缀，如https://www.amazon.com/dp/B07VGRJDFY） | 直接跳转商品页面，用于前端展示 |
| Items[].ParentASIN | string | 父 ASIN（变体商品的主标识，如同一商品的不同颜色共享一个 ParentASIN） | 识别变体关系，获取全系列商品数据 |
2. 商品信息（标题、描述、分类）
| 字段路径 | 类型 | 说明 | 示例 |
|---|---|---|---|
| Items[].ItemInfo.Title.DisplayValue | string | 商品标题（含品牌、型号、核心特性） | "Apple AirPods Pro 2 with MagSafe Charging Case" |
| Items[].ItemInfo.Brand.DisplayValue | string | 品牌名称 | "Apple" |
| Items[].ItemInfo.ProductTypeName | string | 亚马逊内部商品类型（用于分类） | "WIRELESS_HEADPHONES" |
| Items[].ItemInfo.Features.DisplayValues | array | 核心功能列表（bullet points） | ["主动降噪", "空间音频", "防水等级 IP54"] |
| Items[].ItemInfo.Description.DisplayValue | string | 详细描述（HTML 格式，含规格、使用说明） | "<p>主动降噪技术可阻隔 90% 环境噪音...</p>" |
3. 图片资源（多尺寸与变体图）
| 字段路径 | 类型 | 说明 | 应用场景 |
|---|---|---|---|
| Items[].Images.Primary.Large.URL | string | 主图 URL（大尺寸，通常 800x800 像素） | 商品列表页主图展示 |
| Items[].Images.Variants | array | 变体图片数组（如不同颜色 / 角度的图片） | 展示商品多维度外观 |
| Items[].Images.Primary.Small.URL | string | 小图 URL（通常 100x100 像素） | 缩略图展示，节省加载带宽 |
4. 技术规格与属性（细分参数）
| 字段路径 | 类型 | 说明 | 示例 |
|---|---|---|---|
| Items[].ItemInfo.TechnicalInfo.TechnicalDetails | array | 技术参数键值对 | [{"Name":"电池续航","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. 变体商品信息（多规格商品）
对于有多个规格（如颜色、尺寸）的商品，返回Variations字段：
{
"Variations": {
"Items": [
{
"ASIN": "B016LO4UTA", // 变体ASIN（具体规格的唯一标识）
"ItemInfo": {
"Color": {"DisplayValue": "White"},
"Size": {"DisplayValue": "M"}
},
"Offers": {
"Listings": [{"Price": {"DisplayAmount": "$249.99"}}]
}
},
// 更多变体...
]
}
}三、关键使用说明
- 地区差异：
- 不同国家站点（美国、德国、日本等）的字段可能有本地化差异（如货币、语言、配送规则）。
- 调用时需指定
Marketplace参数（如www.amazon.com对应美国，www.amazon.co.jp对应日本）。
四、示例：提取核心商品数据（Python）
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
# 封装好API供应商demo url=o0b.cn/ibrad 复制链接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)通过解析以上字段，可全面获取亚马逊国际商品的核心信息，支撑跨境电商选品决策、价格监控、竞品分析等业务场景。实际使用时需结合具体国家站点的特性，合理处理本地化数据与异常情况。
