Skip to content
Scrappa Get API key
Dunelm API 1 credit / request

Dunelm Search API Documentation

GET https://scrappa.co/api/dunelm/search

Dunelm Search API searches the public dunelm.com catalog. Each result carries a product id, a numeric price in GBP, an original price and discount, a rating, full-size image URLs and stock state. Filter with price bounds and facet keys. Sort with newest, price_asc, price_desc or biggest_discount; ranking_desc is the default. Page with page.

Every requested filter is honoured; an unsupported filter value returns 422. A page is never labelled as another page. The in_stock field stays present but is null in list rows; stock state is returned on the Product route only. Credits: 1 credit per successful request. Failed requests are not billed.

Dunelm Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/dunelm/search
Auth header
x-api-key
Cost
1 credit / request
q = coffee shops
Response preview
200 OK
{
    "data": {
        "q": "curtains",
        "source": "dunelm",
        "products": [
            {
                "id": "1000187431",
                "price": {
                    "amount": 75,
                    "currency": "GBP"
                },
                "title": "Eyelet Curtains",
                "rating": {
                    "count": 2247,
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

5 optional filters available.

q string Required

Search query, for example curtains.

Example value coffee shops
page integer Optional

One-based page number. Default 1.

Example value 1
low-price.priceTaxed number Optional

Lowest price in GBP.

Example value 10
high-price.priceTaxed number Optional

Highest price in GBP.

Example value 10
lining string Optional

Facet key from the filters list, for example lining=blackout.

Example value example
orderBy string Optional

newest, price_asc, price_desc or biggest_discount.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "q": "curtains",
        "source": "dunelm",
        "products": [
            {
                "id": "1000187431",
                "price": {
                    "amount": 75,
                    "currency": "GBP"
                },
                "title": "Eyelet Curtains",
                "rating": {
                    "count": 2247,
                    "average": 4.65
                },
                "image_urls": [
                    "https://images.dunelm.com/1000187431.jpg?$standardplayerzoom$"
                ]
            }
        ],
        "pagination": {
            "page": 1,
            "total": 1097,
            "per_page": 60,
            "total_pages": 19,
            "has_next_page": true
        },
        "active_filters": []
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A parameter is missing or invalid. This response is not billed.

503

Upstream Unavailable

Dunelm could not be reached or did not return product data. Not billed.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.