Tesco API · Endpoint

Tesco Products Search API

Q: What do I send?

Send query. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds tesco.products.search, checks its price and runs it with the same credits as the REST API.

Search Tesco Groceries UK by keyword and return ranked product ids and canonical product URLs for one results page.

1 credit per call
Failed calls are free
Updated 23 Oct 2026
tesco.products.search

Start free, 100 credits API reference

Response completed

{  "items": [    {      "position": 1,      "tpnc": "309449739",      "url": "https://www.tesco.com/shop/en-GB/products/309449739"    },    {      "position": 2,      "tpnc": "320980398",      "url": "https://www.tesco.com/shop/en-GB/products/320980398"    }  ]}

3 rows

#	Position	Tpnc	Url
1	1	309449739	https://www.tesco.com/shop/en-GB/products/309449739
2	2	320980398	https://www.tesco.com/shop/en-GB/products/320980398
3	3	287971983	https://www.tesco.com/shop/en-GB/products/287971983

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
query	string	yes	Product search term, for example milk.	milk
include_raw	boolean	no	Accepted for parity with the other capabilities; the search capability returns no raw envelope. Default: `false`.
page	integer	no	1-based search results page. Defaults to 1. At least 1. Default: `1`.	1

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[].position	integer		1
items[].tpnc	string	Tesco product number, returned as id in these rows and accepted by the tpnc input.	309449739
items[].url	string		https://www.tesco.com/shop/en-GB/products/309449739
items	array		3 records

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "tesco.products.search",  "input": {    "page": 1,    "query": "milk"  }}'

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