# Debenhams Scraper (`crawlerbros/debenhams-scraper`) Actor Scrape debenhams.com, the UK department store retailer. Search by keyword, browse any department, filter by brand/gender/price/discount, or fetch specific product URLs. Returns pricing, sale price, sizes, colours, images, ratings, descriptions. - **URL**: https://apify.com/crawlerbros/debenhams-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Debenhams Scraper Scrape **debenhams.com** — the UK department store retailer selling fashion, home, beauty, and general merchandise from hundreds of brands. Search by keyword, browse any department, filter by brand or gender, or fetch specific product URLs directly. Returns pricing, sale price, sizes, colours, image galleries, ratings, reviews, and descriptions. No login, no cookies, no API key required. ### What this actor does - **Four modes:** `search` (keyword), `byDepartment` (browse a department), `byBrand` (browse a brand), `byUrl` (fetch specific product pages directly) - **13 departments:** Clothing, Home & Garden, Accessories, Footwear, Beauty, Toys & Games, Home Improvement, Sports & Leisure, Pet Care, Tech & Entertainment, Health & Wellness, Gifts, Baby & Child Care - **Gender facet:** Female, Male, Unisex, or any - **Fit classification facet:** Main, Adult, Children's, Plus, Petite, Tall, Wide Fit, Extra Wide Fit, Big & Tall, Shapewear, Maternity, Baby, Toddler - **Sale detection:** current price vs. was-price, with discount percentage - **Filters:** price range, on-sale-only, in-stock-only, minimum rating, colour, size, fit classification, sort order - **Empty fields are omitted** — no `null`, no empty arrays in the output ### Output per product - `title` — product name - `productKey` — Debenhams' internal product ID - `brand` — brand name (own-label or third-party) - `department` — top-level department - `gender` — audience facet (Female / Male / Unisex) - `classification` — Main / Adult / Childrens / Plus / Petite / Tall / Maternity / etc. - `category` — product category (e.g. "Dresses", "Trainers") - `style` — style taxonomy (e.g. "Wrap Dress", "Wedge Trainers") - `breadcrumbs[]` — full category breadcrumb trail - `description` — product description - `price` — current selling price - `wasPrice` — original price, present only when the item is reduced - `onSale` — `true` if `wasPrice` is present and higher than `price` - `discountPercent` — percentage off, present only when on sale - `currency` — always `GBP` - `colour` — the colourway of this listing - `colours[]` — every colour the product is available in - `sizes[]` — every size the product is available in - `images[]` — product image gallery - `occasion[]`, `design[]` — descriptive style facets, where available - `season`, `collection` — where available - `availability` — `"In Stock"` or `"Out of Stock"` - `isNew` — `true` if flagged as a new arrival - `material` — fabrication/material, where available (e.g. "Woven", "Cotton") - `thumbnailUrl` — small swatch/thumbnail image, where available - `nextDayDelivery` — `true` if eligible for next-day delivery, where available - `rating` — average customer rating (0–5), where reviews exist - `reviewCount` — number of customer reviews, where reviews exist - `listingSource` — `"Debenhams"` for own-label listings, `"Marketplace"` for third-party marketplace sellers - `productUrl` — canonical product page URL - `recordType` — always `"product"` - `scrapedAt` — UTC timestamp of the scrape ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byDepartment` / `byBrand` / `byUrl` | | `searchQuery` | string | `dress` | Keyword to search for (mode=search) | | `department` | string | `Clothing` | Department to browse (mode=byDepartment) | | `brand` | string | `Coast` | Exact brand name to browse (mode=byBrand) | | `productUrls` | array | – | Direct `debenhams.com/product/...` URLs to fetch (mode=byUrl) | | `gender` | string | `any` | `any` / `Female` / `Male` / `Unisex` | | `classification` | string | `any` | Fit facet: `any` / `Main` / `Adult` / `Childrens` / `Plus` / `Petite` / `Tall` / `Wide Fit` / `Extra Wide Fit` / `Big & Tall` / `Shape` / `Maternity` / `Baby` / `Toddler` | | `colour` | string | – | Restrict to a colourway, e.g. `black`, `navy`, `red` (applies to search/byDepartment/byBrand) | | `size` | string | – | Restrict to an exact size, e.g. `12`, `M`, `XL` (applies to search/byDepartment/byBrand) | | `sortBy` | string | `relevance` | `relevance` / `priceLowToHigh` / `priceHighToLow` / `ratingHighToLow` / `discountHighToLow` | | `minPrice` | int | – | Drop products cheaper than this (GBP) | | `maxPrice` | int | – | Drop products more expensive than this (GBP) | | `onSaleOnly` | boolean | `false` | Only keep products with a reduced price | | `inStockOnly` | boolean | `false` | Only keep products currently in stock | | `newInOnly` | boolean | `false` | Only keep products flagged as new arrivals | | `minRating` | int | – | Drop products rated below this (0–5) | | `maxItems` | int | `20` | Hard cap on emitted records (1–1000) | | `proxyConfiguration` | object | AUTO | Not required for normal operation; kept as a safety net | #### Example: search for a keyword, sale items only ```json { "mode": "search", "searchQuery": "trainers", "onSaleOnly": true, "maxItems": 30 } ```` #### Example: browse a department filtered by price and gender ```json { "mode": "byDepartment", "department": "Clothing", "gender": "Female", "minPrice": 20, "maxPrice": 80, "sortBy": "priceLowToHigh", "maxItems": 25 } ``` #### Example: browse a specific brand ```json { "mode": "byBrand", "brand": "Coast", "minRating": 4, "maxItems": 20 } ``` #### Example: search a fit classification, colour and size ```json { "mode": "search", "searchQuery": "dress", "classification": "Plus", "colour": "black", "size": "16", "maxItems": 20 } ``` #### Example: fetch full detail for specific product URLs ```json { "mode": "byUrl", "productUrls": [ "https://www.debenhams.com/product/double-second-chiffon-wrap-dress-with-cape-sleeves_p-c9128692-6a00-4c1e-bad9-815f25c49ea1" ] } ``` ### Use cases - **Price monitoring** — track current vs. was-price and sale status across a department - **Brand distribution research** — see how a brand's range is priced and sized on a major UK department store - **Fashion trend research** — pull ratings, review counts, and pricing across categories - **Catalog enrichment** — feed product titles, images, and descriptions into a product feed - **Marketplace vs. own-label analysis** — `listingSource` distinguishes Debenhams own-label from third-party marketplace sellers ### FAQ **Is this affiliated with Debenhams?** No. This is an independent, third-party actor that reads publicly accessible product data from debenhams.com. It is not affiliated with, endorsed by, or connected to Debenhams. **Do I need to log in or provide cookies?** No. All product search and browse data returned by this actor is publicly accessible without an account. **Why do some products have no `wasPrice`/`onSale` fields?** Those fields are only added when a genuine reduced price is detected. Full-price products simply omit them rather than showing `false`/`null`. **Why are `rating` and `reviewCount` sometimes missing?** Not every product has customer reviews yet. Those fields are only populated when Debenhams has published a rating for that product. **Does `brand` include third-party sellers, not just Debenhams' own label?** Yes — Debenhams' catalog spans hundreds of brands sold directly and via its marketplace. `listingSource` tells you whether a given result is a Debenhams-fulfilled listing or a third-party marketplace listing. **How are sizes represented?** Exactly as Debenhams lists them for that product — numeric UK clothing/shoe sizes, age-based kids sizes, or letter sizes (S/M/L), since sizing schemes differ across departments. **How fresh is the data?** Every run queries live data at request time — pricing, stock, and ratings reflect what debenhams.com shows at the moment of the run. **Is there a rate limit?** The actor paces requests and automatically retries through Apify's free datacenter proxy group if a request is temporarily throttled. # Actor input Schema ## `mode` (type: `string`): What to scrape. ## `searchQuery` (type: `string`): Keyword to search for, e.g. "dress", "trainers", "sofa". ## `department` (type: `string`): Top-level department to browse. ## `brand` (type: `string`): Exact brand name as shown on Debenhams, e.g. "Coast", "Oasis", "Warehouse", "Skechers", "Jack Wills", "Debenhams". ## `productUrls` (type: `array`): Direct debenhams.com product URLs to fetch, e.g. https://www.debenhams.com/product/\_p- ## `gender` (type: `string`): Restrict results to a gender/audience facet. ## `classification` (type: `string`): Restrict results to a fit/classification facet (applies to search, byDepartment, byBrand). ## `colour` (type: `string`): Restrict results to a colourway, e.g. "black", "navy", "red". Matched against Debenhams' colour facet (applies to search, byDepartment, byBrand). ## `size` (type: `string`): Restrict results to an exact size as listed on Debenhams, e.g. "12", "M", "XL", "8" (applies to search, byDepartment, byBrand). ## `sortBy` (type: `string`): Order applied to the collected results before output. ## `minPrice` (type: `integer`): Drop products cheaper than this. ## `maxPrice` (type: `integer`): Drop products more expensive than this. ## `onSaleOnly` (type: `boolean`): Only keep products with a reduced/sale price. ## `inStockOnly` (type: `boolean`): Only keep products currently in stock. ## `newInOnly` (type: `boolean`): Only keep products flagged as new arrivals on Debenhams. ## `minRating` (type: `integer`): Drop products rated below this (0-5). Only applies to products that have a rating. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `proxyConfiguration` (type: `object`): Not required for normal operation (the actor calls Debenhams' public search API directly). Leave the default AUTO group enabled as a safety net. ## Actor input object example ```json { "mode": "search", "searchQuery": "dress", "department": "Clothing", "brand": "Coast", "productUrls": [], "gender": "any", "classification": "any", "colour": "", "size": "", "sortBy": "relevance", "onSaleOnly": false, "inStockOnly": false, "newInOnly": false, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped Debenhams products. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "searchQuery": "dress", "department": "Clothing", "brand": "Coast", "productUrls": [], "gender": "any", "classification": "any", "colour": "", "size": "", "sortBy": "relevance", "onSaleOnly": false, "inStockOnly": false, "newInOnly": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/debenhams-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "dress", "department": "Clothing", "brand": "Coast", "productUrls": [], "gender": "any", "classification": "any", "colour": "", "size": "", "sortBy": "relevance", "onSaleOnly": False, "inStockOnly": False, "newInOnly": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/debenhams-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "searchQuery": "dress", "department": "Clothing", "brand": "Coast", "productUrls": [], "gender": "any", "classification": "any", "colour": "", "size": "", "sortBy": "relevance", "onSaleOnly": false, "inStockOnly": false, "newInOnly": false, "maxItems": 20 }' | apify call crawlerbros/debenhams-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/debenhams-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Debenhams Scraper", "description": "Scrape debenhams.com, the UK department store retailer. Search by keyword, browse any department, filter by brand/gender/price/discount, or fetch specific product URLs. Returns pricing, sale price, sizes, colours, images, ratings, descriptions.", "version": "1.0", "x-build-id": "KLmiPOQrWdgvY8zkn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~debenhams-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-debenhams-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~debenhams-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-debenhams-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~debenhams-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-debenhams-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byDepartment", "byBrand", "byUrl" ], "type": "string", "description": "What to scrape.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Keyword to search for, e.g. \"dress\", \"trainers\", \"sofa\".", "default": "dress" }, "department": { "title": "Department (mode=byDepartment)", "enum": [ "Clothing", "Home & Garden", "Accessories", "Footwear", "Beauty", "Toys & Games", "Home Improvement", "Sports & Leisure", "Pet Care", "Tech & Entertainment", "Health & Wellness", "Gifts", "Baby & Child Care" ], "type": "string", "description": "Top-level department to browse.", "default": "Clothing" }, "brand": { "title": "Brand (mode=byBrand)", "type": "string", "description": "Exact brand name as shown on Debenhams, e.g. \"Coast\", \"Oasis\", \"Warehouse\", \"Skechers\", \"Jack Wills\", \"Debenhams\".", "default": "Coast" }, "productUrls": { "title": "Product URLs (mode=byUrl)", "type": "array", "description": "Direct debenhams.com product URLs to fetch, e.g. https://www.debenhams.com/product/_p-", "default": [], "items": { "type": "string" } }, "gender": { "title": "Gender", "enum": [ "any", "Female", "Male", "Unisex" ], "type": "string", "description": "Restrict results to a gender/audience facet.", "default": "any" }, "classification": { "title": "Fit classification", "enum": [ "any", "Main", "Adult", "Childrens", "Plus", "Petite", "Tall", "Wide Fit", "Extra Wide Fit", "Big & Tall", "Shape", "Maternity", "Baby", "Toddler" ], "type": "string", "description": "Restrict results to a fit/classification facet (applies to search, byDepartment, byBrand).", "default": "any" }, "colour": { "title": "Colour", "type": "string", "description": "Restrict results to a colourway, e.g. \"black\", \"navy\", \"red\". Matched against Debenhams' colour facet (applies to search, byDepartment, byBrand).", "default": "" }, "size": { "title": "Size", "type": "string", "description": "Restrict results to an exact size as listed on Debenhams, e.g. \"12\", \"M\", \"XL\", \"8\" (applies to search, byDepartment, byBrand).", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceLowToHigh", "priceHighToLow", "ratingHighToLow", "discountHighToLow" ], "type": "string", "description": "Order applied to the collected results before output.", "default": "relevance" }, "minPrice": { "title": "Minimum price (GBP)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products cheaper than this." }, "maxPrice": { "title": "Maximum price (GBP)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products more expensive than this." }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only keep products with a reduced/sale price.", "default": false }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only keep products currently in stock.", "default": false }, "newInOnly": { "title": "New arrivals only", "type": "boolean", "description": "Only keep products flagged as new arrivals on Debenhams.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Drop products rated below this (0-5). Only applies to products that have a rating." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not required for normal operation (the actor calls Debenhams' public search API directly). Leave the default AUTO group enabled as a safety net.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```