Waitrose API · Endpoint

Waitrose Product Reviews API

Q: What do I send?

Send product_id or url. 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 waitrose.product.reviews.list, checks its price and runs it with the same credits as the REST API.

List public product reviews with verified offset paging, rating filter and sort.

2 credits per call
Failed calls are free
Updated 6 Oct 2026
waitrose.product.reviews.list

Start free, 100 credits API reference

Response completed

{  "review_count": 740,  "next_offset": 1,  "rating_average": 4.655251141552512,  "rating_count": 876,  "returned": 1,  "reviews": [    {      "title": "Example review",      "text": "Example public review text",      "rating": 5,      "helpful_votes": 0,      "id": "example-review",      "submitted_at": "2026-10-04T13:33:51.000+00:00"    }  ],  "rating_histogram": [    {      "rating": 5,      "count": 692    },    {      "rating": 4,      "count": 118    }  ]}

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
product_id	string	one of	Product identifier.	053457-26759-26760
url	string	one of	Public URL of the page to fetch.
limit	integer	no	Maximum number of results to return. From 1 to 50.	1
offset	integer	no	Zero-based number of results to skip. From 0 to 5000.	0
rating	integer	no	From 1 to 5.
sort	string	no	Sort order for returned results. Allowed values: `recent`, `oldest`, `highest`, `lowest`, `helpful`.	recent

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	Example
review_count	integer	740
reviews	array	1 records
reviews[].helpful_votes	integer	0
reviews[].id	string	example-review
reviews[].rating	integer	5
reviews[].submitted_at	string	2026-10-04T13:33:51.000+00:00
reviews[].text	string	Example public review text
reviews[].title	string	Example review
next_offset	integer	1
rating_average	number	4.66
rating_count	integer	876
rating_histogram	array	3 records
rating_histogram[].count	integer	692
rating_histogram[].rating	integer	5
returned	integer	1

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": "waitrose.product.reviews.list",  "input": {    "limit": 1,    "offset": 0,    "product_id": "053457-26759-26760",    "sort": "recent"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "waitrose.product.reviews.list",  "input": {    "limit": 1,    "offset": 0,    "product_id": "053457-26759-26760",    "sort": "recent"  }}''')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": "waitrose.product.reviews.list",  "input": {    "limit": 1,    "offset": 0,    "product_id": "053457-26759-26760",    "sort": "recent"  }}),});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

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, get the Waitrose product reviews for product id "053457-26759-26760" and sort "recent". Tell me what it costs before you run it, then show the results as a table.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Waitrose