亚马逊商品数据、评论与促销 API

按关键词、短语或 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 为空列表。

获取单个 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 错误。

列出一个商品下的所有报价——全新、二手、近新与翻新——并带完整卖家上下文。响应包含完整商品记录（字段与商品详情接口一致）以及 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 翻页。

把任意亚马逊类目（browse node）变成结构化数据。传入数字 category_id——类目链接中的 node 值，如 281407——即可分页浏览该类目商品，支持六种排序、价格区间、品牌列表、仅 Prime、4 星及以上、成色与今日特价筛选；多个类目 ID 可逗号分隔一次查询。每个商品带 asin、标题、现价、原价、评分、评价数、图片、链接、报价数与 Prime / 徽章标记；内置参数覆盖不到的筛选，可用 additional_filters 直接传入从亚马逊搜索链接复制的原始筛选值。

返回指定站点的部门与类目列表，供商品搜索接口的 category_id 参数使用。传入国家即可获得该站点的类目 ID 与名称；各站点取值不同，请为每个要查询的站点分别获取，并在亚马逊调整部门命名时及时刷新。

按 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。

突破商品页限制的深度评论访问：翻页遍历一个商品的全部评论，支持按星级、已验证购买与带图/视频筛选、评论内关键词搜索，以及最有帮助 / 最新两种排序。此接口需要你自己的亚马逊登录会话 Cookie（美国站需包含 session-id、ubid-main、x-main、at-main；其他站点使用对应国家后缀的同名 Cookie）。每条评论含 review_id、标题、完整正文、星级、作者、日期、变体、已验证购买与 Vine 标记，以及图片和视频；响应中的 cursor 字段用于取下一页。

凭 review_id（如 R2FZOU359SHU21）获取一条评论的完整内容，需要你自己的亚马逊登录会话 Cookie。返回完整评论记录——标题、完整正文、星级、作者、日期、图片与视频——适用于审核队列、取证留存，或按需补全评论监控流水线。评论 ID 来自置顶评论或商品评论接口。

把亚马逊各类榜单变成 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。

实时亚马逊促销——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 为步长翻页。

按 deal_id 把一场多商品促销展开成完整商品列表（deal_id 来自促销接口）。用 page 翻页，按推荐、价格、评价、新品或热销排序，遍历促销中的每个 ASIN，每个商品带价格、促销价与促销徽章字段。注意：仅适用于促销链接为 /deal/<id> 形式的多商品促销。

解析亚马逊优惠码——即 amazon.com/promocode/<code> 链接中的那串代码——返回促销详情与适用商品列表。适合在发布前验证优惠码有效性，以及按站点追踪品牌在优惠码活动中投放了哪些商品。

按 seller_id 获取卖家公开主页数据：企业名称、评分与反馈数量、卖家公开的营业地址与联系方式，以及卖家链接。seller_id 可来自商品报价接口或卖家店铺链接——直接传入即可用于合作前审查、欺诈调研或品牌保护取证。

把任意卖家的整个店铺变成可翻页的 JSON：其上架的每个商品带 asin、标题、价格、评分、评价数、图片、链接与 Prime 标记，可按相关度、价格、评价、新品或热销排序。按最新上架轮询可及时发现新 listing；翻完整个目录则可勾勒竞品的商品结构与类目重心。

获取卖家主页的买家反馈流：带日期的逐单星级与买家对物流、包装和服务的评价——与商品评论不同。可按精确星级或 POSITIVE / CRITICAL 情感筛选，并翻页遍历历史（每页最多 5 条）。

获取亚马逊红人店铺（amazon.com/shop/<name>）的公开数据：显示名、简介、头像、发帖数，以及红人已绑定的社交账号——Instagram、YouTube、TikTok、Facebook。按红人店铺名查询，用于充实创作者数据库或合作前背调。

获取红人的可购物帖子——图片、视频与 Idea List 清单——游标翻页，单次最多 100 条。可按内容类型（ALL、IDEA_LISTS、PHOTOS、VIDEOS）筛选，或在创作者帖子内按关键词搜索；响应中的 cursor 用于取下一页。此接口返回的帖子 ID 可直接传给红人清单商品接口，把清单展开成其精选商品。

获取红人 List 类帖子背后的商品清单：传入 post_id（来自红人帖子接口，如 amzn1.ideas.382NVFBNK3GGQ）与红人店铺名，即可拿到清单中每个精选商品，长清单用游标翻页。返回的 ASIN 可直接喂给商品详情接口做增强。

把亚马逊 ASIN 解析为其全球贸易项目代码（GTIN）。响应回显 asin，并返回 results 数组，每项为 value / type 对——按商品不同可能是 UPC、EAN-13 或 ISBN。一个 ASIN 可能对应多个编码，country 参数确保按正确站点目录解析。

反向查询：传入 UPC、EAN 或 ISBN——甚至 SKU、标题或 ASIN——返回匹配的亚马逊商品：asin、标题、图片、链接、价格、星级、评价数、销售排名与排名所属类目。一次调用即可把供应商条码解析为在售亚马逊 listing，直接开始价格与排名筛选。

万能解析器：传入任意亚马逊链接——搜索结果页、商品页、榜单、促销页、评论页、卖家主页或店铺——返回与对应专用接口一致的结构化数据。return_html=true 可同时拿到原始页面 HTML 供自定义提取；需要按地区或登录态查看时可自带 Cookie。