GET /amazon/category-list

Category List

Browse and retrieve Amazon product categories and subcategories by marketplace.

Amazon Product Data API

Retrieve the full list of Amazon product categories and subcategories. Use this endpoint to discover valid category names and node IDs for filtering other endpoints such as Best Sellers, Deals, and New Releases.

HTTP Request

GET /amazon/category-list

Parameters

ParameterTypeRequiredDefaultDescription
marketplacestringNocomAmazon marketplace code
categorystringNo-Parent category name to list subcategories
category_nodestringNo-Amazon category node ID
languagestringNo-Language code for results
pageintegerNo1Results page number

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

{
  "status": "OK",
  "request_id": "d0e1f2a3-0123-4567-3456-aaaaaaaaaaaa",
  "data": {
    "country": "US",
    "categories": [
      {
        "category_id": "2335752011",
        "category_name": "Electronics",
        "category_url": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics",
        "subcategories": [
          {
            "category_id": "172541",
            "category_name": "Camera & Photo",
            "category_url": "https://www.amazon.com/Best-Sellers-Camera-Photo/zgbs/photo"
          },
          {
            "category_id": "541966",
            "category_name": "Computers & Accessories",
            "category_url": "https://www.amazon.com/Best-Sellers-Computers-Accessories/zgbs/pc"
          }
        ]
      },
      {
        "category_id": "1055398",
        "category_name": "Home & Kitchen",
        "category_url": "https://www.amazon.com/Best-Sellers-Home-Kitchen/zgbs/home-garden",
        "subcategories": [
          {
            "category_id": "1063498",
            "category_name": "Bedding",
            "category_url": "https://www.amazon.com/Best-Sellers-Bedding/zgbs/bedding"
          },
          {
            "category_id": "284507",
            "category_name": "Bath",
            "category_url": "https://www.amazon.com/Best-Sellers-Bath/zgbs/bath"
          }
        ]
      }
    ]
  }
}

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

import requests

url = "https://real-time-amazon-data-the-most-complete.p.rapidapi.com/amazon/category-list"

params = {
    "marketplace": "com"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "real-time-amazon-data-the-most-complete.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()["data"]

for category in data["categories"]:
    print(f"{category['category_name']} ({category['category_id']})")
    for sub in category.get("subcategories", []):
        print(f"  - {sub['category_name']} ({sub['category_id']})")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

const url = "https://real-time-amazon-data-the-most-complete.p.rapidapi.com/amazon/category-list";

const params = new URLSearchParams({
  marketplace: "com"
});

const response = await fetch(`${url}?${params}`, {
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "real-time-amazon-data-the-most-complete.p.rapidapi.com"
  }
});

const { data } = await response.json();
data.categories.forEach(cat => {
  console.log(`${cat.category_name} (${cat.category_id})`);
  cat.subcategories?.forEach(sub => console.log(`  - ${sub.category_name}`));
});

1
2
3
4

curl -G "https://real-time-amazon-data-the-most-complete.p.rapidapi.com/amazon/category-list" \
  --data-urlencode "marketplace=com" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: real-time-amazon-data-the-most-complete.p.rapidapi.com"
Previous Store Search
Next New Releases