Tesco API · Endpoint
Tesco Categories API
Read Tesco’s nested category tree, then reuse the returned facet for the category you want to collect.
- 1 credit per call
- Failed calls are free
- Updated
- tesco.categories.list
Response
completed
{ "raw": { "status": 200, "data": { "taxonomy": [ { "name": "Clothing & Accessories", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXM=", "label": "superDepartment", "pageType": "NONE", "parent": null, "children": [ { "name": "Women", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbg==", "label": "department", "pageType": "CATEGORY", "parent": "Clothing & Accessories", "children": [ { "name": "Style It Out AW Campaign", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1N0eWxlJTIwSXQlMjBPdXQlMjBBVyUyMENhbXBhaWdu", "label": "aisle", "pageType": "NONE", "parent": "Women", "children": [ { "name": "Coats & Jackets", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1N0eWxlJTIwSXQlMjBPdXQlMjBBVyUyMENhbXBhaWduJTdDQ29hdHMlMjAmJTIwSmFja2V0cw==", "label": "shelf", "pageType": "NONE", "parent": "Style It Out AW Campaign", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Knitwear", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1N0eWxlJTIwSXQlMjBPdXQlMjBBVyUyMENhbXBhaWduJTdDS25pdHdlYXI=", "label": "shelf", "pageType": "NONE", "parent": "Style It Out AW Campaign", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Womens Accessories", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1dvbWVucyUyMEFjY2Vzc29yaWVz", "label": "aisle", "pageType": "NONE", "parent": "Women", "children": [ { "name": "Bags", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1dvbWVucyUyMEFjY2Vzc29yaWVzJTdDQmFncw==", "label": "shelf", "pageType": "NONE", "parent": "Womens Accessories", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Gloves", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1dvbWVucyUyMEFjY2Vzc29yaWVzJTdDR2xvdmVz", "label": "shelf", "pageType": "NONE", "parent": "Womens Accessories", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Lingerie & Nightwear", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXI=", "label": "department", "pageType": "CATEGORY", "parent": "Clothing & Accessories", "children": [ { "name": "Bras", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NCcmFz", "label": "aisle", "pageType": "NONE", "parent": "Lingerie & Nightwear", "children": [ { "name": "Balcony Bras", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NCcmFzJTdDQmFsY29ueSUyMEJyYXM=", "label": "shelf", "pageType": "NONE", "parent": "Bras", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Plunge Bras", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NCcmFzJTdDUGx1bmdlJTIwQnJhcw==", "label": "shelf", "pageType": "NONE", "parent": "Bras", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Knickers", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NLbmlja2Vycw==", "label": "aisle", "pageType": "NONE", "parent": "Lingerie & Nightwear", "children": [ { "name": "Bikini Briefs", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NLbmlja2VycyU3Q0Jpa2luaSUyMEJyaWVmcw==", "label": "shelf", "pageType": "NONE", "parent": "Knickers", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Full Brief Knickers", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NLbmlja2VycyU3Q0Z1bGwlMjBCcmllZiUyMEtuaWNrZXJz", "label": "shelf", "pageType": "NONE", "parent": "Knickers", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Halloween", "catId": "b;SGFsbG93ZWVu", "label": "superDepartment", "pageType": "CATEGORY", "parent": null, "children": [ { "name": "Top Picks", "catId": "b;SGFsbG93ZWVuJTdDVG9wJTIwUGlja3M=", "label": "department", "pageType": "NONE", "parent": "Halloween", "children": [ { "name": "Halloween Top Picks", "catId": "b;SGFsbG93ZWVuJTdDVG9wJTIwUGlja3MlN0NIYWxsb3dlZW4lMjBUb3AlMjBQaWNrcw==", "label": "aisle", "pageType": "NONE", "parent": "Top Picks", "children": [ { "name": "Halloween Top Picks", "catId": "b;SGFsbG93ZWVuJTdDVG9wJTIwUGlja3MlN0NIYWxsb3dlZW4lMjBUb3AlMjBQaWNrcyU3Q0hhbGxvd2VlbiUyMFRvcCUyMFBpY2tz", "label": "shelf", "pageType": "NONE", "parent": "Halloween Top Picks", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Boo Basket", "catId": "b;SGFsbG93ZWVuJTdDQm9vJTIwQmFza2V0", "label": "department", "pageType": "NONE", "parent": "Halloween", "children": [ { "name": "Boo Basket", "catId": "b;SGFsbG93ZWVuJTdDQm9vJTIwQmFza2V0JTdDQm9vJTIwQmFza2V0", "label": "aisle", "pageType": "NONE", "parent": "Boo Basket", "children": [ { "name": "Boo Basket", "catId": "b;SGFsbG93ZWVuJTdDQm9vJTIwQmFza2V0JTdDQm9vJTIwQmFza2V0JTdDQm9vJTIwQmFza2V0", "label": "shelf", "pageType": "NONE", "parent": "Boo Basket", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ] } }, "items": [ { "name": "Clothing & Accessories", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXM=", "label": "superDepartment", "pageType": "NONE", "parent": null, "children": [ { "name": "Women", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbg==", "label": "department", "pageType": "CATEGORY", "parent": "Clothing & Accessories", "children": [ { "name": "Style It Out AW Campaign", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1N0eWxlJTIwSXQlMjBPdXQlMjBBVyUyMENhbXBhaWdu", "label": "aisle", "pageType": "NONE", "parent": "Women", "children": [ { "name": "Coats & Jackets", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1N0eWxlJTIwSXQlMjBPdXQlMjBBVyUyMENhbXBhaWduJTdDQ29hdHMlMjAmJTIwSmFja2V0cw==", "label": "shelf", "pageType": "NONE", "parent": "Style It Out AW Campaign", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Knitwear", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1N0eWxlJTIwSXQlMjBPdXQlMjBBVyUyMENhbXBhaWduJTdDS25pdHdlYXI=", "label": "shelf", "pageType": "NONE", "parent": "Style It Out AW Campaign", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Womens Accessories", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1dvbWVucyUyMEFjY2Vzc29yaWVz", "label": "aisle", "pageType": "NONE", "parent": "Women", "children": [ { "name": "Bags", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1dvbWVucyUyMEFjY2Vzc29yaWVzJTdDQmFncw==", "label": "shelf", "pageType": "NONE", "parent": "Womens Accessories", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Gloves", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbiU3Q1dvbWVucyUyMEFjY2Vzc29yaWVzJTdDR2xvdmVz", "label": "shelf", "pageType": "NONE", "parent": "Womens Accessories", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Lingerie & Nightwear", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXI=", "label": "department", "pageType": "CATEGORY", "parent": "Clothing & Accessories", "children": [ { "name": "Bras", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NCcmFz", "label": "aisle", "pageType": "NONE", "parent": "Lingerie & Nightwear", "children": [ { "name": "Balcony Bras", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NCcmFzJTdDQmFsY29ueSUyMEJyYXM=", "label": "shelf", "pageType": "NONE", "parent": "Bras", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Plunge Bras", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NCcmFzJTdDUGx1bmdlJTIwQnJhcw==", "label": "shelf", "pageType": "NONE", "parent": "Bras", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Knickers", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NLbmlja2Vycw==", "label": "aisle", "pageType": "NONE", "parent": "Lingerie & Nightwear", "children": [ { "name": "Bikini Briefs", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NLbmlja2VycyU3Q0Jpa2luaSUyMEJyaWVmcw==", "label": "shelf", "pageType": "NONE", "parent": "Knickers", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Full Brief Knickers", "catId": "b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NMaW5nZXJpZSUyMCYlMjBOaWdodHdlYXIlN0NLbmlja2VycyU3Q0Z1bGwlMjBCcmllZiUyMEtuaWNrZXJz", "label": "shelf", "pageType": "NONE", "parent": "Knickers", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Halloween", "catId": "b;SGFsbG93ZWVu", "label": "superDepartment", "pageType": "CATEGORY", "parent": null, "children": [ { "name": "Top Picks", "catId": "b;SGFsbG93ZWVuJTdDVG9wJTIwUGlja3M=", "label": "department", "pageType": "NONE", "parent": "Halloween", "children": [ { "name": "Halloween Top Picks", "catId": "b;SGFsbG93ZWVuJTdDVG9wJTIwUGlja3MlN0NIYWxsb3dlZW4lMjBUb3AlMjBQaWNrcw==", "label": "aisle", "pageType": "NONE", "parent": "Top Picks", "children": [ { "name": "Halloween Top Picks", "catId": "b;SGFsbG93ZWVuJTdDVG9wJTIwUGlja3MlN0NIYWxsb3dlZW4lMjBUb3AlMjBQaWNrcyU3Q0hhbGxvd2VlbiUyMFRvcCUyMFBpY2tz", "label": "shelf", "pageType": "NONE", "parent": "Halloween Top Picks", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] }, { "name": "Boo Basket", "catId": "b;SGFsbG93ZWVuJTdDQm9vJTIwQmFza2V0", "label": "department", "pageType": "NONE", "parent": "Halloween", "children": [ { "name": "Boo Basket", "catId": "b;SGFsbG93ZWVuJTdDQm9vJTIwQmFza2V0JTdDQm9vJTIwQmFza2V0", "label": "aisle", "pageType": "NONE", "parent": "Boo Basket", "children": [ { "name": "Boo Basket", "catId": "b;SGFsbG93ZWVuJTdDQm9vJTIwQmFza2V0JTdDQm9vJTIwQmFza2V0JTdDQm9vJTIwQmFza2V0", "label": "shelf", "pageType": "NONE", "parent": "Boo Basket", "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ], "images": [ { "style": "thumbnail", "images": [ { "type": "standard" } ] } ] } ]}
| # | Name | Cat id | Label | Page type |
|---|---|---|---|---|
| 1 | Clothing & Accessories | b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXM= | superDepartment | NONE |
| 2 | Halloween | b;SGFsbG93ZWVu | superDepartment | CATEGORY |
| 3 | Christmas | b;Q2hyaXN0bWFz | superDepartment | CATEGORY |
| 4 | Tesco Finest | b;VGVzY28lMjBGaW5lc3Q= | superDepartment | NONE |
| 5 | Marketplace | b;TWFya2V0cGxhY2U= | superDepartment | NONE |
| 6 | Fresh Food | b;RnJlc2glMjBGb29k | superDepartment | NONE |
| 7 | Bakery | b;QmFrZXJ5 | superDepartment | CATEGORY |
| 8 | Frozen Food | b;RnJvemVuJTIwRm9vZA== | superDepartment | CATEGORY |
| 9 | Treats & Snacks | b;VHJlYXRzJTIwJiUyMFNuYWNrcw== | superDepartment | CATEGORY |
| 10 | Food Cupboard | b;Rm9vZCUyMEN1cGJvYXJk | superDepartment | CATEGORY |
Input
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| include_raw | boolean | no | Include the faithful GraphQL response envelope under raw. Defaults to false (normalized items only). Default: false. |
Response
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].children | array | Number of immediate child categories. The complete nested tree is in the JSON. | 11 records |
| items[].children[].name | string | The category's name, such as Women. | Women |
| items[].name | string | The entry's name, such as Women. | Clothing & Accessories |
| items[].catId | string | Tesco's ID for the category. | b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXM= |
| items[].children[].catId | string | Tesco's ID for the category; pass it unchanged as facet. | b;Q2xvdGhpbmclMjAmJTIwQWNjZXNzb3JpZXMlN0NXb21lbg== |
| items[].children[].children | array | Categories under this one. | 19 records |
| items[].children[].images | array | Images for the category. | 1 records |
| items[].children[].label | string | The kind of entry, such as department. | department |
| items[].children[].pageType | string | The kind of page it links to, such as CATEGORY. | CATEGORY |
| items[].children[].parent | string | The entry it sits under, such as Clothing & Accessories. | Clothing & Accessories |
| items[].images | array | Product images. | 1 records |
| items[].images[].images | array | The image versions in this style. | 1 records |
| items[].images[].style | string | The image style, such as thumbnail. | thumbnail |
| items[].label | string | The kind of entry, such as department. | superDepartment |
| items[].pageType | string | The kind of page the entry links to, such as CATEGORY. | NONE |
| items[].parent | null | The entry it sits under, such as Clothing & Accessories. | null |
| items | array | The products or entries returned. | 24 records |
| raw | object | Tesco's own response, as it came back. | 2 fields |
| raw.data | object | The data part of Tesco's response. | 1 fields |
| raw.data.taxonomy | array | Tesco's category tree. | 24 records |
| raw.status | integer | Tesco's response status code. | 200 |
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": "tesco.categories.list", "input": {}}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tesco.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": "tesco.categories.list", "input": {}}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
In your AI agent
Claude · Cursor · any MCP client
1Add the Upscrape MCP server
2Ask for the data in plain words
The agent finds the endpoint, shows you the price, and runs it with your credits.
https://data.upscrape.com/mcp
Use Upscrape to find Tesco’s Fresh Fruit category and collect its first five products. Show the product ID, title, pack price and unit price. Only compare unit prices with matching units.
Tesco
More from the Tesco API
Same data, other platforms
The same data from other platforms
Aldi UKCategories
AsdaCategories
BlinkitCategories
Flipkart CommerceSearch categories
Flipkart MinutesDiscover categories
IcelandCategories
Questions
Tesco Categories API FAQ
The short answers. The docs have the long ones.
Still have a question?
Talk to the people who build the endpoints.
How much does the Tesco Categories API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Every input is optional; the input fields below list what each one does.
Do I need a Tesco login?
No. It reads public Tesco data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds tesco.categories.list, checks its price and runs it with the same credits as the REST API.
Get started
Your first Tesco call is free.
Up to 100 free credits to start, no card needed.