Iceland Categories
iceland.categories.list
Get Iceland's categories and collections, such as £1 or less, with the IDs the category endpoint takes.
At a glance
- Endpoint ID
iceland.categories.list- Price
- 2 credits per call; failed calls are free
- Runs for up to
- 30 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
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": "iceland.categories.list", "input": {}}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "iceland.categories.list", "input": {}}''')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": "iceland.categories.list", "input": {}}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
This endpoint takes an empty input object.
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
{ "items": [ { "name": "£1 or less", "id": "1POUVAL", "parent_id": null, "url": "https://www.iceland.co.uk/1-or-less" }, { "name": "£1 Treats & Snacks", "id": "1POUVALTRE", "parent_id": null, "url": "https://www.iceland.co.uk/1-or-less/1-treats-and-snacks" } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
items[].name |
string | The name as Iceland shows it. | £1 or less |
items[].id |
string | Iceland's ID for the store, category or review. | 1POUVAL |
items[].parent_id |
null | The ID of the category above; empty for a top-level category. | null |
items[].url |
string | The page on iceland.co.uk. | https://www.iceland.co.uk/1-or-less |
items |
array | The products, reviews or stores on this page. | 437 records |
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other Iceland endpoints
Something missing or unclear? Ask the team that builds the Iceland endpoints.