↑ ↓ to move ↵ to open
Iceland API reference

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
POST /execute
Run an endpoint
MCP tool when pinned
iceland__categories__list
Pin tools
OpenAPI
openapi.json
Download

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": {}}'

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:

results[0].data
{  "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

FieldTypeWhat it isExample
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.