Ocado API reference
See Ocado's prices, price per litre or kilo and every offer, from Buy any 2 to Half Price, for any search or category.
Ocado does not offer a public API for its product data. Upscrape's Ocado API returns what ocado.com shows a shopper: each product's price, pack size, price per litre or kilo, availability and offers, as JSON.
Ocado sells its own range and M&S food beside branded groceries, so one search shows how they line up on price. Offers keep Ocado's wording and, for multibuys, the quantity and the total.
You can also read product reviews with the spread of star ratings, list the first page of a category with its total and see the products Ocado puts on its homepage.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
ocado.products.search |
Search Ocado by product or ingredient, such as semi skimmed milk. | 10 credits |
ocado.promotions.list |
List the products on Ocado's offers page, with the price now and wording such as "Now £3.95, was £6". | 10 credits |
ocado.product.detail.get |
Read one product by its Ocado product number or link, including any offer and the date it ends. | 1 credit |
ocado.category.products.list |
List the first page of an Ocado category, about 50 products, with the number of products the category holds. | 10 credits |
ocado.product.reviews.list |
Read a product's reviews with its average rating and star spread, sorted newest, highest or most helpful. | 1 credit |
ocado.home.feed.list |
See the products Ocado shows a visitor on its homepage, with prices and offers. | 1 credit |
ocado.categories.list |
Get Ocado's full category tree with IDs, from Fresh & Chilled Food to the M&S range. | 5 credits |
What to know
- Unit prices can be in pence Some unit prices come in pence (currency GBX) and others in pounds (GBP). Check the currency before you compare or sort them.
- Offers have a type Each offer is marked as a price cut, a multibuy or another Ocado offer, such as Everyday Savers or 4 for 3. Count them separately; they mean different things for the price.
- A multibuy keeps its numbers Buy any 2 for £4.50 comes with the quantity and the total as numbers, so you can work out the price per item without reading the text.
- Ratings come with their spread Reviews return the average rating, the number of ratings and reviews, and how many of each star. A product can have more ratings than written reviews.
- Keep the product number Every list returns Ocado's product number, which the product and review endpoints take. Keep it as text so you can re-read the same product later.
Something missing or unclear? Ask the team that builds the Ocado endpoints.