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

# Product Category List

> Retrieve the list of top-level product categories available on Amazon for a given marketplace.

<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">per request</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">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</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(`I want to make an API call to https://api.keyapi.ai/v1/amazon/product-category-list.

Please help me write code to make this API call and handle the response appropriately. Include error handling and best practices.

Here are the details:

Endpoint: GET https://api.keyapi.ai/v1/amazon/product-category-list

Description: Product Category List

Required Headers:
--header 'Authorization: Bearer <YOUR_API_KEY>'

Parameters:
- country (Optional): Sets the Amazon domain, marketplace country, language and currency.
Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES, TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE. Example: us

Example Response:
{
"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"
  },
... (truncated)`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/amazon.openapi.json GET /v1/amazon/product-category-list
openapi: 3.0.1
info:
  title: Amazon API english documentation
  description: >-
    The english reference documentation of the Amazon API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security: []
tags: []
paths:
  /v1/amazon/product-category-list:
    get:
      tags: []
      summary: Product Category List
      description: >-
        Retrieve the list of top-level product categories available on Amazon
        for a given marketplace.
      parameters:
        - name: country
          in: query
          description: >-
            Sets the Amazon domain, marketplace country, language and currency.

            Allowed values: 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: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: Internal Server Error
          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: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````