> ## 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.

# 分类商品列表

> 根据 Amazon 分类 ID 获取该分类下的分页商品列表，支持排序、价格区间、品牌、Prime 和评分等筛选。适用于分类选品、类目商品采集和市场容量分析。

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">3 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。</p>
  </div>

  <div className="mt-4">
    <button type="button" className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50" onClick={() => navigator.clipboard.writeText("我想调用 KeyAPI 接口：GET https://api.keyapi.ai/v1/amazon/products-by-category\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/amazon/products-by-category\n\nDescription: Amazon 的「分类商品列表」接口用于批量查询列表数据，返回基础信息、关键指标和分页信息，适合采集后继续分析。常用必填参数包括 category_id。\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- category_id (Required): 分类 ID. Example: 281407\n- page (Optional): 页码. Example: 1\n- country (Optional): 国家代码. Example: us\n- sort_by (Optional): 排序字段. Example: RELEVANCE\n- min_price (Optional): min_price 参数. Example: 0\n- max_price (Optional): max_price 参数. Example: 0\n- product_condition (Optional): product_condition 参数. Example: ALL\n- brand (Optional): brand 参数. Example: SAMSUNG\n- is_prime (Optional): is_prime 参数. Example: false\n- deals_and_discounts (Optional): 返回数量上限. Example: NONE\n- four_stars_and_up (Optional): four_stars_and_up 参数\n- language (Optional): 语言代码\n- additional_filters (Optional): additional_filters 参数\n- fields (Optional): fields 参数\n\nExample Response:\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"total_products\": 17,\n    \"country\": \"US\",\n    \"domain\": \"www.amazon.com\",\n    \"products\": [\n      {\n        \"asin\": \"B0C4M37HZN\",\n        \"product_title\": \"Samsung 25W Wall Charger Power Adapter, Cable Not Included, Super Fast Charging, Compact Design, Energy Efficient, Compatible with Galaxy and USB Type C Devices, White\",\n        \"product_price\": \"$12.99\",\n        \"product_original_price\": \"$14.99\",\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.6\",\n        \"product_num_ratings\": 1810,\n        \"product_url\": \"https://www.amazon.com/dp/B0C4M37HZN\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/515lQOiHR-L._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 1,\n        \"product_minimum_offer_price\": \"$12.99\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": true,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"400+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Tomorrow, Mar 6\",\n        \"has_variations\": false,\n        \"product_badge\": \"Overall Pick\"\n      },\n      {\n        \"asin\": \"B0CB93HQKP\",\n        \"product_title\": \"Samsung 25W Wall Charger Power Adapter, Cable Not Included, Super Fast Charging, Compact Design, Energy Efficient, Compatible with Galaxy and USB Type C Devices, Black\",\n        \"product_price\": \"$12.99\",\n        \"product_original_price\": \"$19.99\",\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.8\",\n        \"product_num_ratings\": 2210,\n        \"product_url\": \"https://www.amazon.com/dp/B0CB93HQKP\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/71blOLk9A6L._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 10,\n        \"product_minimum_offer_price\": \"$12.02\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"2K+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Overnight 7 AM - 11 AM\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0CCBP3XN8\",\n        \"product_title\": \"Samsung Galaxy SmartTag2, Bluetooth Tracker, Locator Tracking Device, Item Finder for Keys, Wallet, Luggage, Use w/Phones Tablets Android 11 or Later, 2023, 4 Pack, 2 Black, 2 White\",\n        \"product_price\": \"$61.79\",\n        \"product_original_price\": null,\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.3\",\n        \"product_num_ratings\": 10892,\n        \"product_url\": \"https://www.amazon.com/dp/B0CCBP3XN8\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/61EGB5gJEAL._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 16,\n        \"product_minimum_offer_price\": \"$58.11\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"2K+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10Or fastest delivery Tomorrow, Mar 6\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0CHN2D8KM\",\n        \"product_title\": \"Samsung SmartTag2 (2023) Bluetooth + UWB, IP67 Water and Dust Resistant, Findable via App, 1.5 Year Battery Life - Black (International Version)\",\n        \"product_price\": \"$17.25\",\n        \"product_original_price\": null,\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.5\",\n        \"product_num_ratings\": 4662,\n        \"product_url\": \"https://www.amazon.com/dp/B0CHN2D8KM\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/512Rzv5dJ+L._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 25,\n        \"product_minimum_offer_price\": \"$14.99\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"1K+ bought in past month\",\n        \"delivery\": \"FREE delivery Thu, Mar 12 on $35 of items shipped by AmazonOr fastest delivery Overnight 7 AM - 11 AM\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0CV9LV3B4\",\n        \"product_title\": \"SAMSUNG 45W Wall Charger Power Adapter with Cable Included, Super Fast Charging for Galaxy Phones, Tablets and USB Type C Devices, Low Standby Power Consumption, EP-T4511XBEGUS, Black\",\n        \"product_price\": \"$29.99\",\n        \"product_original_price\": null,\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.5\",\n        \"product_num_ratings\": 760,\n        \"product_url\": \"https://www.amazon.com/dp/B0CV9LV3B4\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/61xeaSwjuCL._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 12,\n        \"product_minimum_offer_price\": \"$20.38\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"2K+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Tomorrow, Mar 6\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0CCC69HN3\",\n        \"product_title\": \"Samsung Galaxy SmartTag2, Bluetooth Tracker, Smart Tag Tracking Device, Item Finder for Keys, Wallet, Luggage, Pets, Use w/ Phones and Tablets Android 11 or Later, 2023, 1 Pack, White\",\n        \"product_price\": \"$19.31\",\n        \"product_original_price\": \"$29.99\",\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.3\",\n        \"product_num_ratings\": 10892,\n        \"product_url\": \"https://www.amazon.com/dp/B0CCC69HN3\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/51cP3SGpuDL._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 8,\n        \"product_minimum_offer_price\": \"$17.15\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"2K+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Tomorrow, Mar 6\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B09MV3M4GL\",\n        \"product_title\": \"Samsung Black 65W Trio Adapter\",\n        \"product_price\": \"$49.99\",\n        \"product_original_price\": null,\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.6\",\n        \"product_num_ratings\": 1063,\n        \"product_url\": \"https://www.amazon.com/dp/B09MV3M4GL\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/41ZTPNboySL._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 1,\n        \"product_minimum_offer_price\": \"$49.99\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"200+ bought in past month\",\n        \"delivery\": \"FREE delivery Wed, Mar 11Or fastest delivery Sat, Mar 7\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0FXHJTGNN\",\n        \"product_title\": \"Samsung Galaxy Magnet Wireless Charger with 45W Power Adapter, Cordless Super Fast Charging, Powerful Design, Built-in Magnets, No-Slip Surface, Dark Gray\",\n        \"product_price\": \"$52.49\",\n        \"product_original_price\": \"$74.99\",\n        \"currency\": \"USD\",\n        \"product_star_rating\": null,\n        \"product_num_ratings\": 0,\n        \"product_url\": \"https://www.amazon.com/dp/B0FXHJTGNN\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/61UpJwyvIML._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 1,\n        \"product_minimum_offer_price\": \"$52.49\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"New on Amazon in past month\",\n        \"delivery\": \"FREE delivery Mar 31 - May 7Or fastest delivery Mar 31 - May 4\",\n        \"has_variations\": false,\n        \"product_badge\": \"Limited time deal\"\n      },\n      {\n        \"asin\": \"B0CV9G1GX4\",\n        \"product_title\": \"SAMSUNG 50W Duo Power Adapter Wall Charger, 2 Ports, Cable Included, Super Fast Charging 2.0 for Galaxy Phones, Tablets, USB Type C Devices, Low Standby Power Consumption, EP-T5020XBEGUS, Black\",\n        \"product_price\": \"$23.89\",\n        \"product_original_price\": \"$29.99\",\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.7\",\n        \"product_num_ratings\": 323,\n        \"product_url\": \"https://www.amazon.com/dp/B0CV9G1GX4\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/71A5egCaa8L._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 12,\n        \"product_minimum_offer_price\": \"$23.25\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"500+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Sat, Mar 7\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0CB9357F7\",\n        \"product_title\": \"Samsung 25W Wall Charger Power Adapter with Cable, Super Fast Charging, Compact Design, Energy Efficient, Compatible with Galaxy and USB Type C Devices, Black\",\n        \"product_price\": \"$18.55\",\n        \"product_original_price\": null,\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.6\",\n        \"product_num_ratings\": 1810,\n        \"product_url\": \"https://www.amazon.com/dp/B0CB9357F7\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/61s3soTajIL._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 1,\n        \"product_minimum_offer_price\": \"$18.55\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"product_availability\": \"Only 7 left in stock - order soon.\",\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"1K+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Sat, Mar 7Only 7 left in stock - order soon.\",\n        \"has_variations\": false\n      },\n      {\n        \"asin\": \"B0FNCZ96XS\",\n        \"product_title\": \"Samsung 45W Wall Charger Power Adapter, Cable Not Included, Super Fast Charging for Galaxy Phones, Tablets and USB Type C Devices, Low Standby Power Consumption, EP-T4511NWEGUS, White\",\n        \"product_price\": \"$31.99\",\n        \"product_original_price\": \"$39.99\",\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"5\",\n        \"product_num_ratings\": 2,\n        \"product_url\": \"https://www.amazon.com/dp/B0FNCZ96XS\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/61UYtmcX6HL._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 2,\n        \"product_minimum_offer_price\": \"$30.39\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_friendly\": false,\n        \"sales_volume\": \"50+ bought in past month\",\n        \"delivery\": \"FREE delivery Tue, Mar 10 on $35 of items shipped by AmazonOr fastest delivery Sat, Mar 7\",\n        \"has_variations\": false,\n        \"product_badge\": \"Limited time deal\"\n      },\n      {\n        \"asin\": \"B0DQFJKP4B\",\n        \"product_title\": \"SAMSUNG 45W Wall Charger Power Adapter, Cable Not Included, Super Fast Charging for Galaxy Phones, Tablets and USB Type C Devices, Low Standby Power Consumption, EP-T4511NBEGUS, Black\",\n        \"product_price\": \"$23.49\",\n        \"product_original_price\": null,\n        \"currency\": \"USD\",\n        \"product_star_rating\": \"4.8\",\n        \"product_num_ratings\": 65,\n        \"product_url\": \"https://www.amazon.com/dp/B0DQFJKP4B\",\n        \"product_photo\": \"https://m.media-amazon.com/images/I/71jPqb36v5L._AC_UY654_QL65_.jpg\",\n        \"product_num_offers\": 7,\n        \"product_minimum_offer_price\": \"$19.90\",\n        \"is_best_seller\": false,\n        \"is_amazon_choice\": false,\n        \"is_prime\": false,\n        \"climate_pledge_frien\n... truncated ...\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/amazon.zh.openapi.json GET /v1/amazon/products-by-category
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/products-by-category:
    get:
      tags: []
      summary: 分类商品列表
      description: >-
        根据 Amazon 分类 ID 获取该分类下的分页商品列表，支持排序、价格区间、品牌、Prime
        和评分等筛选。适用于分类选品、类目商品采集和市场容量分析。
      parameters:
        - name: category_id
          in: query
          description: >-
            要查询的 Amazon 分类 ID。category
            ID可从Amazon分类结果URL中获取，例如：`https://amazon.com/s?node=2858778013`
            Amazon分类ID为2858778013
          required: true
          example: '281407'
          schema:
            type: string
            example: '281407'
        - 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: min_price
          in: query
          description: 只返回价格大于一定价值的产品报价。以所选国家的货币指定。例如，如果country=US，值105.34表示$105.34
          required: false
          example: 0
          schema:
            type: number
        - name: max_price
          in: query
          description: 只返回价格低于一定价值的产品报价。以所选国家的货币指定。例如，如果country=US，值105.34表示$105.34
          required: false
          example: 0
          schema:
            type: number
        - 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: 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
        - 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: 17
                  country: US
                  domain: www.amazon.com
                  products:
                    - asin: B0C4M37HZN
                      product_title: >-
                        Samsung 25W Wall Charger Power Adapter, Cable Not
                        Included, Super Fast Charging, Compact Design, Energy
                        Efficient, Compatible with Galaxy and USB Type C
                        Devices, White
                      product_price: $12.99
                      product_original_price: $14.99
                      currency: USD
                      product_star_rating: '4.6'
                      product_num_ratings: 1810
                      product_url: https://www.amazon.com/dp/B0C4M37HZN
                      product_photo: >-
                        https://m.media-amazon.com/images/I/515lQOiHR-L._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: $12.99
                      is_best_seller: false
                      is_amazon_choice: true
                      is_prime: false
                      climate_pledge_friendly: false
                      sales_volume: 400+ bought in past month
                      delivery: >-
                        FREE delivery Tue, Mar 10 on $35 of items shipped by
                        AmazonOr fastest delivery Tomorrow, Mar 6
                      has_variations: false
                      product_badge: Overall Pick
                    - asin: B0CB93HQKP
                      product_title: >-
                        Samsung 25W Wall Charger Power Adapter, Cable Not
                        Included, Super Fast Charging, Compact Design, Energy
                        Efficient, Compatible with Galaxy and USB Type C
                        Devices, Black
                      product_price: $12.99
                      product_original_price: $19.99
                      currency: USD
                      product_star_rating: '4.8'
                      product_num_ratings: 2210
                      product_url: https://www.amazon.com/dp/B0CB93HQKP
                      product_photo: >-
                        https://m.media-amazon.com/images/I/71blOLk9A6L._AC_UY654_QL65_.jpg
                      product_num_offers: 10
                      product_minimum_offer_price: $12.02
                      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 10 on $35 of items shipped by
                        AmazonOr fastest delivery Overnight 7 AM - 11 AM
                      has_variations: false
                    - asin: B0CCBP3XN8
                      product_title: >-
                        Samsung Galaxy SmartTag2, Bluetooth Tracker, Locator
                        Tracking Device, Item Finder for Keys, Wallet, Luggage,
                        Use w/Phones Tablets Android 11 or Later, 2023, 4 Pack,
                        2 Black, 2 White
                      product_price: $61.79
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.3'
                      product_num_ratings: 10892
                      product_url: https://www.amazon.com/dp/B0CCBP3XN8
                      product_photo: >-
                        https://m.media-amazon.com/images/I/61EGB5gJEAL._AC_UY654_QL65_.jpg
                      product_num_offers: 16
                      product_minimum_offer_price: $58.11
                      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: false
                    - asin: B0CHN2D8KM
                      product_title: >-
                        Samsung SmartTag2 (2023) Bluetooth + UWB, IP67 Water and
                        Dust Resistant, Findable via App, 1.5 Year Battery Life
                        - Black (International Version)
                      product_price: $17.25
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.5'
                      product_num_ratings: 4662
                      product_url: https://www.amazon.com/dp/B0CHN2D8KM
                      product_photo: >-
                        https://m.media-amazon.com/images/I/512Rzv5dJ+L._AC_UY654_QL65_.jpg
                      product_num_offers: 25
                      product_minimum_offer_price: $14.99
                      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 Thu, Mar 12 on $35 of items shipped by
                        AmazonOr fastest delivery Overnight 7 AM - 11 AM
                      has_variations: false
                    - asin: B0CV9LV3B4
                      product_title: >-
                        SAMSUNG 45W Wall Charger Power Adapter with Cable
                        Included, Super Fast Charging for Galaxy Phones, Tablets
                        and USB Type C Devices, Low Standby Power Consumption,
                        EP-T4511XBEGUS, Black
                      product_price: $29.99
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.5'
                      product_num_ratings: 760
                      product_url: https://www.amazon.com/dp/B0CV9LV3B4
                      product_photo: >-
                        https://m.media-amazon.com/images/I/61xeaSwjuCL._AC_UY654_QL65_.jpg
                      product_num_offers: 12
                      product_minimum_offer_price: $20.38
                      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 10 on $35 of items shipped by
                        AmazonOr fastest delivery Tomorrow, Mar 6
                      has_variations: false
                    - asin: B0CCC69HN3
                      product_title: >-
                        Samsung Galaxy SmartTag2, Bluetooth Tracker, Smart Tag
                        Tracking Device, Item Finder for Keys, Wallet, Luggage,
                        Pets, Use w/ Phones and Tablets Android 11 or Later,
                        2023, 1 Pack, White
                      product_price: $19.31
                      product_original_price: $29.99
                      currency: USD
                      product_star_rating: '4.3'
                      product_num_ratings: 10892
                      product_url: https://www.amazon.com/dp/B0CCC69HN3
                      product_photo: >-
                        https://m.media-amazon.com/images/I/51cP3SGpuDL._AC_UY654_QL65_.jpg
                      product_num_offers: 8
                      product_minimum_offer_price: $17.15
                      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 10 on $35 of items shipped by
                        AmazonOr fastest delivery Tomorrow, Mar 6
                      has_variations: false
                    - asin: B09MV3M4GL
                      product_title: Samsung Black 65W Trio Adapter
                      product_price: $49.99
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.6'
                      product_num_ratings: 1063
                      product_url: https://www.amazon.com/dp/B09MV3M4GL
                      product_photo: >-
                        https://m.media-amazon.com/images/I/41ZTPNboySL._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: $49.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 Wed, Mar 11Or fastest delivery Sat, Mar 7
                      has_variations: false
                    - asin: B0FXHJTGNN
                      product_title: >-
                        Samsung Galaxy Magnet Wireless Charger with 45W Power
                        Adapter, Cordless Super Fast Charging, Powerful Design,
                        Built-in Magnets, No-Slip Surface, Dark Gray
                      product_price: $52.49
                      product_original_price: $74.99
                      currency: USD
                      product_star_rating: null
                      product_num_ratings: 0
                      product_url: https://www.amazon.com/dp/B0FXHJTGNN
                      product_photo: >-
                        https://m.media-amazon.com/images/I/61UpJwyvIML._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: $52.49
                      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 delivery Mar 31 - May 7Or fastest delivery Mar 31 -
                        May 4
                      has_variations: false
                      product_badge: Limited time deal
                    - asin: B0CV9G1GX4
                      product_title: >-
                        SAMSUNG 50W Duo Power Adapter Wall Charger, 2 Ports,
                        Cable Included, Super Fast Charging 2.0 for Galaxy
                        Phones, Tablets, USB Type C Devices, Low Standby Power
                        Consumption, EP-T5020XBEGUS, Black
                      product_price: $23.89
                      product_original_price: $29.99
                      currency: USD
                      product_star_rating: '4.7'
                      product_num_ratings: 323
                      product_url: https://www.amazon.com/dp/B0CV9G1GX4
                      product_photo: >-
                        https://m.media-amazon.com/images/I/71A5egCaa8L._AC_UY654_QL65_.jpg
                      product_num_offers: 12
                      product_minimum_offer_price: $23.25
                      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 10 on $35 of items shipped by
                        AmazonOr fastest delivery Sat, Mar 7
                      has_variations: false
                    - asin: B0CB9357F7
                      product_title: >-
                        Samsung 25W Wall Charger Power Adapter with Cable, Super
                        Fast Charging, Compact Design, Energy Efficient,
                        Compatible with Galaxy and USB Type C Devices, Black
                      product_price: $18.55
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.6'
                      product_num_ratings: 1810
                      product_url: https://www.amazon.com/dp/B0CB9357F7
                      product_photo: >-
                        https://m.media-amazon.com/images/I/61s3soTajIL._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: $18.55
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      product_availability: Only 7 left in stock - order soon.
                      climate_pledge_friendly: false
                      sales_volume: 1K+ bought in past month
                      delivery: >-
                        FREE delivery Tue, Mar 10 on $35 of items shipped by
                        AmazonOr fastest delivery Sat, Mar 7Only 7 left in stock
                        - order soon.
                      has_variations: false
                    - asin: B0FNCZ96XS
                      product_title: >-
                        Samsung 45W Wall Charger Power Adapter, Cable Not
                        Included, Super Fast Charging for Galaxy Phones, Tablets
                        and USB Type C Devices, Low Standby Power Consumption,
                        EP-T4511NWEGUS, White
                      product_price: $31.99
                      product_original_price: $39.99
                      currency: USD
                      product_star_rating: '5'
                      product_num_ratings: 2
                      product_url: https://www.amazon.com/dp/B0FNCZ96XS
                      product_photo: >-
                        https://m.media-amazon.com/images/I/61UYtmcX6HL._AC_UY654_QL65_.jpg
                      product_num_offers: 2
                      product_minimum_offer_price: $30.39
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      climate_pledge_friendly: false
                      sales_volume: 50+ bought in past month
                      delivery: >-
                        FREE delivery Tue, Mar 10 on $35 of items shipped by
                        AmazonOr fastest delivery Sat, Mar 7
                      has_variations: false
                      product_badge: Limited time deal
                    - asin: B0DQFJKP4B
                      product_title: >-
                        SAMSUNG 45W Wall Charger Power Adapter, Cable Not
                        Included, Super Fast Charging for Galaxy Phones, Tablets
                        and USB Type C Devices, Low Standby Power Consumption,
                        EP-T4511NBEGUS, Black
                      product_price: $23.49
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.8'
                      product_num_ratings: 65
                      product_url: https://www.amazon.com/dp/B0DQFJKP4B
                      product_photo: >-
                        https://m.media-amazon.com/images/I/71jPqb36v5L._AC_UY654_QL65_.jpg
                      product_num_offers: 7
                      product_minimum_offer_price: $19.90
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      climate_pledge_friendly: false
                      sales_volume: 300+ bought in past month
                      delivery: >-
                        FREE delivery Tue, Mar 10 on $35 of items shipped by
                        AmazonOr fastest delivery Sat, Mar 7
                      has_variations: false
                    - asin: B0D157TTMY
                      product_title: >-
                        SAMSUNG 45W Wall Charger (2024) Power Adapter with Cable
                        Included, Super Fast Charging for Galaxy Phones, Tablets
                        and USB Type C Devices, Low Standby Power Consumption,
                        EP-T4511XBEGCA, Black
                      product_price: $33.30
                      product_original_price: $34.95
                      currency: USD
                      product_star_rating: '4.6'
                      product_num_ratings: 13
                      product_url: https://www.amazon.com/dp/B0D157TTMY
                      product_photo: >-
                        https://m.media-amazon.com/images/I/51ImmgMag+L._AC_UY654_QL65_.jpg
                      product_num_offers: 8
                      product_minimum_offer_price: $30.00
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      climate_pledge_friendly: false
                      sales_volume: null
                      delivery: >-
                        FREE delivery Tue, Mar 10 on $35 of items shipped by
                        AmazonOr fastest delivery Tomorrow, Mar 6
                      has_variations: false
                    - asin: B0D3FFQNFW
                      product_title: >-
                        SAMSUNG 25W Wall Charger Power Adapter with Cable, Super
                        Fast Charging, Compact Design, Compatible with Galaxy
                        and USB Type C Devices, International Model - Black,
                        EP-T2510XBTGTW
                      product_price: $23.99
                      product_original_price: null
                      currency: USD
                      product_star_rating: '4.2'
                      product_num_ratings: 19
                      product_url: https://www.amazon.com/dp/B0D3FFQNFW
                      product_photo: >-
                        https://m.media-amazon.com/images/I/41L0Ni1YMVL._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: $23.99
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      product_availability: Only 5 left in stock - order soon.
                      climate_pledge_friendly: false
                      sales_volume: null
                      delivery: >-
                        FREE delivery Mar 12 - 16Or fastest delivery Tue, Mar
                        10Only 5 left in stock - order soon.
                      has_variations: false
                    - asin: B07Q4WZF4F
                      product_title: >-
                        Samsung Galaxy Buds Bluetooth Wireless in - Ear True
                        Earphones with Mic Black
                      product_price: null
                      product_original_price: null
                      currency: null
                      product_star_rating: '4.5'
                      product_num_ratings: 36817
                      product_url: https://www.amazon.com/dp/B07Q4WZF4F
                      product_photo: >-
                        https://m.media-amazon.com/images/I/71z00UwQ9DL._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: null
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      climate_pledge_friendly: false
                      sales_volume: null
                      delivery: null
                      has_variations: true
                    - asin: B00UVLEULS
                      product_title: >-
                        Samsung Data Cable for Smartphones with Micro USB -
                        Non-Retail Packaging - White
                      product_price: $8.95
                      product_original_price: null
                      currency: USD
                      product_star_rating: '3.7'
                      product_num_ratings: 172
                      product_url: https://www.amazon.com/dp/B00UVLEULS
                      product_photo: >-
                        https://m.media-amazon.com/images/I/619iuIcBonL._AC_UY654_QL65_.jpg
                      product_num_offers: 1
                      product_minimum_offer_price: $8.95
                      is_best_seller: false
                      is_amazon_choice: false
                      is_prime: false
                      climate_pledge_friendly: false
                      sales_volume: null
                      delivery: FREE delivery Fri, Mar 13Or fastest delivery Tue, Mar 10
                      has_variations: false
                requestId: cf9838e2-e11e-4191-a75e-90376eb3a3bf
          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/products-by-category?category_id=281407&page=1&country=us&sort_by=RELEVANCE&min_price=0&max_price=0&product_condition=ALL&brand=SAMSUNG&is_prime=false&deals_and_discounts=NONE' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/amazon/products-by-category',
                params={"category_id": "281407", "page": 1, "country": "us", "sort_by": "RELEVANCE", "min_price": 0, "max_price": 0, "product_condition": "ALL", "brand": "SAMSUNG", "is_prime": "false", "deals_and_discounts": "NONE"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"category_id": "281407", "page":
            1, "country": "us", "sort_by": "RELEVANCE", "min_price": 0,
            "max_price": 0, "product_condition": "ALL", "brand": "SAMSUNG",
            "is_prime": "false", "deals_and_discounts": "NONE"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/amazon/products-by-category?${params}`,
            {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````