# Sunweb Scraper - Holiday Packages, Hotels & Prices (`studio-amba/sunweb-scraper`) Actor Scrape holiday packages, hotels, prices, ratings, and travel details from Sunweb.be. Supports destination filtering, duration, travelers, and meal plans. No login required. - **URL**: https://apify.com/studio-amba/sunweb-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Sunweb Scraper Scrape holiday packages, hotels, prices, ratings, and travel details from Sunweb.be. Sunweb is one of Belgium and the Netherlands' largest travel platforms, offering package holidays (flights + hotel), all-inclusive deals, and accommodation-only options across 20+ destinations in Europe, North Africa, and the Middle East. ### How it works Sunweb Scraper loads the Sunweb.be search page in a headless browser and intercepts the internal search API calls that the site makes. This gives you clean, structured JSON data with hotel names, prices, ratings, destination details, and availability information. The scraper handles Sunweb's single-page application (Next.js/React) by waiting for dynamic content to load and capturing both the API responses and the rendered page content. No cookies or login required. ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `destination` | string | `"Spanje"` | Destination country in Dutch (e.g., `"Griekenland"`, `"Turkije"`, `"Egypte"`) | | `departureDate` | string | flexible | Earliest departure date in `YYYY-MM-DD` format | | `duration` | integer | `8` | Trip duration in nights (Sunweb uses 8 and 15 as standard) | | `travelers` | integer | `2` | Number of adult travelers | | `maxResults` | integer | `50` | Maximum number of packages to return | | `proxyConfiguration` | object | Belgian residential | Proxy settings | All fields are optional. If you send an empty input `{}`, the scraper uses sensible defaults (Spain, 8 nights, 2 adults). #### Supported destinations The scraper supports all destinations available on Sunweb.be, including: - **Popular**: Spanje, Griekenland, Turkije, Egypte, Tunesie, Portugal, Italie - **European**: Kroatie, Bulgarije, Malta, Cyprus, Montenegro, Marokko - **Islands**: Kreta, Mallorca, Tenerife, Gran Canaria, Rhodos, Kos - **Exotic**: Kaapverdie Use Dutch names as shown above. The scraper maps them to internal IDs automatically. ### Output | Field | Type | Example | |-------|------|---------| | `hotelName` | string | `"Ostria Resort & Spa"` | | `destination` | string | `"Griekenland > Kreta > Ierapetra"` | | `country` | string | `"Griekenland"` | | `departureDate` | string | `"2026-07-15"` | | `returnDate` | string | `"2026-07-23"` | | `duration` | integer | `8` | | `price` | number | `749` | | `currency` | string | `"EUR"` | | `pricePerPerson` | number | `749` | | `stars` | integer | `5` | | `rating` | number | `8.2` | | `reviewCount` | integer | `245` | | `boardType` | string | `"All inclusive"` | | `transport` | string | `"Flight"` | | `url` | string | Full package URL on Sunweb.be | | `imageUrl` | string | Hotel image URL | | `scrapedAt` | string | ISO 8601 timestamp | #### Board types Sunweb uses Dutch names for meal plans: | Dutch | English | |-------|---------| | All inclusive | All inclusive | | Ultra all inclusive | Ultra all inclusive | | Volpension | Full board | | Halfpension | Half board | | Logies en ontbijt | Bed & breakfast | | Logies | Room only | ### How to scrape Sunweb data This Actor automates the process of extracting structured holiday package data from Sunweb.be, one of the largest travel platforms in Belgium and the Netherlands. You can run it directly from the Apify console, the Apify API, or any of the official SDKs (JavaScript, Python). The scraper handles the dynamic single-page application, pagination, and rate limiting automatically. #### Typical workflows - **Price monitoring**: Track package prices to a destination over time and alert when deals appear - **Competitive analysis**: Compare Sunweb prices against TUI, Neckermann, Thomas Cook, or Corendon - **Market research**: Analyze which destinations, hotels, and board types are trending - **Travel aggregation**: Build a holiday comparison tool that includes Sunweb offers - **Data collection**: Feed structured travel data into dashboards, spreadsheets, or databases #### Step-by-step 1. Open the **Input** tab and set your destination (e.g., `"Spanje"`) 2. Optionally set departure date, duration, and traveler count 3. Click **Start** and wait for the run to complete 4. Download results from the **Output** tab in JSON, CSV, Excel, XML, or HTML 5. Schedule recurring runs from the **Schedule** tab for ongoing monitoring #### Programmatic usage Trigger runs from your backend via the Apify API and retrieve the dataset when finished. Works with Zapier, Make, n8n, BigQuery, and Google Sheets via webhooks. ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('YOUR_USERNAME/sunweb-scraper').call({ destination: 'Griekenland', duration: 8, travelers: 2, maxResults: 20, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ```` ### How to use Sunweb Scraper 1. Navigate to the **Input** tab 2. Enter your destination in Dutch (or leave empty for Spain) 3. Adjust travel dates, duration, and number of travelers 4. Set `maxResults` to control how many packages you want 5. Click **Start** to begin the scrape 6. Results appear in the **Output** tab as structured JSON ### Cost The scraper uses a headless browser to handle Sunweb's dynamic content. A typical run for 50 results takes about 30-60 seconds and costs approximately $0.05-0.10 in platform credits. ### Tips for best results - **Start small**: Run with `maxResults: 10` before launching large jobs - **Use proxies**: Belgian residential proxies give the best results since Sunweb.be is a Belgian site - **Check seasonality**: Travel results vary heavily by season. Summer dates return more options than winter - **Standard durations**: Sunweb primarily offers 8-night and 15-night packages. Other durations may return fewer results - **Combine destinations**: Run multiple scrapes for different destinations to build a comprehensive dataset - **Schedule runs**: Daily or weekly runs are ideal for price tracking ### FAQ and support **Is it legal to scrape Sunweb?** This Actor extracts publicly available travel package data. Always review the website's Terms of Service before scraping at scale. **Why am I getting fewer results than expected?** Some destination and date combinations have limited availability. Try broadening your search (remove specific dates, try a different destination). **Can I filter by board type or hotel rating?** The current version returns all available packages for a destination. Filter the results in post-processing for specific board types or star ratings. **The scraper returns 0 results -- what should I do?** Enable Apify Belgian residential proxies in the input. The site may block non-Belgian IPs. Also verify your destination name is in Dutch. **Prices differ from the website -- why?** Sunweb shows personalized pricing based on availability, departure airports, and dynamic pricing. The scraper sees the default prices for a fresh session. For issues, feature requests, or bug reports, open a ticket in the Issues tab on the Actor page. We monitor every actor and ship fixes quickly when sites change. # Actor input Schema ## `destination` (type: `string`): Destination country or region (e.g., 'Spanje', 'Griekenland', 'Turkije'). Leave empty for all destinations. ## `departureDate` (type: `string`): Earliest departure date in YYYY-MM-DD format. Defaults to flexible dates if empty. ## `duration` (type: `integer`): Trip duration in nights (typically 8 or 15 on Sunweb). ## `travelers` (type: `integer`): Number of adult travelers. ## `maxResults` (type: `integer`): Maximum number of holiday packages to return. ## `proxyConfiguration` (type: `object`): Proxy settings for better reliability. ## Actor input object example ```json { "destination": "Spanje", "duration": 8, "travelers": 2, "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } } ``` # 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 = { "destination": "Spanje", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/sunweb-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 = { "destination": "Spanje", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "BE", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/sunweb-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 '{ "destination": "Spanje", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } }' | apify call studio-amba/sunweb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/sunweb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sunweb Scraper - Holiday Packages, Hotels & Prices", "description": "Scrape holiday packages, hotels, prices, ratings, and travel details from Sunweb.be. Supports destination filtering, duration, travelers, and meal plans. No login required.", "version": "0.1", "x-build-id": "hX6fZgVb4HYMDGe6U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~sunweb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-sunweb-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/studio-amba~sunweb-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-sunweb-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/studio-amba~sunweb-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-sunweb-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", "properties": { "destination": { "title": "Destination", "type": "string", "description": "Destination country or region (e.g., 'Spanje', 'Griekenland', 'Turkije'). Leave empty for all destinations.", "default": "Spanje" }, "departureDate": { "title": "Departure Date", "type": "string", "description": "Earliest departure date in YYYY-MM-DD format. Defaults to flexible dates if empty." }, "duration": { "title": "Duration (nights)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Trip duration in nights (typically 8 or 15 on Sunweb).", "default": 8 }, "travelers": { "title": "Number of Travelers", "minimum": 1, "maximum": 6, "type": "integer", "description": "Number of adult travelers.", "default": 2 }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of holiday packages to return.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for better reliability." } } }, "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 } } } } } } } } } } ```