# Dunelm Category API Documentation

<p><strong>Dunelm Category API</strong> lists the public products of a category page. Take a category path from the Sitemap route. Filter with price bounds and facet keys, sort with the four proven values and page through the results. Each product carries a numeric GBP price, rating, full-size image URLs and a <code>in_stock</code> field that is null in list rows; stock state is returned on the Product route only. Filtered results and the page label always match the request. A sitemap path whose category page no longer exists returns 422 and is not billed.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/dunelm-api/dunelm_category](https://scrappa.co/docs/dunelm-api/dunelm_category)
- **API group:** Dunelm API
- **Endpoint:** `GET https://scrappa.co/api/dunelm/category`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | string | Yes | Category path from the sitemap, for example /category/home-and-furniture/bathroom/all-bathroom. |
| `page` | integer | No | One-based page number. |
| `low-price.priceTaxed` | number | No | Lowest price in GBP. |
| `high-price.priceTaxed` | number | No | Highest price in GBP. |
| `orderBy` | string | No | newest, price_asc, price_desc or biggest_discount. |

## Example response

```json
{
    "data": {
        "path": "/category/home-and-furniture/bathroom/all-bathroom",
        "source": "dunelm",
        "products": [],
        "pagination": {
            "page": 1,
            "total": 1413,
            "per_page": 60,
            "total_pages": 24,
            "has_next_page": true
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "category"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The category has no products on the requested page. Not billed. |
| 422 | Validation Error | Send a valid category path. This response is not billed. |
| 503 | Upstream Unavailable | Dunelm could not be reached. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
