# TUI Reviews Scraper (`knagymate/tui-reviews-scraper`) Actor Scrape TUI hotel reviews, ratings, guest comments, traveler details, review dates, recommendation rates, and hotel summaries from TUI.com pages. - **URL**: https://apify.com/knagymate/tui-reviews-scraper.md - **Developed by:** [knagymate](https://apify.com/knagymate) (community) - **Categories:** - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 reviews This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## TUI Reviews Scraper Scrape **TUI hotel reviews** at scale with a fast, reliable, and production-ready Apify Actor. Extract structured **TUI customer review data** including: - ⭐ Guest ratings with detailed category scores - 📝 Review titles & full guest comments - 👤 Reviewer names, traveler types & age groups - 🏨 Hotel summary with aggregated ratings - 🔢 Total review count per hotel - 🌐 Review language, travel season & recommendation status - ✅ TUI recommendation rate and last review date Perfect for: - Travel & hospitality businesses - Hotel content and landing page teams - AI/LLM training datasets - Reputation management platforms - Market research & competitive analysis - Customer experience analysis Optimized for large-scale review extraction from **TUI.com**, one of Europe's leading travel, hotel, and package holiday platforms. *** ## ✨ Features - ✅ Scrape **TUI.com hotel reviews** from TUI hotel detail and offer pages - ✅ Extract guest ratings with category-level scores - ✅ Capture review dates, traveler type, age group, travel season & language - ✅ Extract full guest comments, review titles & reviewer names - ✅ Detailed category ratings (cleanliness, food & drinks, staff service, child friendliness, accommodation condition, activity & entertainment) - ✅ Aggregated hotel rating summary - ✅ Review count statistics per hotel - ✅ TUI recommendation rate per hotel - ✅ Last review date for freshness checks - ✅ Multiple TUI hotel URLs in a single run - ✅ Optional cutoff date filtering - ✅ Configurable maximum reviews per hotel - ✅ Cursor-based pagination through review history - ✅ Apify API ready - ✅ Webhook & workflow integrations (Make, Zapier, Google Sheets, BigQuery) *** ## 🔍 Supported TUI Hotel Pages The scraper works with standard **TUI.com hotel detail / offer pages**. Simply provide the hotel URL, and the Actor extracts all available reviews. Example URLs: ```text https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/?startDate=2026-09-08&endDate=2026-12-07&duration=default&travellers=2&searchScope=PACKAGE&showTotalPrice=0&earlyBird=0&sortOffersAsc=1&sortOffersField=campaignOffers https://www.tui.com/hotel/suchen/angebote/Hotel-Grupotel-Taurus-Park/3496/offer/?searchScope=HOTEL&startDate=2026-09-06&endDate=2026-12-05&duration=7-&travellers=2&destinations=133|REGION&productId=PMI43003&boardCode=G&supplierRoomId=DZX1&productAccommodationUnitId=DZX1G&finalPosition=1&rateType=STANDARD&selectedDuration=7&selectedStartDate=2026-11-15 https://www.tui.com/pauschalreisen/suchen/angebote/TUI-KIDS-CLUB-JAZ-Bluemarine/229480/offer/?startDate=2026-09-06&endDate=2027-04-30&duration=7-&travellers=2&searchScope=PACKAGE&showTotalPrice=0®ionGiataIds=651&contentid=1_ad1_3_aegypten_20260817 ``` The Actor automatically detects the TUI hotel ID from the page, resolves the final URL, then collects review data from TUI customer-review endpoints. *** ## ⚙️ Input Configuration | Field | Type | Description | |---|---|---| | `startUrls` | array | One or more TUI.com hotel URLs | | `maxReviewsPerHotel` | integer | Maximum reviews to scrape per hotel (default: `100`) | | `cutoffDate` | date | Return only reviews from this date onwards (format: `YYYY-MM-DD`) | | `alwaysReturnSummary` | boolean | Include hotel summary even if no reviews found (default: `true`) | *** ## 📥 Example Input ```json { "startUrls": [ { "url": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/?startDate=2026-09-08&endDate=2026-12-07&duration=default&travellers=2&searchScope=PACKAGE&showTotalPrice=0&earlyBird=0&sortOffersAsc=1&sortOffersField=campaignOffers" }, { "url": "https://www.tui.com/hotel/suchen/angebote/Hotel-Grupotel-Taurus-Park/3496/offer/?searchScope=HOTEL&startDate=2026-09-06&endDate=2026-12-05&duration=7-&travellers=2&destinations=133|REGION&productId=PMI43003&boardCode=G&supplierRoomId=DZX1&productAccommodationUnitId=DZX1G&finalPosition=1&rateType=STANDARD&selectedDuration=7&selectedStartDate=2026-11-15" }, { "url": "https://www.tui.com/pauschalreisen/suchen/angebote/TUI-KIDS-CLUB-JAZ-Bluemarine/229480/offer/?startDate=2026-09-06&endDate=2027-04-30&duration=7-&travellers=2&searchScope=PACKAGE&showTotalPrice=0®ionGiataIds=651&contentid=1_ad1_3_aegypten_20260817" } ], "maxReviewsPerHotel": 1000 } ``` *** ## 📦 Output Dataset For every review, the Actor returns a clean, structured record that combines the **individual TUI hotel review**, its **category ratings**, traveler metadata, recommendation status, and an **aggregated hotel summary** — making downstream processing simple and scalable. *** ## 🧾 Output Fields | Field | Description | |---|---| | `recordType` | Type of record: `review` or `summary` | | `reviewId` | TUI internal review ID | | `reviewDate` | Date associated with the guest review | | `reviewerName` | Guest's display name | | `reviewerType` | Traveler type / travel party, such as family or couple | | `reviewerAgeGroup` | Reviewer's age group | | `travelSeason` | Season of travel, such as summer or winter | | `language` | Review language code | | `reviewTitle` | Review headline written by the guest | | `reviewText` | Full review text written by the guest | | `hotelRecommendation` | Whether the guest recommends the hotel | | `ratings.average` | Overall review rating | | `ratings.cleanliness` | Cleanliness rating | | `ratings.foodAndDrinks` | Food & drinks rating | | `ratings.staffService` | Staff service rating | | `ratings.childFriendliness` | Child friendliness rating | | `ratings.accommodationCondition` | Accommodation condition rating | | `ratings.activityAndEntertainment` | Activity & entertainment rating | | `hotelSummary.hotelId` | TUI internal hotel ID | | `hotelSummary.startUrl` | Original input URL | | `hotelSummary.actualUrl` | Final resolved hotel URL | | `hotelSummary.numberOfReviews` | Total reviews available for the hotel | | `hotelSummary.recommendationRate` | Percentage of guests recommending the hotel | | `hotelSummary.lastReviewDate` | Latest available review date | | `hotelSummary.ratings.average` | Average overall hotel rating | | `hotelSummary.ratings.cleanliness` | Average cleanliness rating | | `hotelSummary.ratings.foodAndDrinks` | Average food & drinks rating | | `hotelSummary.ratings.staffService` | Average staff service rating | | `hotelSummary.ratings.childFriendliness` | Average child friendliness rating | | `hotelSummary.ratings.accommodationCondition` | Average accommodation condition rating | | `hotelSummary.ratings.activityAndEntertainment` | Average activity & entertainment rating | *** ## 🏨 Example Review Output ```json { "recordType": "review", "reviewId": "SV_24B0VBBEFVO7U6AR_8CVSN1JJZVQYU9Z", "reviewDate": "2026-08-29 00:00:00+00:00", "reviewerName": "Chris", "reviewerType": "FAMILY", "reviewerAgeGroup": "THIRTIES", "travelSeason": "SUMMER", "language": "de", "reviewTitle": "Sommerurlaub", "reviewText": "Hatten eine schöne Woche, würden aber nicht nochmal dort buchen.", "hotelRecommendation": true, "ratings": { "average": 4, "cleanliness": 3, "foodAndDrinks": 4, "staffService": 4, "childFriendliness": 4, "accommodationCondition": 3, "activityAndEntertainment": 4 }, "hotelSummary": { "hotelId": "92399", "startUrl": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/", "actualUrl": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/", "numberOfReviews": 187, "recommendationRate": 81, "lastReviewDate": "2026-08-30 00:00:00+00:00", "ratings": { "average": 4, "cleanliness": 3.7, "foodAndDrinks": 4.1, "staffService": 4.2, "childFriendliness": 4.5, "accommodationCondition": 4, "activityAndEntertainment": 4.4 } } } ``` Example summary record: ```json { "recordType": "summary", "hotelSummary": { "hotelId": "92399", "startUrl": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/", "actualUrl": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/", "numberOfReviews": 187, "recommendationRate": 81, "lastReviewDate": "2026-08-30 00:00:00+00:00", "ratings": { "average": 4, "cleanliness": 3.7, "foodAndDrinks": 4.1, "staffService": 4.2, "childFriendliness": 4.5, "accommodationCondition": 4, "activityAndEntertainment": 4.4 } } } ``` > ℹ️ TUI uses a **1–5 rating scale** for review and hotel rating categories. `recommendationRate` is returned as a **0–100 percentage**. *** ## 🌍 Ideal Use Cases Perfect for: - **Hotel reputation monitoring** — Track guest satisfaction trends across TUI hotels and resorts - **Travel content teams** — Build review-based destination pages, hotel comparisons & FAQ content - **AI/LLM training** — Create travel and hospitality datasets for chatbots, recommendation engines & summarization - **Sentiment analysis** — Analyze TUI guest feedback by language, traveler type, age group and travel season - **Market intelligence** — Benchmark hotels, resorts and package holiday properties against competitors - **Revenue management** — Correlate guest ratings, recommendation rates and review freshness with pricing decisions - **OTA integration** — Aggregate TUI hotel reviews for metasearch, booking platforms and travel dashboards - **Reputation management platforms** — Monitor guest concerns, positive mentions and recommendation patterns - **Hospitality analytics** — Build dashboards for hotel groups, tour operators and travel agencies - **Customer experience research** — Deep-dive analysis of cleanliness, food, service, family friendliness and entertainment feedback *** ## 🚀 Integrations **Platforms:** - Apify API & Console - Python (`apify-client`) - Node.js - JavaScript (Puppeteer) - Go - Java **Workflows:** - Make.com (Zapier alternative) - Zapier - Google Sheets - Airtable - Slack - Discord webhooks - Custom webhooks **Data Warehouses:** - Google BigQuery - Snowflake - Amazon Redshift - AWS S3 - Azure Data Lake - Airbyte **AI/ML:** - LangChain - OpenAI/GPT - Hugging Face - Custom transformers **Export Formats:** - JSON (default) - CSV - Excel - XML - Parquet *** ## ⚡ Reliability & Performance **Technical Stack:** - Python 3.12+ (async-first) - Smart pagination & request handling - Automatic retry logic with backoff - Session management & cookies - Proxy support (rotating, static, residential) - Concurrent requests with rate limiting - Error handling & recovery **Optimized for:** - Stable production workloads - Large-scale TUI review extraction - Multi-hotel review aggregation - High-throughput data collection - Memory-efficient dataset output - Scheduled runs & webhooks *** ## 📊 Data Quality **Included Features:** - ✅ TUI hotel ID detection from hotel pages - ✅ Final URL resolution for traceable datasets - ✅ Date validation & normalization - ✅ Recommendation status capture - ✅ Traveler profile metadata - ✅ Rating scale validation - ✅ Category score normalization - ✅ Structured summary records *** ## 👨‍💻 About the Author Created by **[knagymate](https://apify.com/knagymate)** — specialized in high-performance Apify Actors for: - Hotel & travel review scraping - Search-friendly structured datasets - AI-ready structured data - Production-grade integrations **Need custom solutions?** - Enterprise scraping setups - Private Actor modifications - Custom integrations & webhooks - Data pipeline optimization 👉 Contact via Apify marketplace. *** ## ⭐ Support & Feedback If this Actor helps your project: - ⭐ **Star** this repository (GitHub) - 💬 **Leave a review** on the Apify marketplace - 📧 **Report issues** or request features Your feedback helps improve this tool for the community! # Actor input Schema ## `startUrls` (type: `array`): Hotel detail page URLs on TUI to scrape reviews from. ## `maxReviewsPerHotel` (type: `integer`): Maximum number of reviews to scrape per hotel ## `cutoffDate` (type: `string`): Only keep reviews on or after this date (YYYY-MM-DD). Interpreted as a local date, assumed to be in the Europe/Berlin timezone — TUI does not expose timezone information. Leave empty to scrape all available reviews. ## `alwaysReturnSummary` (type: `boolean`): Whether to always return a summary of hotel reviews, even if no reviews were found. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/" } ], "maxReviewsPerHotel": 100, "cutoffDate": "2025-01-01", "alwaysReturnSummary": true } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/" } ], "maxReviewsPerHotel": 100, "alwaysReturnSummary": true }; // Run the Actor and wait for it to finish const run = await client.actor("knagymate/tui-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 = { "startUrls": [{ "url": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/" }], "maxReviewsPerHotel": 100, "alwaysReturnSummary": True, } # Run the Actor and wait for it to finish run = client.actor("knagymate/tui-reviews-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 '{ "startUrls": [ { "url": "https://www.tui.com/hotel/suchen/angebote/TUI-KIDS-CLUB-Wangerland-Resort/92399/offer/" } ], "maxReviewsPerHotel": 100, "alwaysReturnSummary": true }' | apify call knagymate/tui-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,knagymate/tui-reviews-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 ` 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/TST6XC466JDgDlfhb/builds/ecVsWZppCKpAgOrAQ/openapi.json