Iceland API reference
Track Iceland's prices, its multibuy deals such as 2 for £3.00, and what shoppers say in reviews, from a search term or product number.
Iceland does not offer a public API for its product data. Upscrape's Iceland grocery API returns what iceland.co.uk shows: each product's price, pack size, price per kilo or litre, availability and offers, as JSON.
Many Iceland offers are multibuys, such as 2 for £3.00. Each one comes with the quantity and the total as numbers, so you can work out the price per item without reading the offer text.
You can also read a product's reviews, newest first, look up a store from Iceland's store list and check whether Iceland delivers to a postcode.
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 |
|---|---|---|
iceland.products.search |
Search Iceland by keyword, such as semi skimmed milk. | 1 credit |
iceland.promotions.list |
Page through Iceland's offers, 30 products at a time, each with its single price and offer terms, such as 2 for £3.00. | 1 credit |
iceland.product.detail.get |
Read one product by its Iceland product number or page link, with every offer currently on it. | 1 credit |
iceland.category.products.list |
List the products in an Iceland category, such as Milk, Butter & Eggs, 30 to a page. | 1 credit |
iceland.reviews.list |
Read a product's reviews, newest first: the stars, the text and whether the purchase was verified. | 1 credit |
iceland.store.get |
Look up an Iceland store by its number and check whether Iceland delivers to a postcode. | 1 credit |
iceland.categories.list |
Get Iceland's categories and collections, such as £1 or less, with the IDs the category endpoint takes. | 5 credits |
What to know
- A multibuy is a quantity and a total Each multibuy comes with buy_quantity and for_price, so 2 for £3.00 reads as 2 and 3. Divide them for the price per item; the single price stays in price.
- One product can have several offers Iceland can put a product in more than one multibuy at the same time. Keep every offer in your records, not only the first.
- Compare by unit price Iceland shows a price per kilo or litre on most products. Use it to compare packs of different sizes, and leave it unknown when it is missing.
- Keep product numbers as text Iceland product numbers are short, such as 19492, and also end each product page link. Store them as text so they match across systems.
- Lists come 30 to a page Search, category and offer lists return up to 30 products a page, the total and whether another page follows. Send page to read on.
Something missing or unclear? Ask the team that builds the Iceland endpoints.