Amazon Real Product Api

Amazon Real Product Api

原始信息汇总

Amazon Real Product API 数据集概述

基本信息

• 数据集名称: Amazon Real Product Api
• 提供平台: RapidAPI
• 类别: eCommerce
• 提供商: SmartCloud
• 订阅计划:
  • BASIC: $0.00 / 月
  • PRO: $19.99 / 月
  • ULTRA: $59.99 / 月

功能描述

此API允许用户创建网页抓取任务并获取亚马逊产品信息，包括标题、价格、图片和规格。

基础URL

https://your-api-host.com

认证方式

所有API请求均需通过RapidAPI头部进行认证：

• X-RapidAPI-Key: 您的RapidAPI订阅密钥
• X-RapidAPI-Host: API主机标识符

端点详情

1. 创建任务

为亚马逊产品创建抓取任务。支持批量处理多个ASIN。

请求

• 方法: POST
• 路径: /create-task
• 必需头部:
  • Content-Type: application/json
  • X-RapidAPI-Key: 您的API密钥
  • X-RapidAPI-Host: API主机

请求体字段

字段	类型	必需	描述
platform	string	是	平台类型。值: amazon
productIds	array	是	产品ID（ASINs）数组
platformParams	object	是	平台特定参数
platformParams.countryCode	string	是	国家代码（US, DE, JP, UK等）
platformParams.zipcode	string	否	用于特定位置定价的邮政编码

响应字段

字段	类型	描述
message	string	操作结果消息
summary.added	integer	新添加的任务数量
summary.duplicate	integer	重复任务数量（7天内）
summary.total	integer	请求的任务总数
tasks	array	任务详情列表
tasks[].productId	string	产品ID（ASIN）
tasks[].platform	string	平台类型
tasks[].status	string	任务状态: added 或 duplicate
tasks[].jobId	string	队列作业ID（仅限已添加的任务）
tasks[].createdAt	string	创建时间戳（ISO 8601）

响应码

• 200: 任务处理成功
• 400: 错误请求 - 参数无效
• 500: 内部服务器错误

2. 按产品ID获取结果

通过产品ID（ASIN）检索抓取结果。

请求

• 方法: GET
• 路径: /getResultByProductId
• 查询参数:
  • productId (string, 必需): 产品ID（ASIN）
  • platform (string, 必需): 平台类型。值: amazon
  • countryCode (string, 必需): 国家代码（US, DE, JP, UK等）

响应字段

字段	类型	描述
id	integer	结果ID
taskId	string	关联的任务ID
platform	string	平台类型
productId	string	产品ID（ASIN）
title	string	产品标题
images	array	原始图片URL
description	string	产品描述
priceList	array	价格信息列表
priceList[].price	string	价格值
priceList[].priceName	string	价格类型（例如，标价）
priceList[].stock	string	库存状态
priceList[].shipping	string	配送信息
priceList[].deliveryTime	string	预计送达时间
currency	string	货币代码
specifications	array	产品规格
platformData	object	平台特定的原始数据
createdAt	string	创建时间戳（ISO 8601）
updatedAt	string	更新时间戳（ISO 8601）

响应码

• 200: 结果检索成功
• 400: 错误请求 - 参数无效
• 404: 结果未找到
• 500: 内部服务器错误

支持的国家/地区

代码	国家/地区	亚马逊域名
US	美国	amazon.com
UK	英国	amazon.co.uk
DE	德国	amazon.de
FR	法国	amazon.fr
JP	日本	amazon.co.jp
CA	加拿大	amazon.ca
AU	澳大利亚	amazon.com.au

错误处理

错误响应格式 json { "error": "错误消息描述", "validPlatforms": ["amazon"], "errors": ["详细错误1", "详细错误2"], "required": ["platform", "productIds"] }

常见错误

错误	原因	解决方案
Invalid or missing platform parameter	缺少或平台无效	使用 amazon 作为平台值
Invalid input, expected productIds array	productIds 不是数组	提供ASINs数组
Missing required parameters	缺少 countryCode	在 platformParams 中包含 countryCode
Result not found	产品尚未抓取	先创建任务，等待处理