> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # 商品搜索 > 按关键词或 ASIN 搜索 Amazon 商品，支持按分类、价格、品牌、Prime、评分和折扣等条件筛选，并返回商品列表、总数、站点和域名信息。适用于选品、竞品分析和价格监测。
🪙 3 credits每次请求
## Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

## OpenAPI ````yaml zh/amazon.zh.openapi.json GET /v1/amazon/search openapi: 3.0.1 info: title: Amazon API 中文文档 description: Amazon API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。 version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production security: [] tags: [] paths: /v1/amazon/search: get: tags: [] summary: 商品搜索 description: >- 按关键词或 ASIN 搜索 Amazon 商品，支持按分类、价格、品牌、Prime、评分和折扣等条件筛选，并返回商品列表、总数、站点和域名信息。适用于选品、竞品分析和价格监测。 parameters: - name: query in: query description: 搜索关键词或 Amazon ASIN，可用于普通文本搜索或直接查询指定商品。 required: true example: Phone schema: type: string example: Phone - name: page in: query description: 结果页码，从第 1 页开始。 required: false example: 1 schema: type: number default: 1 - name: country in: query description: >- Amazon 站点/市场国家代码，同时影响域名、币种和默认语言。 可选值: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES, TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE required: false example: US schema: type: string default: US - name: sort_by in: query description: >- 排序方式，可按相关性、价格、评论数、新品或畅销等维度排序。 可选值: `RELEVANCE`, `LOWEST_PRICE`, `HIGHEST_PRICE`, `REVIEWS`, `NEWEST`, `BEST_SELLERS` required: false example: RELEVANCE schema: type: string default: RELEVANCE - name: category_id in: query description: >- 查找特定类别/部门的产品（如计算机- intship）。使用Product Category List端点获取请求中指定的国家的有效类别及其id的列表。对于数字Amazon类别id，请使用category参数 required: false example: aps schema: type: string default: aps - name: category in: query description: >- 按特定的数字亚马逊类别过滤。category ID可从Amazon分类结果URL中获取，例如：`https://amazon.com/s?node=2858778013` Amazon分类ID为2858778013。多个类别值可以使用英文逗号分隔（例如：categoryId1,categoryId2）。 required: false schema: type: string - name: min_price in: query description: 只返回价格大于一定价值的产品报价。以所选国家的货币指定。例如，如果country=US，值105.34表示$105.34 required: false example: 1 schema: type: number default: 1 - name: max_price in: query description: 只返回价格低于一定价值的产品报价。以所选国家的货币指定。例如，如果country=US，值105.34表示$105.34 required: false example: 1000 schema: type: number default: 1000 - name: product_condition in: query description: >- 商品成色筛选，例如全新、二手、翻新或收藏品；不同接口支持的取值可能不同。可选值：ALL, NEW, USED, RENEWED, COLLECTIBLE required: false example: ALL schema: type: string default: ALL - name: brand in: query description: >- 寻找特定品牌的产品。多个品牌可以逗号（,）分隔。品牌价值可以从亚马逊的搜索左侧过滤器面板中看到，[如下图所示](https://www.amazon.com/s?k=phone) 示例： SAMSUNG Google,Apple required: false example: SAMSUNG schema: type: string example: Google,Apple - name: seller_id in: query description: |- Amazon 卖家（商家） ID，查找特定卖家（商家）销售的产品。多个卖家可以指定为逗号（,）分隔。 示例： A02211013Q5HP3OMSZC7W AM7YCCDZROLB2,a1d09s7q0od6 required: false schema: type: string example: AM7YCCDZROLB2,a1d09s7q0od6 - name: is_prime in: query description: 仅返回 Prime 的商品。 required: false example: 'false' schema: type: boolean default: false - name: deals_and_discounts in: query description: 优惠筛选，可选择不筛选、全部折扣或 Today's Deals。可选值：NONE、ALL_DISCOUNTS、TODAYS_DEALS required: false example: NONE schema: type: string default: NONE - name: four_stars_and_up in: query description: 是否仅返回评分 4 星及以上的商品。 required: false schema: type: boolean - name: language in: query description: |- 返回结果的语言代码；如果未指定，结果将以默认域语言返回。 可选值： US: en_US, es_US AU: en_AU BR: pt_BR CA: en_CA, fr_CA FR: fr_FR, en_GB DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN IT: it_IT, en_GB MX: es_MX NL: nl_NL, en_GB SG: en_SG ES: es_ES, pt_PT, en_GB TR: tr_TR AE: en_AE, ar_AE GB: en_GB JP: ja_JP, en_US, zh_CN SA: ar_AE, en_AE PL: pl_PL SE: sv_SE, en_GB BE: fr_BE, nl_BE, en_GB EG: ar_AE, en_AE ZA: en_ZA IE: en_IE required: false schema: type: string example: en_US - name: additional_filters in: query description: >- Amazon 页面上的扩展筛选条件，这些筛选条件可以从 Amazon 搜索结果页面 URL 中的 rh 参数获取，多个筛选值用英文逗号分隔。 方法是：先在 Amazon 搜索页面选择所需的筛选条件，然后从地址栏 URL 中提取 `rh` 参数的值。 例如：可以在Amazon页面上搜索`science books`，并选择 Paperback（平装） 筛选条件后，Amazon 搜索链接如下`https://www.amazon.com/s?k=science+books&rh=p_n_feature_browse-bin%3A2656022011`其中`rh = p_n_feature_browse-bin%3A2656022011`，如果需要筛选 Paperback（平装） 图书，请将接口参数设置为：`additional_parameters=p_n_feature_browse-bin%3A2656022011` required: false schema: type: string - name: fields in: query description: 字段投影配置，使用逗号分隔需要返回的字段；未传时返回默认完整字段。 required: false schema: type: string responses: '200': description: 请求成功 content: application/json: schema: type: object properties: {} example: code: 0 message: success data: total_products: 2684 country: US domain: www.amazon.com products: - asin: B0G4SW3XXP product_title: >- Samsung Galaxy S26 Ultra, Unlocked Android Smartphone, 512GB, Privacy Display, Galaxy AI, AI Camera, Super Fast Charging 3.0, Durable Battery, 2026, US 1 Year Warranty, Black product_price: $1,299.99 product_original_price: $1,499.99 currency: USD product_star_rating: null product_num_ratings: 0 product_url: https://www.amazon.com/dp/B0G4SW3XXP product_photo: >- https://m.media-amazon.com/images/I/61UnzIc+97L._AC_UY654_QL65_.jpg product_num_offers: 1 product_minimum_offer_price: $1,299.99 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: New on Amazon in past month delivery: >- FREE deliveryThis item will be released on March 11, 2026. has_variations: true product_badge: Limited time deal - asin: B0DM1S54MZ product_title: >- Samsung Galaxy A16 4G LTE (128GB + 4GB) International Model SM-A165F/DS Factory Unlocked, 6.7", Dual SIM, 50MP Triple Camera (Case Bundle), Black product_price: $127.50 product_original_price: null currency: USD product_star_rating: '4.3' product_num_ratings: 3412 product_url: https://www.amazon.com/dp/B0DM1S54MZ product_photo: >- https://m.media-amazon.com/images/I/61Lp1UcxeLL._AC_UY654_QL65_.jpg product_num_offers: 1 product_minimum_offer_price: $127.50 is_best_seller: false is_amazon_choice: true is_prime: false climate_pledge_friendly: false sales_volume: 3K+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: true product_badge: Overall Pick - asin: B0DT4T8D65 product_title: >- SAMSUNG Galaxy A16 4G LTE (128GB + 4GB) International Model SM-A165F/DS Factory Unlocked 6.7" Dual Sim 50MP Dual Cam (Case Bundle) (Gray) product_price: $124.69 product_original_price: null currency: USD product_star_rating: '4.3' product_num_ratings: 3412 product_url: https://www.amazon.com/dp/B0DT4T8D65 product_photo: >- https://m.media-amazon.com/images/I/51jEBZHYs3L._AC_UY654_QL65_.jpg product_num_offers: 14 product_minimum_offer_price: $109.50 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 1K+ bought in past month delivery: FREE delivery Tue, Mar 10Or fastest delivery Sat, Mar 7 has_variations: true book_formats: - asin: B0DT4T8D65 format: Another way to buy - asin: B0DT4T8D65 format: >- Price product page$129.50$129.50 FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 - asin: B0FXY1DZ78 product_title: >- Samsung Galaxy A17 5G Smart Phone, 128GB, Large AMOLED, High-Res Camera, Durable Design, Super Fast Charging, Expandable Storage, Circle to Search, 2025, US 1 Yr Manufacturer Warranty, Blue product_price: $199.99 product_original_price: null currency: USD product_star_rating: '4' product_num_ratings: 115 product_url: https://www.amazon.com/dp/B0FXY1DZ78 product_photo: >- https://m.media-amazon.com/images/I/710u7UnAyWL._AC_UY654_QL65_.jpg product_num_offers: 2 product_minimum_offer_price: $181.80 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 1K+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Overnight 7 AM - 11 AM has_variations: true - asin: B084KS5WYC product_title: >- Samsung Galaxy A10e 32GB A102U GSM Unlocked Phone - Black (Renewed) | A102U, GSM, Phone product_price: $70.88 product_original_price: null currency: USD product_star_rating: '4' product_num_ratings: 4096 product_url: https://www.amazon.com/dp/B084KS5WYC product_photo: >- https://m.media-amazon.com/images/I/71Eh6YWqqyL._AC_UY654_QL65_.jpg product_num_offers: 12 product_minimum_offer_price: $65.00 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 1K+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: false - asin: B09VH9BKHS product_title: >- Samsung Galaxy S22+ 5G S906U 128GB GSM/CDMA Unlocked Android Smartphone (USA Version) - Phantom Black (Renewed) product_price: $200.99 product_original_price: null currency: USD product_star_rating: '4.1' product_num_ratings: 1708 product_url: https://www.amazon.com/dp/B09VH9BKHS product_photo: >- https://m.media-amazon.com/images/I/61R5xNY4ZWL._AC_UY654_QL65_.jpg product_num_offers: 25 product_minimum_offer_price: $159.63 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 1K+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: true - asin: B0DNRFGBQ4 product_title: >- SAMSUNG Galaxy A16 4G Dual SIM (128GB, 2025) 6.7" 90Hz AMOLED, Splash Resistant, 8Core, 50MP Camera (Factory Unlocked International Model for GSM, Global) A165M/DS (25W Fast Charger Bundle, Black) product_price: $127.50 product_original_price: null currency: USD product_star_rating: '4.3' product_num_ratings: 1841 product_url: https://www.amazon.com/dp/B0DNRFGBQ4 product_photo: >- https://m.media-amazon.com/images/I/51PEgOzPKLL._AC_UY654_QL65_.jpg product_num_offers: 14 product_minimum_offer_price: $124.99 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 2K+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: true - asin: B0FG1THCD7 product_title: >- Samsung Galaxy S25 FE Cell Phone (2025), 256GB AI Smartphone, Unlocked Android, Large Display, 4900mAh Battery, High Res-Camera, AI Photo Edits, Durable, US 1 Yr Warranty, JetBlack product_price: $612.00 product_original_price: $709.99 currency: USD product_star_rating: '4.6' product_num_ratings: 544 product_url: https://www.amazon.com/dp/B0FG1THCD7 product_photo: >- https://m.media-amazon.com/images/I/61JvXODKxOL._AC_UY654_QL65_.jpg product_num_offers: 10 product_minimum_offer_price: $530.19 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 500+ bought in past month delivery: FREE delivery Mar 10 - 13Or fastest delivery Mar 10 - 12 has_variations: true - asin: B08HQZC2XK product_title: >- Samsung Electronics Galaxy Note 20 5G Unlocked Android Cell Phone | US Version | 128GB of Storage | Mobile Gaming Smartphone | Long-Lasting Battery | Mystic Gray (Renewed) product_price: $193.00 product_original_price: null currency: USD product_star_rating: '4' product_num_ratings: 2630 product_url: https://www.amazon.com/dp/B08HQZC2XK product_photo: >- https://m.media-amazon.com/images/I/51r9YwvPfsL._AC_UY654_QL65_.jpg product_num_offers: 23 product_minimum_offer_price: $159.00 is_best_seller: false is_amazon_choice: false is_prime: false product_availability: Only 19 left in stock - order soon. climate_pledge_friendly: false sales_volume: 500+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6Only 19 left in stock - order soon. has_variations: false - asin: B089HPTDK5 product_title: >- Samsung Galaxy A50 A505U 64GB GSM Unlocked Smartphone - Black (Renewed) product_price: $86.44 product_original_price: null currency: USD product_star_rating: '3.8' product_num_ratings: 641 product_url: https://www.amazon.com/dp/B089HPTDK5 product_photo: >- https://m.media-amazon.com/images/I/71N3nJoPQ+L._AC_UY654_QL65_.jpg product_num_offers: 17 product_minimum_offer_price: $79.99 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 200+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: false - asin: B0DNRGQRB4 product_title: >- Samsung Galaxy A16 4G Dual SIM (128GB, 2025) 6.7" 90Hz AMOLED, Splash Resistant, 8Core, 50MP Camera (Factory Unlocked International Model for GSM, Global) A165M/DS (25W Fast Charger Bundle, Grey) product_price: $127.50 product_original_price: null currency: USD product_star_rating: '4.3' product_num_ratings: 1841 product_url: https://www.amazon.com/dp/B0DNRGQRB4 product_photo: >- https://m.media-amazon.com/images/I/51qEkCjW6wL._AC_UY654_QL65_.jpg product_num_offers: 11 product_minimum_offer_price: $123.87 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 500+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: true - asin: B0F49DQKT8 product_title: >- SAMSUNG Galaxy A36 5G 2025 | 256GB, Dual SIM | 6.7" 120Hz AMOLED, IP67 Water Resistant, Android 15 | International Model Factory Unlocked for T-Mobile & Global | 25W Fast Charger Bundle (Black) product_price: $275.00 product_original_price: null currency: USD product_star_rating: '4.3' product_num_ratings: 234 product_url: https://www.amazon.com/dp/B0F49DQKT8 product_photo: >- https://m.media-amazon.com/images/I/41CtyAEAmrL._AC_UY654_QL65_.jpg product_num_offers: 11 product_minimum_offer_price: $269.00 is_best_seller: false is_amazon_choice: false is_prime: false product_availability: Only 1 left in stock - order soon. climate_pledge_friendly: false sales_volume: 500+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Sat, Mar 7Only 1 left in stock - order soon. has_variations: true - asin: B0D52DG499 product_title: >- SAMSUNG Galaxy A03s Cell Phone, Unlocked Android Smartphone, 32GB, Long Lasting Battery, Expandable Storage, 3 Camera Lenses, Infinite Display - Black (Renewed) product_price: $69.99 product_original_price: null currency: USD product_star_rating: '3.7' product_num_ratings: 83 product_url: https://www.amazon.com/dp/B0D52DG499 product_photo: >- https://m.media-amazon.com/images/I/51Ebpy1OE7L._AC_UY654_QL65_.jpg product_num_offers: 10 product_minimum_offer_price: $67.93 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 500+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: false - asin: B0CCPNDQCP product_title: >- Samsung Galaxy A14 5G Unlocked, 6.6-Inch Infinity-V Display, 1080x2408 FHD+, PLS LCD, Android 13, One UI Core 5, Bluetooth 5.2, 64GB ROM, 4GB RAM, Expandable MicroSD product_price: $89.99 product_original_price: $95.87 currency: USD product_star_rating: '3.8' product_num_ratings: 177 product_url: https://www.amazon.com/dp/B0CCPNDQCP product_photo: >- https://m.media-amazon.com/images/I/51drJV2ZGCL._AC_UY654_QL65_.jpg product_num_offers: 5 product_minimum_offer_price: $69.99 is_best_seller: false is_amazon_choice: false is_prime: false product_availability: Only 2 left in stock - order soon. climate_pledge_friendly: false sales_volume: 300+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6Only 2 left in stock - order soon. has_variations: false - asin: B09LG4PSB6 product_title: >- Samsung Galaxy S20 FE 5G, US Version, 128GB, Blue - Verizon (Renewed) product_price: $146.44 product_original_price: $237.55 currency: USD product_star_rating: '4' product_num_ratings: 10965 product_url: https://www.amazon.com/dp/B09LG4PSB6 product_photo: >- https://m.media-amazon.com/images/I/51yxI5nkPWL._AC_UY654_QL65_.jpg product_num_offers: 12 product_minimum_offer_price: $129.95 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 200+ bought in past month delivery: >- FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6 has_variations: true - asin: B0C544TBQM product_title: >- Samsung Galaxy S23 Ultra 5G, US Version, 256GB, Phantom Black - Unlocked (Renewed) product_price: $422.51 product_original_price: null currency: USD product_star_rating: '4.1' product_num_ratings: 2680 product_url: https://www.amazon.com/dp/B0C544TBQM product_photo: >- https://m.media-amazon.com/images/I/513vXUcPFrL._AC_UY654_QL65_.jpg product_num_offers: 9 product_minimum_offer_price: $374.00 is_best_seller: false is_amazon_choice: false is_prime: false climate_pledge_friendly: false sales_volume: 1K+ bought in past month delivery: FREE delivery Mar 13 - 19Or fastest delivery Mar 13 - 18 has_variations: true requestId: da567eb8-2e2f-44b7-964e-65f6763264df headers: {} '400': description: 请求参数错误，请检查必填字段和参数格式 content: application/json: schema: type: object example: code: 400 data: null message: 'Missing required parameter: handle' '401': description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效 content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: 账户余额或额度不足 content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: 请求过于频繁，已触发限流 content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: 服务器内部错误，请稍后重试 content: application/json: schema: type: object example: code: 500 data: null message: Internal server error deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/amazon/search?query=Phone&page=1&country=us&sort_by=RELEVANCE&category_id=aps&min_price=0&max_price=1000&product_condition=ALL&brand=SAMSUNG&is_prime=false&deals_and_discounts=NONE' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/amazon/search', params={"query": "Phone", "page": 1, "country": "us", "sort_by": "RELEVANCE", "category_id": "aps", "min_price": 0, "max_price": "1000", "product_condition": "ALL", "brand": "SAMSUNG", "is_prime": "false", "deals_and_discounts": "NONE"}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"query": "Phone", "page": 1, "country": "us", "sort_by": "RELEVANCE", "category_id": "aps", "min_price": 0, "max_price": "1000", "product_condition": "ALL", "brand": "SAMSUNG", "is_prime": "false", "deals_and_discounts": "NONE"}); const response = await fetch(`https://api.keyapi.ai/v1/amazon/search?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- 接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer `。 可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。 ````