Tui Product Scraper

Introduction

The Tui Product Scraper is a powerful Apify Actor designed to extract comprehensive data from TUI's vacation rental listings powered by HomeToGo. It automates the collection of detailed product information, including prices, locations, amenities, and images, enabling efficient data gathering for market analysis, competitive research, and business intelligence. This tool leverages Playwright for reliable web scraping, ensuring high-quality results from TUI's dynamic pages.

Features

• Comprehensive Data Extraction: Scrapes key details such as offer titles, prices, locations, geo-coordinates, amenities, and image links from TUI vacation rental pages.
• Reliable Performance: Uses Playwright Crawler for handling JavaScript-heavy sites, with built-in proxy support to avoid IP blocks and ensure uninterrupted scraping.
• Structured Output: Delivers clean, JSON-formatted data that's easy to integrate into databases, analytics tools, or downstream applications.
• Scalable and Efficient: Supports multiple start URLs for batch processing, ideal for large-scale data collection.
• High Data Quality: Extracts full offer data, including deep links, aliases, and analytics-ready fields, minimizing manual data cleaning.
• Proxy Integration: Configurable proxy settings, defaulting to Apify's residential proxies for enhanced anonymity and success rates.
• Error-Resilient: Handles common web scraping challenges like dynamic content and rate limits through robust configuration.

Input Parameters

Parameter	Type	Required	Description	Example
startUrls	array	Yes	An array of URLs to start scraping from. These should be category or search result pages from TUI's vacation rental site.	[{"url": "https://ferienwohnung.tui.com/search/54189042d2fd6"}]
proxyConfiguration	object	No	Specifies proxy servers to hide the scraper's origin. Defaults to Apify's residential proxies.	{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}

Example Usage

Input JSON

{
  "startUrls": [
    {
      "url": "https://ferienwohnung.tui.com/search/54189042d2fd6"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Output JSON

[
  {
    "url": "https://ferienwohnung.tui.com/search/54189042d2fd6",
    "pageTitle": "Ferienhäuser & Ferienwohnungen bei TUI powered by HomeToGo buchen",
    "locationId": "54189042d2fd6",
    "searchId": "5d1c2b71ea630d7e34d7b48924aa5355",
    "offerId": "470e41615b408ab4",
    "offerTitle": "Ferienwohnung",
    "price": "€164",
    "location": "Alicante, L'Alacantí, Spanien",
    "rentalObjectId": "e7b300ef2d425236",
    "imageLinks": {
      "small": "//cdn.hometogo.net/small/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
      "medium": "//cdn.hometogo.net/medium/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
      "large": "//cdn.hometogo.net/large/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
      "thumbnail": "//cdn.hometogo.net/small/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
      "aspectRatio": 1.5019556714471969,
      "altText": "Voll ausgestattete wunderschöne Wohnung | Castillo de Santa Bárbara-Nähe | Stadtblick - 0"
    },
    "preferredImageId": null,
    "geoLocation": {
      "lat": 38.3438759,
      "lon": -0.4847306
    },
    "fullGeoHash": "eyzdhur12",
    "deepLink": "/deeplink/?params=eJwljkEOwiAQRe_CVpvMwFAoN-jOhRcYYIwkrW1aNsZ4dyFu33s_-R-1bIlr2V4qKEvoJyCd9SOP6qr2oySp712aq1vl5dZBE7WsclZe9yY0aDsgDkh3cMH4AO4CGABaV3ILyIEQjmgjgedIjZ_CR3rO3dqMSUeHwqOB7MRQdpH8pInZGmt7nQ6R_u8_U98ffWwzKQ",
    "initialPrice": null,
    "nearby": false,
    "alias": [
      "470e41615b408ab4",
      "5a18dbc0a989aba9",
      "e7b300ef2d425236",
      "2e506ffb35ad5872",
      "18996b71846d58db",
      "2157c7a27b312c9414f90fb9bc5f35c8"
    ],
    "amenities": {
      "labelSectionTitle": "Ausstattung",
      "common": [
        {
          "label": "Spülmaschine",
          "amenity": "dishwasher"
        },
        {
          "label": "Waschmaschine",
          "amenity": "washing_machine_available"
        },
        {
          "label": "TV",
          "amenity": "tv"
        },
        {
          "label": "Klimaanlage",
          "amenity": "air_conditioning"
        },
        {
          "label": "WLAN",
          "amenity": "internet"
        },
        {
          "label": "Mikrowelle",
          "amenity": "microwave"
        },
        {
          "label": "Kinderbett",
          "amenity": "cot"
        },
        {
          "label": "Haustiere nicht gestattet",
          "amenity": "no_dogs"
        },
        {
          "label": "Nichtraucher",
          "amenity": "smoking_not_allowed"
        },
        {
          "label": "Küche",
          "amenity": "kitchen"
        },
        {
          "label": "Haartrockner",
          "amenity": "hairdryer"
        },
        {
          "label": "Bügeleisen",
          "amenity": "iron"
        },
        {
          "label": "Kaffeemaschine",
          "amenity": "coffee_machine"
        },
        {
          "label": "Wasserkocher",
          "amenity": "kettle"
        },
        {
          "label": "Toaster",
          "amenity": "toaster"
        }
      ]
    },
    "analyticsSnowPlow": {},
    "serpImageIndex": null,
    "fullOfferData": {
      "id": "470e41615b408ab4",
      "title": "Ferienwohnung",
      "imageLinks": {
        "small": "//cdn.hometogo.net/small/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
        "medium": "//cdn.hometogo.net/medium/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
        "large": "//cdn.hometogo.net/large/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
        "thumbnail": "//cdn.hometogo.net/small/v1/4b2/ef4/a36cc1c3dd89a9d228bfd50cd6.jpg",
        "aspectRatio": 1.5019556714471969,
        "altText": "Voll ausgestattete wunderschöne Wohnung | Castillo de Santa Bárbara-Nähe | Stadtblick - 0"
      },
      "preferredImageId": null,
      "lowestPriceInfo": {
        "display": "€164"
      },
      "deepLink": "/deeplink/?params=eJwljkEOwiAQRe_CVpvMwFAoN-jOhRcYYIwkrW1aNsZ4dyFu33s_-R-1bIlr2V4qKEvoJyCd9SOP6qr2oySp712aq1vl5dZBE7WsclZe9yY0aDsgDkh3cMH4AO4CGABaV3ILyIEQjmgjgedIjZ_CR3rO3dqMSUeHwqOB7MRQdpH8pInZGmt7nQ6R_u8_U98ffWwzKQ",
      "actions": {
        "conversion": {
          "first": {
            "link": "/rental/470e41615b408ab4?location=54189042d2fd6&pricetype=totalPrice&duration=7&searchId=5d1c2b71ea630d7e34d7b48924aa5355",
            "conversionCategory": "rental_open",
            "action": "follow",
            "offerId": "470e41615b408ab4"
          },
          "second": {
            "link": "/rental/470e41615b408ab4?location=54189042d2fd6&pricetype=totalPrice&duration=7&searchId=5d1c2b71ea630d7e34d7b48924aa5355",
            "conversionCategory": "rental_open",
            "action": "follow",
            "offerId": "470e41615b408ab4"
          },
          "third": {
            "link": "/rental/470e41615b408ab4?location=54189042d2fd6&pricetype=totalPrice&duration=7&searchId=5d1c2b71ea630d7e34d7b48924aa5355",
            "conversionCategory": "rental_open",
            "action": "follow",
            "offerId": "470e41615b408ab4"
          },
          "fourth": {
            "link": "/deeplink/?params=eJwljkEOwiAQRe_CVpvMwFAoN-jOhRcYYIwkrW1aNsZ4dyFu33s_-R-1bIlr2oySp712aq1vl5dZBE7WsclZe9yY0aDsgDkh3cMH4AO4CGABaV3ILyIEQjmgjgedIjZ_CR3rO3dqMSUeHwqOB7MRQdpH8pInZGmt7nQ6R_u8_U98ffWwzKQ&clo=2",
            "conversionCategory": "clickout",
            "action": "follow",
            "offerId": "470e41615b408ab4"
          },
          "fifth": {
            "link": "/rental/470e41615b408ab4?location=54189042d2fd6&pricetype=totalPrice&searchId=5d1c2b71ea630d7e34d7b48924aa5355",
            "conversionCategory": "rental_open",
            "action": "follow",
            "offerId": "470e41615b408ab4"
          }
        },
        "wishList": {
          "add": {
            "link": "/pinboard/update/470e41615b408ab4",
            "method": "POST",
            "parameters": {
              "locationId": "54189042d2fd6"
            }
          },
          "delete": {
            "link": "/pinboard/all/470e41615b408ab4",
            "method": "DELETE",
            "parameters": {}
          }
        }
      },
      "initialPrice": null,
      "locationTrailHeader": "Alicante, L'Alacantí, Spanien",
      "rentalObjectId": "e7b300ef2d425236",
      "geoLocation": {
        "lat": 38.3438759,
        "lon": -0.4847306
      },
      "fullGeoHash": "eyzdhur12",
      "nearby": false,
      "alias": [
        "470e41615b408ab4",
        "5a18dbc0a989aba9",
        "e7b300ef2d425236",
        "2e506ffb35ad5872",
        "18996b71846d58db",
        "2157c7a27b312c9414f90fb9bc5f35c8"
      ],
      "amenities": {
        "labelSectionTitle": "Ausstattung",
        "common": [
          {
            "label": "Spülmaschine",
            "amenity": "dishwasher"
          },
          {
            "label": "Waschmaschine",
            "amenity": "washing_machine_available"
          },
          {
            "label": "TV",
            "amenity": "tv"
          },
          {
            "label": "Klimaanlage",
            "amenity": "air_conditioning"
          },
          {
            "label": "WLAN",
            "amenity": "internet"
          },
          {
            "label": "Mikrowelle",
            "amenity": "microwave"
          },
          {
            "label": "Kinderbett",
            "amenity": "cot"
          },
          {
            "label": "Haustiere nicht gestattet",
            "amenity": "no_dogs"
          },
          {
            "label": "Nichtraucher",
            "amenity": "smoking_not_allowed"
          },
          {
            "label": "Küche",
            "amenity": "kitchen"
          },
          {
            "label": "Haartrockner",
            "amenity": "hairdryer"
          },
          {
            "label": "Bügeleisen",
            "amenity": "iron"
          },
          {
            "label": "Kaffeemaschine",
            "amenity": "coffee_machine"
          },
          {
            "label": "Wasserkocher",
            "amenity": "kettle"
          },
          {
            "label": "Toaster",
            "amenity": "toaster"
          }
        ]
      },
      "analyticsSnowPlow": {},
      "serpImageIndex": 0,
      "debug": null
    },
    "offerIndex": 1,
    "totalOffersInSearch": 243,
    "timestamp": "2025-11-14T06:38:08.575Z"
  }
]

Use Cases

• Market Research: Analyze vacation rental trends, pricing, and availability in specific locations for travel agencies or investors.
• Competitive Intelligence: Monitor competitors' listings on TUI to benchmark prices, amenities, and offerings.
• Price Monitoring: Track price fluctuations for dynamic pricing strategies in the hospitality industry.
• Content Aggregation: Build databases of rental properties for real estate portals or travel comparison sites.
• Academic Research: Collect data for studies on tourism economics, location-based services, or consumer behavior.
• Business Automation: Automate lead generation by extracting contactless rental data for marketing campaigns.

Installation and Usage

1. Search for "Tui Product Scraper" in the Apify Store.
2. Click "Try for free" or "Run".
3. Configure input parameters (e.g., add start URLs and adjust proxy settings).
4. Click "Start" to begin extraction.
5. Monitor progress in the log.
6. Export results in your preferred format (JSON, CSV, Excel).

Output Format

The Actor outputs a JSON array of objects, each representing a scraped vacation rental offer. Key fields include:

• url: The source page URL.
• offerTitle: Title of the rental (e.g., "Ferienwohnung").
• price: Display price (e.g., "€164").
• location: Geographic location string.
• geoLocation: Latitude and longitude coordinates.
• amenities: List of available features like dishwasher, WiFi, etc.
• imageLinks: URLs for images in various sizes.
• fullOfferData: Nested object with detailed offer information, including deep links for further actions.
• timestamp: When the data was scraped.

This structured format ensures easy parsing and integration.

Support

For custom/simplified outputs or bug reports, please contact:

• Email: support@getdataforme.com
• Subject line: "custom support"
• Contact form: https://getdataforme.com/contact/

We're here to help you get the most out of this Actor!

---

Extract vacation rental data from TUI effortlessly! This scraper pulls detailed listings including prices, locations, amenities, and images using reliable Playwright technology. Perfect for market research, price monitoring, and competitive analysis. Start scraping today with Apify's residential proxies for seamless results. Try it free! (148 characters)