Real-time Amazon Data — 实时亚马逊数据

Amazon Data 技能 使用此技能通过 Canopy API REST 端点使用 Python 检索 Amazon 产品数据。Canopy API 提供对 350M+ Amazon 产品的实时访问，跨越 25K+ 类别。使用此技能，您可以获取：

产品详细信息 — 标题、描述、价格、图像、功能子弹和品牌信息 销售和库存估计 — 每周、每月和年度销售单位，以及当前库存水平 评论 — 评分、评论文本、已验证购买状态和有用投票数 搜索 — 按关键字查找产品，带有价格、条件、类别和排序顺序的过滤器 报价 — 比较多个卖家的价格和履行详细信息 优惠 — 浏览 12 个国际域的当前 Amazon 优惠和折扣 类别 — 导航完整的 Amazon 类别分类法 卖家和作者 — 查找卖家配置文件、评分和作者书目

设置 在 canopyapi.co 注册并创建帐户 从仪表板获取 API 密钥 在环境中设置 API 密钥：export API_KEY="your_api_key_here" 基础 URL https://rest.canopyapi.co 身份验证 所有请求都需要 API-KEY 标头：

import os
import requests
API_KEY = os.environ["API_KEY"]
BASE_URL = "https://rest.canopyapi.co"
HEADERS = {"API-KEY": API_KEY}

端点 获取产品信息

response = requests.get(f"{BASE_URL}/api/amazon/product", headers=HEADERS, params={
    "asin": "B01HY0JA3G",  # 或使用 "url" 或 "gtin"
    "domain": "US",  # 可选，缺省为 "US"
})

返回产品标题、品牌、价格、评分、图像、功能子弹、类别和卖家信息。 获取产品变体

response = requests.get(f"{BASE_URL}/api/amazon/product/variants", headers=HEADERS, params={
    "asin": "B01HY0JA3G",
})

获取库存估计

response = requests.get(f"{BASE_URL}/api/amazon/product/stock", headers=HEADERS, params={
    "asin": "B01HY0JA3G",
})

获取销售估计

response = requests.get(f"{BASE_URL}/api/amazon/product/sales", headers=HEADERS, params={
    "asin": "B01HY0JA3G",
})

返回每周、每月和年度销售单位估计。 获取产品评论

response = requests.get(f"{BASE_URL}/api/amazon/product/reviews", headers=HEADERS, params={
    "asin": "B01HY0JA3G",
})

获取产品报价

response = requests.get(f"{BASE_URL}/api/amazon/product/offers", headers=HEADERS, params={
    "asin": "B01HY0JA3G",
    "page": 1,  # 可选
})

搜索产品

response = requests.get(f"{BASE_URL}/api/amazon/search", headers=HEADERS, params={
    "searchTerm": "wireless headphones",
    "domain": "US",  # 可选
    "page": 1,  # 可选
    "limit": 20,  # 可选，20-40
    "minPrice": 10,  # 可选
    "maxPrice": 100,  # 可选
    "conditions": "NEW",  # 可选：NEW, USED, RENEWED（逗号分隔）
    "sort": "FEATURED",  # 可选：FEATURED, MOST_RECENT, PRICE_ASCENDING, PRICE_DESCENDING, AVERAGE_CUSTOMER_REVIEW
})

获取自动完成建议

response = requests.get(f"{BASE_URL}/api/amazon/autocomplete", headers=HEADERS, params={
    "searchTerm": "wireless",
})

获取类别分类法

response = requests.get(f"{BASE_URL}/api/amazon/categories", headers=HEADERS, params={
    "domain": "US",  # 可选
})

获取类别信息

response = requests.get(f"{BASE_URL}/api/amazon/category", headers=HEADERS, params={
    "categoryId": "1234567890",
    "domain": "US",  # 可选
    "page": 1,  # 可选
    "sort": "FEATURED",  # 可选
})

获取卖家信息

response = requests.get(f"{BASE_URL}/api/amazon/seller", headers=HEADERS, params={
    "sellerId": "A2R2RITDJNW1Q6",
    "domain": "US",  # 可选
    "page": 1,  # 可选
})

获取作者信息

response = requests.get(f"{BASE_URL}/api/amazon/author", headers=HEADERS, params={
    "asin": "B000AQ5RM0",
    "domain": "US",  # 可选
    "page": 1,  # 可选
})

获取优惠

response = requests.get(f"{BASE_URL}/api/amazon/deals", headers=HEADERS, params={
    "domain": "US",  # 可选：US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP
    "page": 1,  # 可选
    "limit": 20,  # 可选
})

产品查找选项 产品端点接受以下标识符之一： 参数 描述 示例 asin Amazon 产品 ASIN B01HY0JA3G url 完整 Amazon 产品 URL https://amazon.com/dp/B01HY0JA3G gtin ISBN、UPC 或 EAN 代码 9780141036144 支持的域 US（默认）、UK、CA、DE、FR、IT、ES、AU、IN、MX、BR、JP 错误处理 状态 含义 400 无效参数 401 无效或缺失 API 密钥 402 需要付款 500 服务器错误

response = requests.get(f"{BASE_URL}/api/amazon/product", headers=HEADERS, params={"asin": "B01HY0JA3G"})
if response.ok:
    data = response.json()
else:
    print(f"Error {response.status_code}: {response.text}")