Amazon Commerce API · Endpoint

Amazon Commerce Category Tree API

Q: What do I send?

Send node or category. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds amazon.category.tree, checks its price and runs it with the same credits as the REST API.

Explore a category: its sub-categories and the filters Amazon offers inside it, ready to pass to search.

0.5 credits per call
Failed calls are free
Updated 10 Oct 2026
amazon.category.tree

Start free, 100 credits API reference

Response completed

{  "original_request": "https://www.amazon.com/b?node=2407749011",  "current_node": {    "name": "",    "id": "2407749011"  },  "available_filters": [    {      "filter_type": "feature",      "options": [        {          "label": "Up to 4.9 in Up to 4.9 in",          "refinement_token": "p_n_feature_browse-bin:212270917011"        },        {          "label": "5 to 5.9 in 5 to 5.9 in",          "refinement_token": "p_n_feature_browse-bin:212270914011"        }      ]    },    {      "filter_type": "p_n_g-101015501406111",      "options": [        {          "label": "2.5 mm 2.5 mm",          "refinement_token": "p_n_g-101015501406111:122268297011"        },        {          "label": "3.5 mm 3.5 mm",          "refinement_token": "p_n_g-101015501406111:122268298011"        }      ]    }  ],  "subcategories": [    {      "name": "Cell Phones & Accessories",      "node_id": "2335752011"    },    {      "name": "Samsung Samsung",      "node_id": "7072561011"    }  ]}

57 rows

#	Filter type
1	feature
2	p_n_g-101015501406111
3	p_n_g-101015688486111
4	p_n_g-101017397158111
5	p_n_g-101015498421111
6	p_n_g-101018080644111
7	p_85
8	p_n_g-1004218864091
9	p_n_customizable_template_name
10	p_90

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
category	string	one of	Category to search or list.
node	string	one of		2407749011
limit	integer	no	Maximum number of results to return. From 1 to 500.	100
page	integer	no	One-based result page to fetch. From 1 to 100.	1

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
available_filters[].filter_type	string	The kind of filter.	feature
available_filters[].options	array	The choices for the filter.	4 records
available_filters[].options[].label	string		Up to 4.9 in Up to 4.9 in
available_filters[].options[].refinement_token	string		p_n_feature_browse-bin:212270917011
available_filters	array	The filters Amazon offers in this category.	57 records
current_node	object	The category you asked for.	2 fields
current_node.id	string	Amazon's ID for the category (browse node).	2407749011
current_node.name	string	The category's name.
original_request	string	The category page read.	https://www.amazon.com/b?node=2407749011
subcategories	array	The categories inside this one.	2 records
subcategories[].name	string	The subcategory's name.	Cell Phones & Accessories
subcategories[].node_id	string	Amazon's ID for the subcategory; pass it as node to go deeper.	2335752011

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "amazon.category.tree",  "input": {    "limit": 100,    "node": "2407749011",    "page": 1  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "amazon.category.tree",  "input": {    "limit": 100,    "node": "2407749011",    "page": 1  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "amazon.category.tree",  "input": {    "limit": 100,    "node": "2407749011",    "page": 1  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, get the Amazon Commerce category tree for node "2407749011". Tell me what it costs before you run it, then show the results as a table.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Amazon Commerce

More from the Amazon Commerce API

Questions

Amazon Commerce Category Tree API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

How much does the Amazon Commerce Category Tree API cost?

0.5 credits per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send node or category. The input fields below list every option with its type and limits.

Do I need an Amazon Commerce login?

No. It reads public Amazon Commerce data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds amazon.category.tree, checks its price and runs it with the same credits as the REST API.

Get started

Your first Amazon Commerce call is free.

Up to 100 free credits to start, no card needed.

Start building for free Book a call