Ocado API · Endpoint

Ocado 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 ocado.products.search, checks its price and runs it with the same credits as the REST API.

Search public products by ingredient or name, with cursor continuation.

8 credits per call
Failed calls are free
Updated 14 Oct 2026
ocado.products.search

Start free, 100 credits API reference

Response completed

{  "returned": 1,  "items": [    {      "name": "Arla BOB Semi-Skimmed Milk that Tastes like Whole",      "available": true,      "brand": "Arla",      "gtin": null,      "image": "https://www.ocado.com/images-v3/eafa5127-d256-497b-9609-4869092accd6/eeab8dca-610d-4f2f-8e42-31e353192a13/300x300.jpg",      "pack_size": "2L",      "retailer_product_id": "606356011",      "url": "https://www.ocado.com/products/arla-bob-semi-skimmed-milk-that-tastes-like-whole/606356011",      "price": {        "amount": 2.5,        "currency": "GBP"      },      "unit_price": {        "amount": 1.25,        "currency": "GBP",        "unit": "per_litre"      },      "member_prices": [],      "promotions": [        {          "buy_quantity": 2,          "description": "Buy any 2 for £4",          "end": "2026-10-06",          "id": "706e4ca7-e9da-4100-82b5-75107fa08a98",          "start": null,          "type": "multibuy",          "for_price": {            "amount": 4,            "currency": "GBP"          }        }      ]    }  ]}

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	Ingredient or product name.	semi skimmed milk
page_token	string	no

Response

Fields it returns

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

Field	Type	Example
items[].name	string	Arla BOB Semi-Skimmed Milk that Tastes like Whole
items[].price	object	2 fields
items[].available	boolean	true
items[].brand	string	Arla
items[].gtin	null	null
items[].image	string	https://www.ocado.com/images-v3/eafa5127-d256-497b-9609-4869092…
items[].member_prices	array	empty in this sample
items[].pack_size	string	2L
items[].price.amount	number	2.5
items[].price.currency	string	GBP
items[].promotions	array	1 records
items[].promotions[].buy_quantity	integer	2
items[].promotions[].description	string	Buy any 2 for £4
items[].promotions[].end	string	2026-10-06
items[].promotions[].for_price	object	2 fields
items[].promotions[].id	string	706e4ca7-e9da-4100-82b5-75107fa08a98
items[].promotions[].start	null	null
items[].promotions[].type	string	multibuy
items[].retailer_product_id	string	606356011
items[].unit_price	object	3 fields
items[].unit_price.amount	number	1.25
items[].unit_price.currency	string	GBP
items[].unit_price.unit	string	per_litre
items[].url	string	https://www.ocado.com/products/arla-bob-semi-skimmed-milk-that-…
items	array	1 records
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": "ocado.products.search",  "input": {    "query": "semi skimmed milk"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "ocado.products.search",  "input": {    "query": "semi skimmed 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": "ocado.products.search",  "input": {    "query": "semi skimmed milk"  }}),});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 Ocado products search for query "semi skimmed milk". 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.

Ocado