> ## 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。适用于构建分类筛选、后续按分类查询商品和类目导航。

<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/product-category-list\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/amazon/product-category-list\n\nDescription: Amazon 的「商品分类列表」接口用于批量查询列表数据，返回基础信息、关键指标和分页信息，适合采集后继续分析。可结合接口参数进行筛选或分页查询。\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- country (Optional): 国家代码. Example: us\n\nExample Response:\n{\n  \"value\": {\n    \"code\": 0,\n    \"message\": \"success\",\n    \"data\": [\n      {\n        \"name\": \"All Departments\",\n        \"id\": \"aps\"\n      },\n      {\n        \"name\": \"Alexa Skills\",\n        \"id\": \"alexa-skills\"\n      },\n      {\n        \"name\": \"Amazon Devices\",\n        \"id\": \"amazon-devices\"\n      },\n      {\n        \"name\": \"Amazon Explore\",\n        \"id\": \"live-explorations\"\n      },\n      {\n        \"name\": \"Amazon Fresh\",\n        \"id\": \"amazonfresh\"\n      },\n      {\n        \"name\": \"Amazon Pharmacy\",\n        \"id\": \"amazon-pharmacy\"\n      },\n      {\n        \"name\": \"Amazon Warehouse\",\n        \"id\": \"warehouse-deals\"\n      },\n      {\n        \"name\": \"Appliances\",\n        \"id\": \"appliances\"\n      },\n      {\n        \"name\": \"Apps & Games\",\n        \"id\": \"mobile-apps\"\n      },\n      {\n        \"name\": \"Arts, Crafts & Sewing\",\n        \"id\": \"arts-crafts\"\n      },\n      {\n        \"name\": \"Audible Books & Originals\",\n        \"id\": \"audible\"\n      },\n      {\n        \"name\": \"Automotive Parts & Accessories\",\n        \"id\": \"automotive\"\n      },\n      {\n        \"name\": \"AWS Courses\",\n        \"id\": \"courses\"\n      },\n      {\n        \"name\": \"Baby\",\n        \"id\": \"baby-products\"\n      },\n      {\n        \"name\": \"Beauty & Personal Care\",\n        \"id\": \"beauty\"\n      },\n      {\n        \"name\": \"Books\",\n        \"id\": \"stripbooks\"\n      },\n      {\n        \"name\": \"CDs & Vinyl\",\n        \"id\": \"popular\"\n      },\n      {\n        \"name\": \"Cell Phones & Accessories\",\n        \"id\": \"mobile\"\n      },\n      {\n        \"name\": \"Clothing, Shoes & Jewelry\",\n        \"id\": \"fashion\"\n      },\n      {\n        \"name\": \"   Women\",\n        \"id\": \"fashion-womens\"\n      },\n      {\n        \"name\": \"   Men\",\n        \"id\": \"fashion-mens\"\n      },\n      {\n        \"name\": \"   Girls\",\n        \"id\": \"fashion-girls\"\n      },\n      {\n        \"name\": \"   Boys\",\n        \"id\": \"fashion-boys\"\n      },\n      {\n        \"name\": \"   Baby\",\n        \"id\": \"fashion-baby\"\n      },\n      {\n        \"name\": \"Collectibles & Fine Art\",\n        \"id\": \"collectibles\"\n      },\n      {\n        \"name\": \"Computers\",\n        \"id\": \"computers\"\n      },\n      {\n        \"name\": \"Credit and Payment Cards\",\n        \"id\": \"financial\"\n      },\n      {\n        \"name\": \"Digital Educational Resources\",\n        \"id\": \"edu-alt-content\"\n      },\n      {\n        \"name\": \"Digital Music\",\n        \"id\": \"digital-music\"\n      },\n      {\n        \"name\": \"Electronics\",\n        \"id\": \"electronics\"\n      },\n      {\n        \"name\": \"Garden & Outdoor\",\n        \"id\": \"lawngarden\"\n      },\n      {\n        \"name\": \"Gift Cards\",\n        \"id\": \"gift-cards\"\n      },\n      {\n        \"name\": \"Grocery & Gourmet Food\",\n        \"id\": \"grocery\"\n      },\n      {\n        \"name\": \"Handmade\",\n        \"id\": \"handmade\"\n      },\n      {\n        \"name\": \"Health, Household & Baby Care\",\n        \"id\": \"hpc\"\n      },\n      {\n        \"name\": \"Home & Business Services\",\n        \"id\": \"local-services\"\n      },\n      {\n        \"name\": \"Home & Kitchen\",\n        \"id\": \"garden\"\n      },\n      {\n        \"name\": \"Industrial & Scientific\",\n        \"id\": \"industrial\"\n      },\n      {\n        \"name\": \"Just for Prime\",\n        \"id\": \"prime-exclusive\"\n      },\n      {\n        \"name\": \"Kindle Store\",\n        \"id\": \"digital-text\"\n      },\n      {\n        \"name\": \"Luggage & Travel Gear\",\n        \"id\": \"fashion-luggage\"\n      },\n      {\n        \"name\": \"Luxury Stores\",\n        \"id\": \"luxury\"\n      },\n      {\n        \"name\": \"Magazine Subscriptions\",\n        \"id\": \"magazines\"\n      },\n      {\n        \"name\": \"Movies & TV\",\n        \"id\": \"movies-tv\"\n      },\n      {\n        \"name\": \"Musical Instruments\",\n        \"id\": \"mi\"\n      },\n      {\n        \"name\": \"Office Products\",\n        \"id\": \"office-products\"\n      },\n      {\n        \"name\": \"Pet Supplies\",\n        \"id\": \"pets\"\n      },\n      {\n        \"name\": \"Premium Beauty\",\n        \"id\": \"luxury-beauty\"\n      },\n      {\n        \"name\": \"Prime Video\",\n        \"id\": \"instant-video\"\n      },\n      {\n        \"name\": \"Smart Home\",\n        \"id\": \"smart-home\"\n      },\n      {\n        \"name\": \"Software\",\n        \"id\": \"software\"\n      },\n      {\n        \"name\": \"Sports & Outdoors\",\n        \"id\": \"sporting\"\n      },\n      {\n        \"name\": \"Subscribe & Save\",\n        \"id\": \"specialty-aps-sns\"\n      },\n      {\n        \"name\": \"Subscription Boxes\",\n        \"id\": \"subscribe-with-amazon\"\n      },\n      {\n        \"name\": \"Tools & Home Improvement\",\n        \"id\": \"tools\"\n      },\n      {\n        \"name\": \"Toys & Games\",\n        \"id\": \"toys-and-games\"\n      },\n      {\n        \"name\": \"Under $10\",\n        \"id\": \"under-ten-dollars\"\n      },\n      {\n        \"name\": \"Video Games\",\n        \"id\": \"videogames\"\n      },\n      {\n        \"name\": \"Whole Foods Market\",\n        \"id\": \"wholefoods\"\n      }\n    ]\n  },\n  \"requestId\": \"3d42d7bb-86ae-4a6a-a8e6-ffbce20fffe5\"\n}\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/amazon.zh.openapi.json GET /v1/amazon/product-category-list
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/product-category-list:
    get:
      tags: []
      summary: 商品分类列表
      description: 获取指定 Amazon 市场的顶级商品分类列表，返回分类名称和分类 ID。适用于构建分类筛选、后续按分类查询商品和类目导航。
      parameters:
        - 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
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                value:
                  code: 0
                  message: success
                  data:
                    - name: All Departments
                      id: aps
                    - name: Alexa Skills
                      id: alexa-skills
                    - name: Amazon Devices
                      id: amazon-devices
                    - name: Amazon Explore
                      id: live-explorations
                    - name: Amazon Fresh
                      id: amazonfresh
                    - name: Amazon Pharmacy
                      id: amazon-pharmacy
                    - name: Amazon Warehouse
                      id: warehouse-deals
                    - name: Appliances
                      id: appliances
                    - name: Apps & Games
                      id: mobile-apps
                    - name: Arts, Crafts & Sewing
                      id: arts-crafts
                    - name: Audible Books & Originals
                      id: audible
                    - name: Automotive Parts & Accessories
                      id: automotive
                    - name: AWS Courses
                      id: courses
                    - name: Baby
                      id: baby-products
                    - name: Beauty & Personal Care
                      id: beauty
                    - name: Books
                      id: stripbooks
                    - name: CDs & Vinyl
                      id: popular
                    - name: Cell Phones & Accessories
                      id: mobile
                    - name: Clothing, Shoes & Jewelry
                      id: fashion
                    - name: "\_\_\_Women"
                      id: fashion-womens
                    - name: "\_\_\_Men"
                      id: fashion-mens
                    - name: "\_\_\_Girls"
                      id: fashion-girls
                    - name: "\_\_\_Boys"
                      id: fashion-boys
                    - name: "\_\_\_Baby"
                      id: fashion-baby
                    - name: Collectibles & Fine Art
                      id: collectibles
                    - name: Computers
                      id: computers
                    - name: Credit and Payment Cards
                      id: financial
                    - name: Digital Educational Resources
                      id: edu-alt-content
                    - name: Digital Music
                      id: digital-music
                    - name: Electronics
                      id: electronics
                    - name: Garden & Outdoor
                      id: lawngarden
                    - name: Gift Cards
                      id: gift-cards
                    - name: Grocery & Gourmet Food
                      id: grocery
                    - name: Handmade
                      id: handmade
                    - name: Health, Household & Baby Care
                      id: hpc
                    - name: Home & Business Services
                      id: local-services
                    - name: Home & Kitchen
                      id: garden
                    - name: Industrial & Scientific
                      id: industrial
                    - name: Just for Prime
                      id: prime-exclusive
                    - name: Kindle Store
                      id: digital-text
                    - name: Luggage & Travel Gear
                      id: fashion-luggage
                    - name: Luxury Stores
                      id: luxury
                    - name: Magazine Subscriptions
                      id: magazines
                    - name: Movies & TV
                      id: movies-tv
                    - name: Musical Instruments
                      id: mi
                    - name: Office Products
                      id: office-products
                    - name: Pet Supplies
                      id: pets
                    - name: Premium Beauty
                      id: luxury-beauty
                    - name: Prime Video
                      id: instant-video
                    - name: Smart Home
                      id: smart-home
                    - name: Software
                      id: software
                    - name: Sports & Outdoors
                      id: sporting
                    - name: Subscribe & Save
                      id: specialty-aps-sns
                    - name: Subscription Boxes
                      id: subscribe-with-amazon
                    - name: Tools & Home Improvement
                      id: tools
                    - name: Toys & Games
                      id: toys-and-games
                    - name: Under $10
                      id: under-ten-dollars
                    - name: Video Games
                      id: videogames
                    - name: Whole Foods Market
                      id: wholefoods
                requestId: 3d42d7bb-86ae-4a6a-a8e6-ffbce20fffe5
          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/product-category-list?country=us' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/amazon/product-category-list',
                params={"country": "us"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"country": "us"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/amazon/product-category-list?${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。

````