亚马逊商品数据、评论与促销 API — 打开交互式演示
引导式在线测试。想要原始接口文档? 查看接口文档 & 测试 →
接口列表
每次调用都会自动附带你的 API Key。
/api/project/amazon/product-search 按关键词搜索亚马逊商品
说明
按关键词、短语或 ASIN 实时搜索亚马逊,返回与买家前台一致的排序结果,干净的 JSON。支持价格区间、品牌列表、成色、仅 Prime、4 星及以上、仅促销、指定卖家与类目等丰富筛选,六种排序与分页。响应包含 total_products 与 products 数组:asin、product_title、product_price、product_original_price、currency、product_star_rating、product_num_ratings、product_url、product_photo、product_num_offers、product_minimum_offer_price、is_best_seller、is_amazon_choice、is_prime、climate_pledge_friendly、sales_volume、delivery、has_variations、product_byline。无结果时返回 HTTP 200,total_products 为 0、products 为空列表。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/product-details 按 ASIN 获取商品详情
说明
获取单个 ASIN 的完整商品页数据,或用逗号分隔一次批量查询最多 10 个 ASIN。每个商品返回 50+ 字段:product_title、product_price、product_original_price、currency、product_star_rating、product_num_ratings、product_availability(如 In Stock)、product_condition、product_num_offers、is_best_seller、is_amazon_choice、is_prime、buy_boxes、sales_volume、about_product 卖点、product_description、product_information(品牌、重量、尺寸、型号)、rating_distribution、product_photos 与 product_videos、product_details、category 与 category_path、product_variations(颜色、尺码、口味)、frequently_bought_together、配送时效与 parent_asin。autoselect_variant=true 可获得准确的变体价格。ASIN 不存在时返回清晰的 Product not found 错误。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/product-offers 获取一个 ASIN 的全部卖家报价
说明
列出一个商品下的所有报价——全新、二手、近新与翻新——并带完整卖家上下文。响应包含完整商品记录(字段与商品详情接口一致)以及 product_offers 数组:product_price、product_original_price、product_condition、ships_from、seller、seller_id、seller_link、seller_star_rating、seller_star_rating_info、currency、delivery_price、delivery_time、promo_text。支持按成色(NEW、USED_LIKE_NEW、USED_VERY_GOOD、USED_GOOD、USED_ACCEPTABLE)或配送方式(PRIME_ELIGIBLE、FREE_DELIVERY)筛选,单次最多批量 10 个 ASIN,用 page 与 limit 翻页。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/products-by-category 按类目列出商品
说明
把任意亚马逊类目(browse node)变成结构化数据。传入数字 category_id——类目链接中的 node 值,如 281407——即可分页浏览该类目商品,支持六种排序、价格区间、品牌列表、仅 Prime、4 星及以上、成色与今日特价筛选;多个类目 ID 可逗号分隔一次查询。每个商品带 asin、标题、现价、原价、评分、评价数、图片、链接、报价数与 Prime / 徽章标记;内置参数覆盖不到的筛选,可用 additional_filters 直接传入从亚马逊搜索链接复制的原始筛选值。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/product-category-list 获取亚马逊部门与类目列表
说明
返回指定站点的部门与类目列表,供商品搜索接口的 category_id 参数使用。传入国家即可获得该站点的类目 ID 与名称;各站点取值不同,请为每个要查询的站点分别获取,并在亚马逊调整部门命名时及时刷新。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
/api/project/amazon/top-product-reviews 获取商品页置顶评论
说明
按 ASIN 获取商品页展示的置顶评论——最有帮助的好评与差评——无需 Cookie。响应包含 asin、rating_distribution(1-5 星分布)与 reviews 数组:review_id、review_title、review_comment、review_star_rating、review_link、review_author、review_author_url、review_author_avatar、review_images、review_video、review_date、is_verified_purchase、helpful_vote_statement、reviewed_product_asin、reviewed_product_variant、is_vine。需要翻页抓取全部评论时,请改用商品评论接口并自带登录会话 Cookie。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/product-reviews 翻页获取商品全部评论
说明
突破商品页限制的深度评论访问:翻页遍历一个商品的全部评论,支持按星级、已验证购买与带图/视频筛选、评论内关键词搜索,以及最有帮助 / 最新两种排序。此接口需要你自己的亚马逊登录会话 Cookie(美国站需包含 session-id、ubid-main、x-main、at-main;其他站点使用对应国家后缀的同名 Cookie)。每条评论含 review_id、标题、完整正文、星级、作者、日期、变体、已验证购买与 Vine 标记,以及图片和视频;响应中的 cursor 字段用于取下一页。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/product-review-details 按 ID 获取单条评论
说明
凭 review_id(如 R2FZOU359SHU21)获取一条评论的完整内容,需要你自己的亚马逊登录会话 Cookie。返回完整评论记录——标题、完整正文、星级、作者、日期、图片与视频——适用于审核队列、取证留存,或按需补全评论监控流水线。评论 ID 来自置顶评论或商品评论接口。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/best-sellers 获取 Best Sellers、飙升榜与新品榜
说明
把亚马逊各类榜单变成 JSON。选一个类目——可以是 software 这样的顶级类目,也可以是 software/229535 这样的子类目路径——再选榜单类型:BEST_SELLERS 畅销榜、NEW_RELEASES 新品榜、MOVERS_AND_SHAKERS 飙升榜、MOST_WISHED_FOR 心愿单榜或 GIFT_IDEAS 礼品创意榜。每页返回 50 个上榜商品:rank、asin、product_title、product_price、product_star_rating、product_num_ratings、product_url、product_photo 与 rank_change_label(飙升榜的升降幅度),以及 category_name。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/deals 获取今日特价与秒杀
说明
实时亚马逊促销——Top Deals、Best Deals 与 Lightning Deals 秒杀——以可筛选的信息流返回。每条促销含 deal_id、deal_type、deal_title、deal_photo、deal_state、deal_url、deal_starts_at 与 deal_ends_at、deal_price 与 list_price(金额加币种)、savings_percentage、savings_amount、deal_badge、product_asin,以及秒杀专属的 percent_claimed 已抢百分比。支持按类目、品牌、价格区间、折扣区间、最低评分、Prime 专享、Prime 提前购或仅秒杀筛选;offset 以 30 为步长翻页。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/deal-products 获取一场促销的全部商品
说明
按 deal_id 把一场多商品促销展开成完整商品列表(deal_id 来自促销接口)。用 page 翻页,按推荐、价格、评价、新品或热销排序,遍历促销中的每个 ASIN,每个商品带价格、促销价与促销徽章字段。注意:仅适用于促销链接为 /deal/<id> 形式的多商品促销。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/promo-code-details 查询优惠码
说明
解析亚马逊优惠码——即 amazon.com/promocode/<code> 链接中的那串代码——返回促销详情与适用商品列表。适合在发布前验证优惠码有效性,以及按站点追踪品牌在优惠码活动中投放了哪些商品。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
/api/project/amazon/seller-profile 获取卖家资料
说明
按 seller_id 获取卖家公开主页数据:企业名称、评分与反馈数量、卖家公开的营业地址与联系方式,以及卖家链接。seller_id 可来自商品报价接口或卖家店铺链接——直接传入即可用于合作前审查、欺诈调研或品牌保护取证。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/seller-products 列出卖家店铺全部商品
说明
把任意卖家的整个店铺变成可翻页的 JSON:其上架的每个商品带 asin、标题、价格、评分、评价数、图片、链接与 Prime 标记,可按相关度、价格、评价、新品或热销排序。按最新上架轮询可及时发现新 listing;翻完整个目录则可勾勒竞品的商品结构与类目重心。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/seller-reviews 获取卖家反馈
说明
获取卖家主页的买家反馈流:带日期的逐单星级与买家对物流、包装和服务的评价——与商品评论不同。可按精确星级或 POSITIVE / CRITICAL 情感筛选,并翻页遍历历史(每页最多 5 条)。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/influencer-profile 获取亚马逊红人资料
说明
获取亚马逊红人店铺(amazon.com/shop/<name>)的公开数据:显示名、简介、头像、发帖数,以及红人已绑定的社交账号——Instagram、YouTube、TikTok、Facebook。按红人店铺名查询,用于充实创作者数据库或合作前背调。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/influencer-posts 列出红人的帖子
说明
获取红人的可购物帖子——图片、视频与 Idea List 清单——游标翻页,单次最多 100 条。可按内容类型(ALL、IDEA_LISTS、PHOTOS、VIDEOS)筛选,或在创作者帖子内按关键词搜索;响应中的 cursor 用于取下一页。此接口返回的帖子 ID 可直接传给红人清单商品接口,把清单展开成其精选商品。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/influencer-post-products 获取红人清单帖中的商品
说明
获取红人 List 类帖子背后的商品清单:传入 post_id(来自红人帖子接口,如 amzn1.ideas.382NVFBNK3GGQ)与红人店铺名,即可拿到清单中每个精选商品,长清单用游标翻页。返回的 ASIN 可直接喂给商品详情接口做增强。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
/api/project/amazon/asin-to-gtin ASIN 转 UPC / EAN / ISBN
说明
把亚马逊 ASIN 解析为其全球贸易项目代码(GTIN)。响应回显 asin,并返回 results 数组,每项为 value / type 对——按商品不同可能是 UPC、EAN-13 或 ISBN。一个 ASIN 可能对应多个编码,country 参数确保按正确站点目录解析。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/amazon/gtin-to-asin 按 UPC / EAN / ISBN 查亚马逊商品
说明
反向查询:传入 UPC、EAN 或 ISBN——甚至 SKU、标题或 ASIN——返回匹配的亚马逊商品:asin、标题、图片、链接、价格、星级、评价数、销售排名与排名所属类目。一次调用即可把供应商条码解析为在售亚马逊 listing,直接开始价格与排名筛选。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
/api/project/amazon/scrape-by-url 任意亚马逊链接转 JSON
说明
万能解析器:传入任意亚马逊链接——搜索结果页、商品页、榜单、促销页、评论页、卖家主页或店铺——返回与对应专用接口一致的结构化数据。return_html=true 可同时拿到原始页面 HTML 供自定义提取;需要按地区或登录态查看时可自带 Cookie。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |