# Dreamland Scraper — Belgian Toys, Gaming & School Supplies (`studio-amba/dreamland-scraper`) Actor

Scrape products, prices, ratings, and reviews from Dreamland.be. Belgium's leading toys and entertainment retailer. Supports category browsing, search, and full catalog via sitemap.

- **URL**: https://apify.com/studio-amba/dreamland-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 0 monthly users, 89.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Dreamland Scraper

Scrape product data, prices, ratings, and stock info from [Dreamland.be](https://www.dreamland.be) — Belgium's leading toys, games, and entertainment retailer (part of the Colruyt Group). No cookies or login required.

### Why use this actor?

Dreamland is Belgium's go-to store for toys, gaming, school supplies, and kids' entertainment. If you're tracking toy prices, monitoring LEGO availability, comparing brands like Playmobil or Vtech, or building a product feed for a Belgian e-commerce aggregator, this actor gives you structured data straight from the source — no browser automation needed.

### Features

- **Three scraping modes** — search by brand/keyword, browse by category, or scrape the full product catalog via sitemap
- **Bilingual** — supports both Dutch (`nl`) and French (`fr`) versions of the site
- **Rich product data** — names, prices, EANs, SKUs, ratings (normalized to 0-5), stock status, images, and descriptions
- **Fast and efficient** — uses Cheerio (no headless browser), parses JSON-LD structured data embedded in every product page
- **No cookies, no login required** — works out of the box with zero configuration

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Brand or keyword (e.g. `"lego"`, `"playmobil"`) |
| `categoryUrl` | String | No | Category slug or full URL (e.g. `https://www.dreamland.be/nl/c/speelgoed/producten`) |
| `maxResults` | Integer | No | Maximum products to return (default: 100) |
| `language` | String | No | `nl` (default) or `fr` |
| `proxyConfiguration` | Object | No | Proxy settings (recommended for large runs) |

Without input, the scraper fetches the full product sitemap for maximum coverage.

### Output

Each result contains:

| Field | Type | Example |
|-------|------|---------|
| `name` | String | `"LEGO City Politiebureau 60316"` |
| `brand` | String | `"LEGO"` |
| `price` | Number | `69.99` |
| `currency` | String | `"EUR"` |
| `ean` | String | `"5702017161921"` |
| `sku` | String | `"60316"` |
| `productId` | String | `"8843521"` |
| `inStock` | Boolean | `true` |
| `rating` | Number | `4.5` |
| `reviewCount` | Number | `28` |
| `url` | String | Full product URL |
| `imageUrl` | String | Primary product image URL |
| `description` | String | Product description |
| `category` | String | `"Speelgoed"` |
| `language` | String | `"nl"` |

### Example output

```json
{
    "name": "LEGO City Politiebureau 60316",
    "brand": "LEGO",
    "price": 69.99,
    "currency": "EUR",
    "ean": "5702017161921",
    "sku": "60316",
    "productId": "8843521",
    "inStock": true,
    "rating": 4.5,
    "reviewCount": 28,
    "url": "https://www.dreamland.be/nl/producten/lego-city-politiebureau/8843521",
    "imageUrl": "https://www.dreamland.be/media/catalog/product/8843521.jpg",
    "description": "Bouw je eigen LEGO City politiebureau met helikopter, politiewagen en 6 minifiguren.",
    "category": "Speelgoed",
    "language": "nl",
    "scrapedAt": "2026-04-06T10:00:00.000Z"
}
```

### Cost estimate

This actor uses approximately **1 compute unit per 1,000 products**. Sitemap mode is the most efficient since product URLs are fetched directly without pagination overhead. A full catalog scrape of ~5,000 products costs roughly **$0.50**.

### How it works

1. **Sitemap mode** (default): fetches `/sitemap/DREV/products.xml` to discover all product URLs, then visits each page
2. **Search mode**: navigates to Dreamland's brand/merchandise pages at `/nl/m/{slug}`
3. **Category mode**: browses the specified category with automatic pagination

Product data is extracted from JSON-LD `ProductGroup` schema embedded in each page — this gives clean, structured data without fragile HTML parsing.

### Limitations

- Dreamland uses a 0-100 rating scale internally; the scraper normalizes ratings to the standard 0-5 scale
- Search mode uses brand page matching — very niche keywords may return fewer results than the website's client-side search
- Data is scraped from the public website and may change without notice

### How to scrape Dreamland data

1. Go to this actor's page on the [Apify Store](https://apify.com/store).
2. Click **Try for free** to open it in Apify Console.
3. Configure your search query or URL, set the maximum number of results, and adjust proxy settings if needed.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or connect it to your workflow via API.

You can also schedule regular runs, set up webhooks for real-time notifications, or integrate the results directly into your application using the [Apify API](https://docs.apify.com/api).

# Actor input Schema

## `categoryUrl` (type: `string`):

A Dreamland category page URL to scrape. Example: https://www.dreamland.be/nl/c/actiespeelgoed/producten. If empty, scrapes from sitemap.

## `searchQuery` (type: `string`):

Search for products by keyword (e.g., 'lego', 'pokemon'). Uses category page filtering.

## `maxResults` (type: `integer`):

Maximum number of products to return. Each product page is fetched one at a time through Bright Data Web Unlocker with adaptive rate-limiting (1.5-12s between requests to avoid blocks) — requests above ~500 are likely to exceed the run timeout before finishing.

## `language` (type: `string`):

Language for product data. Affects URL prefix (/nl/ or /fr/).

## `proxyConfiguration` (type: `object`):

Legacy — no longer used for fetching (dreamland.be requires Bright Data Web Unlocker, see brightDataApiKey).

## `brightDataApiKey` (type: `string`):

Bright Data API key used to bypass dreamland.be's Cloudflare WAF block via the Web Unlocker. Required — plain requests and Apify RESIDENTIAL proxy requests both get a hard 403.

## Actor input object example

```json
{
  "categoryUrl": "https://www.dreamland.be/nl/c/actiespeelgoed/producten",
  "searchQuery": "lego",
  "maxResults": 100,
  "language": "nl",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "categoryUrl": "https://www.dreamland.be/nl/c/actiespeelgoed/producten",
    "searchQuery": "lego",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "BE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/dreamland-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "categoryUrl": "https://www.dreamland.be/nl/c/actiespeelgoed/producten",
    "searchQuery": "lego",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "BE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/dreamland-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "categoryUrl": "https://www.dreamland.be/nl/c/actiespeelgoed/producten",
  "searchQuery": "lego",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}' |
apify call studio-amba/dreamland-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/dreamland-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/4K0N8gYgCaJRgxqcU/builds/JF1hGkCOh5DQXfrda/openapi.json