# List categories Browse eBay's public category hierarchy. - Platform: [eBay](https://docs.upscrape.com/docs/platforms/ebay) - Capability ID: `ebay.categories.list` - Cost: 1 credit per request - Maximum runtime: 180 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash 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 '{ "input": {}, "capability": "ebay.categories.list" }' ``` ## Input This capability accepts an empty input object. ### Example input ```json {} ``` ## Response Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "count": 1546, "departments": [ { "browse_url": "https://www.ebay.com/b/eBay-Motors/6000/bn_1865334", "category_id": "6000", "children": [ { "browse_url": "https://www.ebay.com/b/Parts-Accessories/6028/bn_569479", "category_id": "6028", "children": [ { "browse_url": "https://www.ebay.com/b/Car-Truck-Parts-Accessories/6030/bn_562630", "category_id": "6030", "name": "Car & Truck Parts & Accessories", "node_id": "562630", "search_url": "https://www.ebay.com/sch/i.html?_sacat=6030" }, { "browse_url": "https://www.ebay.com/b/Motorcycle-Scooter-Parts-Accessories/10063/bn_557636", "category_id": "10063", "name": "Motorcycle & Scooter Parts & Accessories", "node_id": "557636", "search_url": "https://www.ebay.com/sch/i.html?_sacat=10063" }, { "browse_url": "https://www.ebay.com/b/Performance-Racing-Parts/107057/bn_568110", "category_id": "107057", "name": "Performance & Racing Parts", "node_id": "568110", "search_url": "https://www.ebay.com/sch/i.html?_sacat=107057" } ], "name": "Parts & Accessories", "node_id": "569479", "search_url": "https://www.ebay.com/sch/i.html?_sacat=6028" }, { "browse_url": "https://www.ebay.com/b/Other-Vehicles-Trailers/6038/bn_1865426", "category_id": "6038", "children": [ { "browse_url": "https://www.ebay.com/b/RVs-Campers/50054/bn_16581882", "category_id": "50054", "name": "RVs & Campers", "node_id": "16581882", "search_url": "https://www.ebay.com/sch/i.html?_sacat=50054" }, { "browse_url": "https://www.ebay.com/b/Commercial-Trucks/63732/bn_16581784", "category_id": "63732", "name": "Commercial Trucks", "node_id": "16581784", "search_url": "https://www.ebay.com/sch/i.html?_sacat=63732" }, { "browse_url": "https://www.ebay.com/b/Buses/6728/bn_16581771", "category_id": "6728", "name": "Buses", "node_id": "16581771", "search_url": "https://www.ebay.com/sch/i.html?_sacat=6728" } ], "name": "Other Vehicles & Trailers", "node_id": "1865426", "search_url": "https://www.ebay.com/sch/i.html?_sacat=6038" }, { "browse_url": "https://www.ebay.com/b/Motorcycles/6024/bn_1865434", "category_id": "6024", "name": "Motorcycles", "node_id": "1865434", "search_url": "https://www.ebay.com/sch/i.html?_sacat=6024" } ], "name": "eBay Motors", "node_id": "1865334", "search_url": "https://www.ebay.com/sch/i.html?_sacat=6000" }, { "browse_url": "https://www.ebay.com/b/Electronics/bn_7000259124", "children": [ { "browse_url": "https://www.ebay.com/b/Computers-Tablets-Networking/58058/bn_1865247", "category_id": "58058", "children": [ { "browse_url": "https://www.ebay.com/b/Laptops-Netbooks/175672/bn_1648276", "category_id": "175672", "name": "Laptops & Netbooks", "node_id": "1648276", "search_url": "https://www.ebay.com/sch/i.html?_sacat=175672" }, { "browse_url": "https://www.ebay.com/b/Computer-Components-Parts/175673/bn_1643095", "category_id": "175673", "name": "Computer Components & Parts", "node_id": "1643095", "search_url": "https://www.ebay.com/sch/i.html?_sacat=175673" }, { "browse_url": "https://www.ebay.com/b/Desktops-All-In-One-Computers/171957/bn_1643067", "category_id": "171957", "name": "Desktops & All-In-One Computers", "node_id": "1643067", "search_url": "https://www.ebay.com/sch/i.html?_sacat=171957" } ], "name": "Computers/Tablets & Networking", "node_id": "1865247", "search_url": "https://www.ebay.com/sch/i.html?_sacat=58058" }, { "browse_url": "https://www.ebay.com/b/Cell-Phones-Accessories/15032/bn_1865441", "category_id": "15032", "children": [ { "browse_url": "https://www.ebay.com/b/Cell-Phones-Smartphones/9355/bn_320094", "category_id": "9355", "name": "Cell Phones & Smartphones", "node_id": "320094", "search_url": "https://www.ebay.com/sch/i.html?_sacat=9355" }, { "browse_url": "https://www.ebay.com/b/Portable-Audio-Headphones/15052/bn_1642614", "category_id": "15052", "name": "Portable Audio & Headphones", "node_id": "1642614", "search_url": "https://www.ebay.com/sch/i.html?_sacat=15052" }, { "browse_url": "https://www.ebay.com/b/Cell-Phone-Accessories/9394/bn_320095", "category_id": "9394", "name": "Cell Phone Accessories", "node_id": "320095", "search_url": "https://www.ebay.com/sch/i.html?_sacat=9394" } ], "name": "Cell Phones & Accessories", "node_id": "1865441", "search_url": "https://www.ebay.com/sch/i.html?_sacat=15032" }, { "browse_url": "https://www.ebay.com/b/Video-Games-Consoles/1249/bn_1850232", "category_id": "1249", "children": [ { "browse_url": "https://www.ebay.com/b/Video-Games/139973/bn_320034", "category_id": "139973", "name": "Video Games", "node_id": "320034", "search_url": "https://www.ebay.com/sch/i.html?_sacat=139973" }, { "browse_url": "https://www.ebay.com/b/Video-Game-Consoles/139971/bn_320033", "category_id": "139971", "name": "Video Game Consoles", "node_id": "320033", "search_url": "https://www.ebay.com/sch/i.html?_sacat=139971" }, { "browse_url": "https://www.ebay.com/b/Video-Game-Accessories/54968/bn_1642249", "category_id": "54968", "name": "Video Game Accessories", "node_id": "1642249", "search_url": "https://www.ebay.com/sch/i.html?_sacat=54968" } ], "name": "Video Games & Consoles", "node_id": "1850232", "search_url": "https://www.ebay.com/sch/i.html?_sacat=1249" } ], "name": "Electronics", "node_id": "7000259124" }, { "browse_url": "https://www.ebay.com/b/Collectibles-Art/bn_7000259855", "children": [ { "browse_url": "https://www.ebay.com/b/Sports-Mem-Cards-Fan-Shop/64482/bn_1857919", "category_id": "64482", "children": [ { "browse_url": "https://www.ebay.com/b/Sports-Trading-Cards-Accessories/212/bn_1859819", "category_id": "212", "name": "Sports Trading Cards & Accessories", "node_id": "1859819", "search_url": "https://www.ebay.com/sch/i.html?_sacat=212" }, { "browse_url": "https://www.ebay.com/b/Sports-Fan-Apparel-Souvenirs/24409/bn_1865379", "category_id": "24409", "name": "Sports Fan Apparel & Souvenirs", "node_id": "1865379", "search_url": "https://www.ebay.com/sch/i.html?_sacat=24409" }, { "browse_url": "https://www.ebay.com/b/Original-Sport-Autographed-Items/51/bn_1865327", "category_id": "51", "name": "Original Sport Autographed Items", "node_id": "1865327", "search_url": "https://www.ebay.com/sch/i.html?_sacat=51" } ], "name": "Sports Mem, Cards & Fan Shop", "node_id": "1857919", "search_url": "https://www.ebay.com/sch/i.html?_sacat=64482" }, { "browse_url": "https://www.ebay.com/b/Collectibles/1/bn_1858810", "category_id": "1", "children": [ { "browse_url": "https://www.ebay.com/b/Comic-Books-Manga-Memorabilia/63/bn_1865459", "category_id": "63", "name": "Comic Books, Manga & Memorabilia", "node_id": "1865459", "search_url": "https://www.ebay.com/sch/i.html?_sacat=63" }, { "browse_url": "https://www.ebay.com/b/Collectible-Knives-Swords-Blades-Armors-Accessories/1401/bn_1854534", "category_id": "1401", "name": "Collectible Knives, Swords, Blades, Armors & Accessories", "node_id": "1854534", "search_url": "https://www.ebay.com/sch/i.html?_sacat=1401" }, { "browse_url": "https://www.ebay.com/b/Decorative-Collectibles/13777/bn_1853834", "category_id": "13777", "name": "Decorative Collectibles", "node_id": "1853834", "search_url": "https://www.ebay.com/sch/i.html?_sacat=13777" } ], "name": "Collectibles", "node_id": "1858810", "search_url": "https://www.ebay.com/sch/i.html?_sacat=1" }, { "browse_url": "https://www.ebay.com/b/Coins-Paper-Money/11116/bn_1857806", "category_id": "11116", "children": [ { "browse_url": "https://www.ebay.com/b/World-Coins/256/bn_1851558", "category_id": "256", "name": "World Coins", "node_id": "1851558", "search_url": "https://www.ebay.com/sch/i.html?_sacat=256" }, { "browse_url": "https://www.ebay.com/b/US-Coins/253/bn_1848949", "category_id": "253", "name": "US Coins", "node_id": "1848949", "search_url": "https://www.ebay.com/sch/i.html?_sacat=253" }, { "browse_url": "https://www.ebay.com/b/US-Paper-Money/3412/bn_1858509", "category_id": "3412", "name": "US Paper Money", "node_id": "1858509", "search_url": "https://www.ebay.com/sch/i.html?_sacat=3412" } ], "name": "Coins & Paper Money", "node_id": "1857806", "search_url": "https://www.ebay.com/sch/i.html?_sacat=11116" } ], "name": "Collectibles & Art", "node_id": "7000259855" } ] } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `count` | `integer` | 1546 | | `departments` | `array` | 3 items | | `departments` | `array` | 3 items | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. ## Related documentation - [Authentication](https://docs.upscrape.com/docs/api/authentication) - [Jobs and results](https://docs.upscrape.com/docs/api/jobs) - [Errors and retries](https://docs.upscrape.com/docs/api/errors) - [Idempotency](https://docs.upscrape.com/docs/api/idempotency)