Tesco API Capability

Categories list

Fetch the Tesco Groceries category taxonomy tree with the opaque facet ids used by tesco.category.products.list.

Capability ID tesco.categories.list

Cost From $1.25 per 1,000 requests · 1 credit

Maximum runtime 30 seconds

# 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)

POST /execute Shared execution endpoint

Input parameters

include_raw boolean optional

Include the faithful GraphQL response envelope under `raw`. Defaults to false (normalized `items` only). Default: `false`.

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 The example response is shown in the response panel.

Illustrative output fields

Values illustrate one response. Read the guidance above for missing values and limits; fields can vary with the requested operation and the data available.

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.

Overview, pricing and sample data for every endpoint: Tesco API

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" }'

import json import os import requests payload = json.loads(r'''{ "input": {}, "capability": "tesco.categories.list" }''') 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))

{ "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 } ] }