Tesco scraper API

UK grocery catalog data from Tesco: categories, shelf listings, prices, promotions, and product detail.

Commerce & delivery 3 capabilities stable 100.0% success rate

What people use it for

Price and promotion monitoring across the UK's largest grocer
Assortment and category-share analysis for CPG and own-label brands
Product content audits covering images, descriptions, nutrition, and allergens
Review and rating tracking for own-label and branded SKUs
GTIN/EAN enrichment for retail data pipelines

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Categories List


            tesco.categories.list

1 credit / request

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

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{},"capability":"tesco.categories.list"}'

Category Products List


            tesco.category.products.list

1 credit / request

List one page of a Tesco category shelf for a taxonomy facet id, with prices, promotions, ratings, and GTINs.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"count":24,"facet":"b;RnJlc2glMjBGb29kJTdDRnJlc2glMjBGcnVpdA==","page":1,"sort_by":"relevance"},"capability":"tesco.category.products.list"}'

Input

Field	Type	Required	Description
`count`	integer	optional	Products per page. Defaults to 24.
`facet`	string	required	Opaque category facet id from tesco.categories.list, e.g. b;RnJlc2glMjBGb29kJTdDRnJlc2glMjBGcnVpdA== (Fresh Fruit).
`page`	integer	optional	1-based shelf page. Defaults to 1.
`sort_by`	string	optional	Upstream sort key. Observed values: relevance (default), price-ascending, price-descending.

Product Detail Get


            tesco.product.detail.get

1 credit / request

Fetch the full Tesco product detail record by tpnc or product URL: price, promotions, reviews, nutrition, ingredients, and availability.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"tpnc":"284477542"},"capability":"tesco.product.detail.get"}'

Input

Field	Type	Required	Description
`tpnc`	string	required	Numeric Tesco product id (tpnc), or a full tesco.com product URL such as https://www.tesco.com/groceries/en-GB/products/284477542.

Run Tesco in under a minute

Get an API key