一、接口类型与功能

1. Product Advertising API（PA-API）
   • 用途：获取商品详情、搜索商品列表，适用于电商数据分析、商品推荐等场景。
   • 功能：
     • 商品基本信息：标题、描述、图片URL、品牌、分类等。
     • 购买属性：价格、库存状态、发货信息、促销活动（如优惠券、满减）。
     • 用户反馈：评价内容、评分、晒图数量。
     • 分类与销售数据：一级/二级分类、销售排名、变体信息（如不同颜色/尺寸的SKU）。
2. Selling Partner API（SP-API）
   • 用途：面向卖家，提供更全面的商品管理功能（如库存同步、订单处理），同时支持商品详情获取。
   • 特点：需OAuth 2.0认证，支持多市场（如美国、欧洲站点），数据返回更详细（如包含商品属性、物流信息）。

二、调用流程

1. 注册与认证

• 注册开发者账号：
  访问 亚马逊开发者中心，完成个人或企业信息提交，获取API访问权限。
• 创建应用：
  在开发者中心创建应用，生成  Client ID、 Client Secret、 Refresh Token 等凭证。
• SP-API认证：
  使用OAuth 2.0流程获取  Access Token（有效期24小时），通过  Refresh Token 定期刷新。

2. 选择API端点

• PA-API常用端点：
  • ItemLookup：通过ASIN或ISBN获取单个商品详情。
  • ItemSearch：通过关键词、分类、价格范围等搜索商品列表。
• SP-API商品详情端点：
  • /products/v0/itemTypes/{asin}：获取商品基础信息、图片、价格、变体等。
  • /products/v0/listings/{sellerId}/{asin}：获取卖家自定义的商品信息（如库存、价格）。

3. 构建请求

• 请求参数：
  • 必需参数： ASIN（商品唯一标识）、 MarketplaceId（目标站点ID，如美国站为  ATVPDKIKX0DER）。
  • 可选参数： ResponseGroup（PA-API中指定返回数据类型，如  Images,ItemAttributes,Offers）、 includedData（SP-API中指定返回字段，如  images,price,description）。
• 示例请求（PA-API）：

  pythonimport requestsimport hmacimport hashlibimport base64from datetime import datetimeaccess_key = 'YOUR_ACCESS_KEY'secret_key = 'YOUR_SECRET_KEY'asin = 'B000012345'# 构建请求参数params = {'Service': 'AWSECommerceService','Operation': 'ItemLookup','ResponseGroup': 'ItemAttributes,Offers,Images','IdType': 'ASIN','ItemId': asin,'AWSAccessKeyId': access_key,'Timestamp': datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ')}# 生成签名string_to_sign = '\n'.join(['GET','webservices.amazon.com','/onca/xml','\n'.join([f'{k}={v}' for k, v in sorted(params.items())])])signature = base64.b64encode(hmac.new(secret_key.encode(), string_to_sign.encode(), hashlib.sha256).digest()).decode()params['Signature'] = signature# 发送请求response = requests.get('https://webservices.amazon.com/onca/xml', params=params)print(response.text)

4. 处理响应

• 数据格式：
  PA-API默认返回XML，可通过参数指定为JSON；SP-API直接返回JSON。
• 关键字段解析：

  json{"Items": {"Item": [{"ASIN": "B000012345","DetailPageURL": "https://www.amazon.com/dp/B000012345","ItemAttributes": {"Title": "Example Product","Brand": "Example Brand","ListPrice": {"Amount": 199.99,"CurrencyCode": "USD"}},"Offers": {"Offer": {"OfferListing": {"Price": {"Amount": 179.99,"CurrencyCode": "USD"},"Availability": "In Stock"}}}}]}}

三、注意事项

1. 频率限制：
   • PA-API：免费版每小时最多1次请求/ASIN，专业版可提升至更高限额。
   • SP-API：根据卖家账号类型分配额度，需监控  x-amzn-RateLimit-Limit 响应头。
2. 错误处理：
   • 常见错误码： 400（参数错误）、 403（权限不足）、 429（频率超限）。
   • 建议实现重试机制（如指数退避）和日志记录。
3. 数据更新延迟：
   • 价格、库存等数据可能存在15分钟延迟，需结合实时性需求设计缓存策略。
4. 合规性：
   • 禁止爬取非公开数据或绕过API限制，避免账号被封禁。

四、应用场景

• 电商数据分析：监控竞品价格、评价趋势，优化选品策略。
• 价格监控工具：实时跟踪商品价格变化，触发降价提醒或自动调价。
• 商品推荐系统：根据用户浏览历史，推荐相关商品（如“购买此商品的用户也买了…”）。
• 自动化营销：结合用户行为数据，发送个性化促销邮件（如弃单挽回）。

通过合理调用亚马逊商品详情API，开发者可高效获取结构化数据，支撑各类电商业务创新。实际开发中需结合具体需求选择接口类型，并严格遵守亚马逊的使用条款。