Search public Tesco Groceries products. Items carry GBP price, unit price, Clubcard price, promotion, stock flag, image and rating. Sort by relevance or price and filter by facet, price range or offers. Price and offer filters apply to the current page; filtered_out reports dropped items and total is the unfiltered upstream total. Pages are never relabelled. 1 credit per successful request with data.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
6 optional filters available.
string
Required
Search text, for example milk.
coffee shops
integer
Optional
Page from 1 to 20, default 1.
1
string
Optional
relevance, price-ascending or price-descending.
relevance
number
Optional
Minimum GBP price.
10
number
Optional
Maximum GBP price.
10
boolean
Optional
Only products with a promotion.
true
string
Optional
Facet id from the taxonomy.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"sort": "relevance",
"items": [
{
"id": "254656543",
"name": "British Semi Skimmed Milk",
"price": 1.75,
"currency": "GBP",
"unit_price": 0.77,
"unit_of_measure": "litre"
}
],
"query": "milk"
},
"meta": {
"credits": 1,
"endpoint_family": "search"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Filter Not Honoured
A requested filter or id was rejected.
Source Unavailable
The public source could not be reached.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.