# Categories list Fetch the Tesco Groceries category taxonomy tree with the opaque facet ids used by tesco.category.products.list. - Platform: [Tesco](https://docs.upscrape.com/docs/platforms/tesco) - Capability ID: `tesco.categories.list` - Cost: 1 credit per request - Maximum runtime: 30 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": "tesco.categories.list" }' ``` ## Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `include_raw` | `boolean` | No | Include the faithful GraphQL response envelope under `raw`. Defaults to false (normalized `items` only). Default: `false`. | ### 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 { "items": [ { "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXM=", "children": [ { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Bags", "pageType": "NONE", "parent": "Womens Accessories" }, { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Gloves", "pageType": "NONE", "parent": "Womens Accessories" }, { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Hats", "pageType": "NONE", "parent": "Womens Accessories" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Womens Accessories", "pageType": "NONE", "parent": "Women" }, { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Blouses", "pageType": "NONE", "parent": "Womens Blouses & Shirts" }, { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Shirts", "pageType": "NONE", "parent": "Womens Blouses & Shirts" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Womens Blouses & Shirts", "pageType": "NONE", "parent": "Women" }, { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Co-Ords", "pageType": "NONE", "parent": "Womens Co ords" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Womens Co ords", "pageType": "NONE", "parent": "Women" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Women", "pageType": "CATEGORY", "parent": "Clothing & Accessories" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Plunge Bras", "pageType": "NONE", "parent": "Bras" }, { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "T-shirt Bras", "pageType": "NONE", "parent": "Bras" }, { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Push up Bras", "pageType": "NONE", "parent": "Bras" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Bras", "pageType": "NONE", "parent": "Lingerie & Nightwear" }, { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Bikini Briefs", "pageType": "NONE", "parent": "Knickers" }, { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Full Brief", "pageType": "NONE", "parent": "Knickers" }, { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "High Leg Knickers", "pageType": "NONE", "parent": "Knickers" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Knickers", "pageType": "NONE", "parent": "Lingerie & Nightwear" }, { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Bra & Knicker Sets", "pageType": "NONE", "parent": "Sets" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Sets", "pageType": "NONE", "parent": "Lingerie & Nightwear" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Lingerie & Nightwear", "pageType": "NONE", "parent": "Clothing & Accessories" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Accessories", "pageType": "NONE", "parent": "Holiday Shop" }, { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Shorts", "pageType": "NONE", "parent": "Holiday Shop" }, { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Swimwear", "pageType": "NONE", "parent": "Holiday Shop" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Holiday Shop", "pageType": "NONE", "parent": "Men" }, { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "T-Shirts & Polos", "pageType": "NONE", "parent": "The F&F Edit" }, { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Shirts", "pageType": "NONE", "parent": "The F&F Edit" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "The F&F Edit", "pageType": "NONE", "parent": "Men" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Hats, Gloves & Scarves", "pageType": "NONE", "parent": "Mens Accessories" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Mens Accessories", "pageType": "NONE", "parent": "Men" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Men", "pageType": "NONE", "parent": "Clothing & Accessories" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "superDepartment", "name": "Clothing & Accessories", "pageType": "NONE", "parent": null }, { "catId": "b;U3VtbWVy", "children": [ { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Finest BBQ Food", "pageType": "NONE", "parent": "Finest BBQ Food" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Finest BBQ Food", "pageType": "NONE", "parent": "Your Finest Favourites" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Finest Ice Creams & Desserts", "pageType": "NONE", "parent": "Finest Ice Creams & Desserts" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Finest Ice Creams & Desserts", "pageType": "NONE", "parent": "Your Finest Favourites" }, { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Finest Picnic Food", "pageType": "NONE", "parent": "Finest Picnic Food" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Finest Picnic Food", "pageType": "NONE", "parent": "Your Finest Favourites" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Your Finest Favourites", "pageType": "NONE", "parent": "Summer" }, { "catId": "b;U3VtbWVyJTdDRHJpbmtz", "children": [ { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Finest Drinks", "pageType": "NONE", "parent": "Finest Drinks" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Finest Drinks", "pageType": "NONE", "parent": "Drinks" }, { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Beer", "pageType": "NONE", "parent": "Beer & Cider" }, { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Cider", "pageType": "NONE", "parent": "Beer & Cider" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Beer & Cider", "pageType": "NONE", "parent": "Drinks" }, { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Red Wine", "pageType": "NONE", "parent": "Wine & Prosecco" }, { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "White Wine", "pageType": "NONE", "parent": "Wine & Prosecco" }, { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Rose Wine", "pageType": "NONE", "parent": "Wine & Prosecco" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Wine & Prosecco", "pageType": "NONE", "parent": "Drinks" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Drinks", "pageType": "NONE", "parent": "Summer" }, { "catId": "b;U3VtbWVyJTdDQkJRJTIwRm9vZA==", "children": [ { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "BBQ Chicken, Meat & Fish", "pageType": "NONE", "parent": "Chicken, Meat & Fish" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Chicken, Meat & Fish", "pageType": "NONE", "parent": "BBQ Food" }, { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Plant Based & Vegetarian", "pageType": "NONE", "parent": "Plant Based & Vegetarian" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Plant Based & Vegetarian", "pageType": "NONE", "parent": "BBQ Food" }, { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "BBQ Rolls, Buns & Breads", "pageType": "NONE", "parent": "Rolls, Buns & Breads" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Rolls, Buns & Breads", "pageType": "NONE", "parent": "BBQ Food" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "BBQ Food", "pageType": "NONE", "parent": "Summer" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "superDepartment", "name": "Summer", "pageType": "CATEGORY", "parent": null }, { "catId": "b;QmFjayUyMFRvJTIwU2Nob29s", "children": [ { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]==", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Back To School Pens & Pencils", "pageType": "NONE", "parent": "Pens & Pencils" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Pens & Pencils", "pageType": "NONE", "parent": "Stationery, Arts & Crafts" }, { "catId": "b;[redacted:token]", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Back To School Markers & Highlighters", "pageType": "NONE", "parent": "Markers & Highlighters" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Markers & Highlighters", "pageType": "NONE", "parent": "Stationery, Arts & Crafts" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Back To School Notebooks, Pads & Diaries", "pageType": "NONE", "parent": "Notebooks, Pads & Diaries" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Notebooks, Pads & Diaries", "pageType": "NONE", "parent": "Stationery, Arts & Crafts" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Stationery, Arts & Crafts", "pageType": "NONE", "parent": "Back To School" }, { "catId": "b;QmFjayUyMFRvJTIwU2Nob29sJTdDTHVuY2hib3g=", "children": [ { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Back To School Lunch Boxes & Lunch Bags", "pageType": "NONE", "parent": "Lunch Boxes & Lunch Bags" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Lunch Boxes & Lunch Bags", "pageType": "NONE", "parent": "Lunchbox" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]=", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "Back To School Water Bottles", "pageType": "NONE", "parent": "Water Bottles" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "Water Bottles", "pageType": "NONE", "parent": "Lunchbox" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "Lunchbox", "pageType": "NONE", "parent": "Back To School" }, { "catId": "b;[redacted:token]=", "children": [ { "catId": "b;[redacted:token]==", "children": [ { "catId": "b;[redacted:token]", "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "shelf", "name": "School Bags & Backpacks", "pageType": "NONE", "parent": "School Bags & Backpacks" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "aisle", "name": "School Bags & Backpacks", "pageType": "NONE", "parent": "School Bags & Backpacks" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "department", "name": "School Bags & Backpacks", "pageType": "NONE", "parent": "Back To School" } ], "images": [ { "images": [ { "type": "standard" } ], "style": "thumbnail" } ], "label": "superDepartment", "name": "Back To School", "pageType": "CATEGORY", "parent": null } ] } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `items` | `array` | 3 items | | `items` | `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)