eBay API · Endpoint

eBay Categories API

Q: Can my AI agent call it?

Yes, over MCP: the agent finds ebay.categories.list, checks its price and runs it with the same credits as the REST API.

Get eBay's category tree with IDs and links, to filter searches by category.

1 credit per call
Failed calls are free
Updated 14 Oct 2026
ebay.categories.list

Start free, 100 credits API reference

Response completed

{  "count": 1546,  "departments": [    {      "name": "eBay Motors",      "browse_url": "https://www.ebay.com/b/eBay-Motors/6000/bn_1865334",      "category_id": "6000",      "node_id": "1865334",      "search_url": "https://www.ebay.com/sch/i.html?_sacat=6000",      "children": [        {          "name": "Parts & Accessories",          "browse_url": "https://www.ebay.com/b/Parts-Accessories/6028/bn_569479",          "category_id": "6028",          "node_id": "569479",          "search_url": "https://www.ebay.com/sch/i.html?_sacat=6028",          "children": [            {              "name": "Car & Truck Parts & Accessories",              "browse_url": "https://www.ebay.com/b/Car-Truck-Parts-Accessories/6030/bn_562630",              "category_id": "6030",              "node_id": "562630",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=6030"            },            {              "name": "Motorcycle & Scooter Parts & Accessories",              "browse_url": "https://www.ebay.com/b/Motorcycle-Scooter-Parts-Accessories/10063/bn_557636",              "category_id": "10063",              "node_id": "557636",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=10063"            }          ]        },        {          "name": "Other Vehicles & Trailers",          "browse_url": "https://www.ebay.com/b/Other-Vehicles-Trailers/6038/bn_1865426",          "category_id": "6038",          "node_id": "1865426",          "search_url": "https://www.ebay.com/sch/i.html?_sacat=6038",          "children": [            {              "name": "RVs & Campers",              "browse_url": "https://www.ebay.com/b/RVs-Campers/50054/bn_16581882",              "category_id": "50054",              "node_id": "16581882",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=50054"            },            {              "name": "Commercial Trucks",              "browse_url": "https://www.ebay.com/b/Commercial-Trucks/63732/bn_16581784",              "category_id": "63732",              "node_id": "16581784",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=63732"            }          ]        }      ]    },    {      "name": "Electronics",      "browse_url": "https://www.ebay.com/b/Electronics/bn_7000259124",      "node_id": "7000259124",      "children": [        {          "name": "Computers/Tablets & Networking",          "browse_url": "https://www.ebay.com/b/Computers-Tablets-Networking/58058/bn_1865247",          "category_id": "58058",          "node_id": "1865247",          "search_url": "https://www.ebay.com/sch/i.html?_sacat=58058",          "children": [            {              "name": "Laptops & Netbooks",              "browse_url": "https://www.ebay.com/b/Laptops-Netbooks/175672/bn_1648276",              "category_id": "175672",              "node_id": "1648276",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=175672"            },            {              "name": "Computer Components & Parts",              "browse_url": "https://www.ebay.com/b/Computer-Components-Parts/175673/bn_1643095",              "category_id": "175673",              "node_id": "1643095",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=175673"            }          ]        },        {          "name": "Cell Phones & Accessories",          "browse_url": "https://www.ebay.com/b/Cell-Phones-Accessories/15032/bn_1865441",          "category_id": "15032",          "node_id": "1865441",          "search_url": "https://www.ebay.com/sch/i.html?_sacat=15032",          "children": [            {              "name": "Cell Phones & Smartphones",              "browse_url": "https://www.ebay.com/b/Cell-Phones-Smartphones/9355/bn_320094",              "category_id": "9355",              "node_id": "320094",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=9355"            },            {              "name": "Portable Audio & Headphones",              "browse_url": "https://www.ebay.com/b/Portable-Audio-Headphones/15052/bn_1642614",              "category_id": "15052",              "node_id": "1642614",              "search_url": "https://www.ebay.com/sch/i.html?_sacat=15052"            }          ]        }      ]    }  ]}

3 rows

#	Name	Browse url	Category id	Node id	Search url
1	eBay Motors	https://www.ebay.com/b/eBay-Motors/6000/bn_1865334	6000	1865334	https://www.ebay.com/sch/i.html?_sacat=6000
2	Electronics	https://www.ebay.com/b/Electronics/bn_7000259124		7000259124
3	Collectibles & Art	https://www.ebay.com/b/Collectibles-Art/bn_7000259855		7000259855

Try it live, free

Response

Fields it returns

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

Field	Type	What it is	Example
departments[].children[].name	string	The category name as eBay shows it.	Parts & Accessories
departments[].name	string	The category or department name as eBay shows it.	eBay Motors
departments[].browse_url	string	eBay's browse page for this category.	https://www.ebay.com/b/eBay-Motors/6000/bn_1865334
departments[].category_id	string	eBay's ID for the category.	6000
departments[].children	array	Subcategories under this one.	3 records
departments[].children[].browse_url	string	eBay's browse page for this category.	https://www.ebay.com/b/Parts-Accessories/6028/bn_569479
departments[].children[].category_id	string	eBay's ID for the category.	6028
departments[].children[].children	array	Subcategories under this category.	3 records
departments[].children[].node_id	string	eBay's browse node ID for the category.	569479
departments[].children[].search_url	string	An eBay search limited to this category.	https://www.ebay.com/sch/i.html?_sacat=6028
departments[].node_id	string	eBay's browse node ID for the category.	1865334
departments[].search_url	string	An eBay search limited to this category.	https://www.ebay.com/sch/i.html?_sacat=6000
count	integer	How many entries the response holds.	1546
departments	array	eBay's top-level departments.	3 records

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": "ebay.categories.list",  "input": {}}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "ebay.categories.list",  "input": {}}''')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": "ebay.categories.list",  "input": {}}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));