# Holidaycheck.de Reviews Scraper (`shahidirfan/holidaycheck-de-reviews-scraper`) Actor Supercharge your hospitality research! Extract hotel ratings, detailed customer feedback, and vital sentiment data from Holidaycheck.de. Built for seamless market analysis, this robust tool delivers precise review data to help you monitor trends. - **URL**: https://apify.com/shahidirfan/holidaycheck-de-reviews-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Travel, Developer tools, Automation - **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 ## HolidayCheck Reviews Scraper Extract HolidayCheck hotel reviews in a flat structured dataset that is ready for research, monitoring, analysis, and enrichment. Collect review headlines, review text, traveler context, travel dates, recommendation status, owner replies, topic summaries, and simplified contribution values from HolidayCheck hotel review pages at scale. ### Features - **Review-first extraction** — Collect individual HolidayCheck hotel reviews instead of hotel listing records - **Direct hotel-review inputs only** — Accept only direct HolidayCheck hotel review-style URLs that resolve to a single hotel - **Filter-aware collection** — Respect review-page filters already present in the input URL, including sort and topic slices - **Flat review records** — Flatten reviewer, owner reply, topic, and contribution data into analysis-friendly fields - **Clean datasets** — Remove null and empty values automatically so exports stay compact and production-friendly ### Use Cases #### Reputation Monitoring Track what guests are saying about a hotel over time. Monitor recommendation status, owner responses, and recurring themes across new reviews. #### Travel Research Compare real guest experiences before planning content, making recommendations, or building destination research databases. Use reviewer type and travel dates to segment feedback. #### Competitive Analysis Collect review datasets from multiple hotels and compare guest sentiment, repeated complaints, and service strengths across competing properties. #### Data Enrichment Send structured HolidayCheck review data into BI tools, spreadsheets, CRMs, warehouses, or custom quality-monitoring workflows. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `urls` | Array | Yes | — | One or more direct HolidayCheck hotel review-style URLs. Supported paths are `/hr/`, `/hi/`, `/ho/`, `/hm/`, `/ha/`, and `/wcf/hotelreview/contribution/` when they include a hotel ID. | | `results_wanted` | Integer | No | `20` | Maximum number of review items to collect across all provided URLs. | | `max_pages` | Integer | No | `2` | Safety cap for pagination. Each review API page contains up to 10 reviews. | | `review_sort` | String | No | `relevance` | Review sort mode. Supported values are `relevance`, `entrydate`, `positive`, and `negative`. When set, it overrides any sort already present in the URL. | | `proxyConfiguration` | Object | No | `{"useApifyProxy": false}` | Optional proxy configuration for more reliable production runs. | --- ### Output Data Each dataset item can contain the following fields: | Field | Type | Description | |-------|------|-------------| | `review_id` | String | HolidayCheck review ID | | `hotel_id` | String | HolidayCheck hotel ID | | `hotel_name` | String | Hotel name returned with the review | | `review_title` | String | Review headline | | `review_position` | Integer | Position of the review in the collected dataset | | `review_page` | Integer | Review page number on HolidayCheck | | `sort` | String | Sort mode derived from the review URL | | `traveled_with` | String | Travel companion category such as couple or family | | `recommendation` | Boolean | Whether the reviewer recommends the hotel | | `proofed_reservation` | Boolean | Whether the review is tied to a verified reservation | | `ranking` | Number | HolidayCheck ranking score for the review | | `entry_date` | String | Review publication date in ISO format | | `travel_date` | String | Travel month represented as an ISO date | | `original_locale` | String | Original review locale | | `returned_locale` | String | Locale returned in the response | | `review_text` | String | Main free-text hotel review body when available | | `overall_rating` | Number | Overall structured rating when available | | `owner_comment_text` | String | Hotel owner reply text | | `owner_comment_entry_date` | String | Hotel owner reply date | | `user_first_name` | String | Reviewer first name | | `user_age_group` | String | Reviewer age group | | `user_hotel_review_count` | Integer | Number of hotel reviews shown for the reviewer | | `topic_ids` | Array | Flattened topic identifiers | | `topic_names` | Array | Flattened topic names | | `topic_quotes` | Array | Flattened topic quotes | | `service_opinion`, `room_opinion`, `restaurant_opinion`, etc. | Mixed | Flattened contribution fields, one value per field | --- ### Usage Examples #### Direct Review Page Use a HolidayCheck review page directly: ```json { "urls": [ { "url": "https://www.holidaycheck.de/hr/bewertungen-pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450" } ], "results_wanted": 20, "max_pages": 2, "review_sort": "relevance" } ```` #### Hotel Page Input Start from a direct hotel page that contains the hotel ID: ```json { "urls": [ { "url": "https://www.holidaycheck.de/hi/pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450" } ], "results_wanted": 15, "max_pages": 2, "review_sort": "entrydate" } ``` #### Review URL With Sort Use an already filtered review URL and still force the API sort through input: ```json { "urls": [ { "url": "https://www.holidaycheck.de/hr/bewertungen-pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450?sort=negative" } ], "results_wanted": 20, "max_pages": 2, "review_sort": "positive" } ``` ### Sample Output ```json { "review_id": "ee20b26c-d6b7-4272-aad5-ff3d3ac61940", "hotel_id": "1aa4c4ad-f9ea-3367-a163-8a3a6884d450", "hotel_name": "Pickalbatros Dana Beach Resort - Hurghada", "review_title": "Service nach wie vor Top, Auswahl und Qualität bei Speisen und Getränken deutlich verschlechtert.", "review_position": 1, "review_page": 1, "sort": "relevance", "traveled_with": "COUPLE", "recommendation": false, "proofed_reservation": true, "ranking": 0.7916, "entry_date": "2026-02-19T08:45:16.000Z", "travel_date": "2026-02-01", "user_first_name": "Dirk", "user_age_group": "FROM_51_TO_55", "user_hotel_review_count": 115, "owner_comment_text": "Liebe Sonja, Es freut uns sehr, dass Sie sich die Zeit genommen haben, Ihre Eindrücke mit uns zu teilen.", "review_text": "Das Dana Beach lebt von seinem Personal.", "overall_rating": 0.8, "topic_ids": ["SERVICE", "SUSTAINABILITY", "ENTERTAINMENT"], "topic_names": ["Service", "Nachhaltigkeit", "Unterhaltung"], "service_opinion": "Das Dana Beach lebt von seinem Personal.", "room_opinion": "Wir hatten ein Upgrade auf ein Superiorzimmer erhalten." } ``` *** ### Tips for Best Results #### Prefer Direct Review URLs - Use `/hr/` review URLs when possible - These URLs can already contain the exact sort and filter combination you want #### Start Small for Validation - Use `results_wanted: 20` for quick checks - Increase `max_pages` only when you need deeper review coverage #### Use Multiple URLs Intentionally - Combine several direct hotel or review URLs in one run when you want one shared dataset - The actor stops once it reaches the total `results_wanted` limit #### Use Proxies for Larger Jobs - Add proxy configuration for heavier schedules or wider hotel coverage - This is useful when processing many direct hotel review URLs *** ### Integrations Connect your data with: - **Google Sheets** — Export review datasets for quick analysis - **Airtable** — Build searchable guest-feedback databases - **Make** — Trigger downstream monitoring workflows - **Zapier** — Send review data into business tools - **Webhooks** — Push data into custom systems or pipelines #### Export Formats - **JSON** — For APIs and engineering workflows - **CSV** — For spreadsheets and reporting - **Excel** — For business users and analysts - **XML** — For structured integrations *** ### Frequently Asked Questions #### Which HolidayCheck URLs are supported? Direct review pages work best. Hotel pages, offer pages, listing pages, and destination pages are also supported. #### Can I use filters that already exist in the review URL? Yes. If your review URL already contains a sort or topic filter, the actor keeps that behavior. #### Does the actor collect empty fields? No. Empty, null, and undefined values are removed automatically before the dataset is saved. #### Can I collect reviews from multiple hotels in one run? Yes. Add multiple HolidayCheck URLs to `urls`, and the actor will process them in order until it reaches the requested result limit. #### Why do some reviews contain more fields than others? HolidayCheck does not return the same contribution blocks or owner replies for every review. The actor keeps whatever structured data is available for each item. #### What happens when I use a destination or listing URL? The actor first resolves hotels from that HolidayCheck URL and then collects reviews for those hotels. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Schedules](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with HolidayCheck terms and all applicable laws. Use collected data responsibly and at appropriate request volumes. # Actor input Schema ## `urls` (type: `array`): One or more direct HolidayCheck hotel review-style URLs. Supported path types are /hr/, /hi/, /ho/, /hm/, /ha/, and /wcf/hotelreview/contribution/ when they contain a hotel ID. ## `results_wanted` (type: `integer`): Maximum number of review items to return across all URLs. ## `max_pages` (type: `integer`): Safety cap for pagination. Each HolidayCheck review API page contains up to 10 reviews. ## `review_sort` (type: `string`): Optional review sort mode. When set, this overrides any sort already present in the URL. ## `proxyConfiguration` (type: `object`): Optional proxy configuration for higher reliability. ## Actor input object example ```json { "urls": [ { "url": "https://www.holidaycheck.de/hr/bewertungen-pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450" } ], "results_wanted": 20, "max_pages": 2, "review_sort": "relevance", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ { "url": "https://www.holidaycheck.de/hr/bewertungen-pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450" } ], "results_wanted": 20, "max_pages": 2, "review_sort": "relevance" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/holidaycheck-de-reviews-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 = { "urls": [{ "url": "https://www.holidaycheck.de/hr/bewertungen-pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450" }], "results_wanted": 20, "max_pages": 2, "review_sort": "relevance", } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/holidaycheck-de-reviews-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 '{ "urls": [ { "url": "https://www.holidaycheck.de/hr/bewertungen-pickalbatros-dana-beach-resort-hurghada/1aa4c4ad-f9ea-3367-a163-8a3a6884d450" } ], "results_wanted": 20, "max_pages": 2, "review_sort": "relevance" }' | apify call shahidirfan/holidaycheck-de-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/holidaycheck-de-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Holidaycheck.de Reviews Scraper", "description": "Supercharge your hospitality research! Extract hotel ratings, detailed customer feedback, and vital sentiment data from Holidaycheck.de. Built for seamless market analysis, this robust tool delivers precise review data to help you monitor trends.", "version": "0.0", "x-build-id": "y0jVSdCgFzo7gseNX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~holidaycheck-de-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-holidaycheck-de-reviews-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/shahidirfan~holidaycheck-de-reviews-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-holidaycheck-de-reviews-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/shahidirfan~holidaycheck-de-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-holidaycheck-de-reviews-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": [ "urls" ], "properties": { "urls": { "title": "HolidayCheck URLs", "type": "array", "description": "One or more direct HolidayCheck hotel review-style URLs. Supported path types are /hr/, /hi/, /ho/, /hm/, /ha/, and /wcf/hotelreview/contribution/ when they contain a hotel ID.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "results_wanted": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum number of review items to return across all URLs.", "default": 20 }, "max_pages": { "title": "Maximum pages per URL", "minimum": 1, "type": "integer", "description": "Safety cap for pagination. Each HolidayCheck review API page contains up to 10 reviews.", "default": 2 }, "review_sort": { "title": "Review sort", "enum": [ "relevance", "entrydate", "positive", "negative" ], "type": "string", "description": "Optional review sort mode. When set, this overrides any sort already present in the URL.", "default": "relevance" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy configuration for higher reliability.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```