# HolidayCheck Scraper - Hotel Reviews, Ratings & Hotel Data (`topapi/holidaycheck-scraper`) Actor

Scrape HolidayCheck hotel reviews (.de/.at/.ch): full text, 1-6 ratings per criterion, hotel replies, photos, traveller type, dates; hotel rows with phone, e-mail, website, address, price. Any hotel link, name or place, every review filter, monitor mode. $0.81 per 1,000 reviews.

- **URL**: https://apify.com/topapi/holidaycheck-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Travel, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.81 / 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.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does HolidayCheck Scraper do?

HolidayCheck Scraper collects hotel reviews and hotel data from **[HolidayCheck](https://www.holidaycheck.de)**
(holidaycheck.de, .at and .ch), the German-speaking hotel review and package-holiday portal. It reads HolidayCheck's own
public data, 100 reviews at a time, with no browser, login, cookies or API key.

- **Reviews:** title, full text, the overall rating on HolidayCheck's 1-6 scale, every criterion the guest rated (service,
  location, food, room, value for money, cleanliness, sleep...), the **hotel's reply**, HolidayCheck's topic tags with the quoted
  sentences, the answers to its sub-questions (room, service, restaurant, beach, pool, insider tip...), traveller type, trip
  reason and length, travel and review dates, verified stay, tour operator, room, the reviewer (first name, age group, home
  country, review count), review photos and helpful votes.
- **Hotels:** phone, e-mail, **website**, address, coordinates, stars, rating, recommendation rate, review counts, ratings per
  area, per traveller type and per trip reason, facilities, description, award, and the **cheapest offer on the hotel's page**
  (price per person, total, dates, board, room, tour operator, departure airport, deal, cashback) with its photos.

Give it **hotel links or ids**, **hotel names**, **places** ("Mallorca", "Antalya", "Kos") or **destination links**. Every
review filter HolidayCheck offers (date, travel date, traveller type, rating, recommendation, verified stay, age group, trip
reason, topic, language, words in the review) is applied inside HolidayCheck's own query, so you pay only for the reviews you
asked for. **Monitor mode** returns only new reviews on a schedule.

### What data can you get from HolidayCheck?

**Review rows** (`record_type: "review"`)

| Group | Fields |
|---|---|
| Review | `review_id`, `review_url`, `review_title`, `review_text`, `entry_date`, `original_locale`, `returned_locale`, `ranking`, `helpful_count` |
| Rating | `rating_6` (1-6, 6 = best), `overall_rating` (0-1), `rating_max`, `rating_location`, `rating_service`, `rating_food`, `rating_room`, `rating_value_for_money`, `rating_activities`, `criteria_ratings`, `criteria_ratings_6`, `ratings_by_aspect` |
| Stay | `recommendation`, `proofed_reservation` (verified stay), `traveled_with`, `travel_reason`, `travel_duration`, `travel_date`, `cost_performance`, `tour_operator`, `room_name`, `room_type`, `room_view`, `room_category`, `stars_correct`, `catalog_correct` |
| Reviewer | `user_id`, `user_first_name`, `user_age_group`, `user_hotel_review_count`, `user_has_public_profile`, `user_picture_url`, `user_origin` |
| Hotel reply | `has_owner_comment`, `owner_comment_text`, `owner_comment_entry_date` |
| Topics | `topics` (id, name, sentiment -1/0/1, quotes), `topic_ids`, `topic_names`, `topic_sentiments`, `topic_quotes` |
| Free-text answers | `hotel_opinion`, `room_opinion`, `service_opinion`, `restaurant_opinion`, `location_opinion`, `sport_opinion`, `beach_opinion`, `pool_opinion`, `transportation_opinion`, `sustainability_opinion`, `culture_opinion`, `wellness_opinion`, `secret_tip`, `activities_other`, `extra_texts` (every answer by question id) |
| Other answers | `activities`, `review_choices` (categories, popular service, unexpected costs, rewards...) |
| Photos | `photos` (id, type, title, description, url), `photo_urls`, `photo_count` |
| Hotel | `hotel_id`, `hotel_name`, `hotel_url`, `hotel_stars`, `hotel_rating_6`, `hotel_recommendation_rate`, `hotel_review_count`, `hotel_city`, `hotel_region`, `hotel_country` |
| Run | `sort`, `review_position`, `review_page`, `search_input`, `search_match`, `content_fingerprint`, `scraped_at`; monitor runs add `change_type`, `first_seen_at`, `last_seen_at`, `monitoring_state_key`; `raw` with **Raw review data** on |

**Hotel rows** (`record_type: "hotel"`, Hotels mode)

| Group | Fields |
|---|---|
| Hotel | `hotel_id`, `name`, `hotel_url`, `reviews_url`, `stars`, `is_closed`, `former_names`, `latest_award`, `description`, `descriptions` |
| Contact | `phone`, `email`, `website`, `address`, `address_lines` |
| Place | `city`, `region`, `country`, `continent`, `location`, `categories`, `latitude`, `longitude` |
| Ratings | `rating_6`, `rating_max`, `recommendation_rate`, `recommendation_percent`, `review_count`, `review_count_archived`, `rating_trend`, `aspect_ratings_6`, `ratings_by_traveled_with`, `ratings_by_travel_reason`, `rating_breakdown`, `highlights` |
| Facilities | `facilities` (by name), `facility_count` |
| Price (hotel page) | `price_per_person`, `total_price`, `price_currency`, `price_travelkind` (package / hotelonly), `offer_departure_date`, `offer_return_date`, `offer_nights`, `offer_duration_days`, `offer_meal_type`, `offer_room`, `offer_tour_operator`, `offer_departure_airport`, `offer_transfer`, `offer_deal`, `cashback_amount`, `price_after_cashback`, `price_range_text`, `price_fetched` |
| Photos (hotel page) | `primary_image_url`, `image_urls`, `picture_count`, `video_count` |

### How to scrape HolidayCheck with HolidayCheck Scraper

1. Paste **HolidayCheck links** (a hotel page, its review page, a destination page or a single review), add **hotel ids**, or
   type **hotel names or places**.
2. Pick **Reviews**, **Hotels** or both, set **Max reviews per hotel** and any review filters.
3. Run, then download the dataset as JSON, CSV or Excel (the **Reviews**, **Review ratings**, **Hotel replies** and
   **Hotels** views are ready-made tables).

### ⬇️ Input

| Input | What it does |
|---|---|
| `startUrls` | Hotel pages (`/hi/...`, `/hr/bewertungen-...`, `/ho/...`), destination pages (`/dh/hotels-...`, `/dr/bewertungen-...`, `/urlaub/spanien/mallorca`), single reviews (`/hrd/...`) or bare ids, on .de, .at or .ch. |
| `hotelIds` | HolidayCheck hotel ids (the 36-character id at the end of a hotel link). |
| `searchQueries` | Hotel names or places, matched by HolidayCheck's own search; `search_match` in each row says what was found. |
| `mode` | `reviews` (default), `hotels`, or `both` (hotel rows plus their reviews). |
| `destinationMode` | For a place in Reviews mode: its **newest reviews** across every hotel (HolidayCheck's review page for the place), or the reviews of its **top hotels**. |
| `maxReviewsPerHotel` (default 100, 0 = all), `maxItems` (default 1,000, 0 = no limit), `maxHotels` (default 20 per place) | Limits. |
| `reviewSort` | Newest, oldest, most relevant, best rated, worst rated or latest travel date first. |
| `reviewsFrom`, `reviewsTo`, `reviewsWithinDays`, `travelDateFrom`, `travelDateTo` | Review and stay dates. |
| `traveledWith`, `ratings` (1-6), `recommendation`, `verifiedOnly`, `ageGroups`, `travelReasons`, `topics`, `languages`, `reviewSearch` | HolidayCheck's own review filters, applied in its query. |
| `ownerReply`, `withTextOnly`, `withPhotosOnly` | Checked before the charge: a review they remove is never charged. |
| `minStars`, `minHotelRating`, `minHotelReviews`, `minRecommendationPercent`, `hotelSort`, `includeClosedHotels` | Which hotels of a place are read, in HolidayCheck's hotel list. |
| `includeHotelInfo`, `includePhotos`, `includeHelpfulCount`, `includeReviewerOrigin`, `includePrices` | Extra data, on by default, no extra charge. |
| `includeRawData`, `excludeEmptyFields` | Shape of the rows. |
| `monitorMode`, `stateName`, `emitBaseline`, `includeUnchanged`, `resetMonitor` | Only new reviews on a schedule. |
| `maxConcurrency`, `proxyConfiguration` | Advanced; leave the proxy as it is. |

Input names other HolidayCheck actors use work too: `urls`, `hotelUrls`, `hotelNames`, `searchQuery`, `maxReviews`,
`results_wanted`, `max_pages`, `review_sort`, `cutoffDate`, `includeHotelSummary`, `deduplicateAcrossRuns`, `stateStoreName`,
`resetState`. Links may be given as `{ "url": ... }` objects (Console) or plain strings (`urls`, API).

#### Input JSON

```json
{
  "startUrls": [{ "url": "https://www.holidaycheck.de/hi/iberostar-selection-playa-de-palma/7c552adb-248a-355a-9f41-659fb90ed364" }],
  "searchQueries": ["Hotel Bahia del Sol"],
  "maxReviewsPerHotel": 200,
  "reviewSort": "newest",
  "reviewsFrom": "2026-01-01",
  "traveledWith": ["FAMILY"],
  "ratings": ["1", "2", "3"]
}
```

Hotels of a place with their contact details and prices:

```json
{ "searchQueries": ["Antalya"], "mode": "hotels", "maxHotels": 200, "minStars": 4, "hotelSort": "popular" }
```

#### A place gives its newest reviews or its top hotels

"Mallorca" in Reviews mode returns the newest reviews of every Mallorca hotel, newest first, up to **Max rows in total**
(HolidayCheck's own review page for the place). Switch **For a place: which reviews** to *Reviews of its top hotels* to read the
most-reviewed hotels (or those your hotel filters keep) one by one, each up to **Max reviews per hotel**.

#### Filters cost nothing extra when HolidayCheck applies them

Rating, traveller type, dates, verified stay, age group, trip reason, topic, language and words in the review are sent to
HolidayCheck, which returns only matching reviews. Hotel reply, text-only and photos-only are checked by the actor before the
charge; when they keep very few reviews, the actor stops reading further pages (the status says so).

### ⬆️ Output

A real review row (run ddqZDYCfXFYBzHRsW, Mallorca's newest reviews; long texts and lists cut here):

```json
{
  "record_type": "review",
  "review_id": "b48d14ef-0a19-4dc7-b1dd-8082931cd35f",
  "review_url": "https://www.holidaycheck.de/hrd/js-cape-colom-adults-only/b48d14ef-0a19-4dc7-b1dd-8082931cd35f",
  "hotel_id": "833f2cb5-22c9-351d-aef2-c4ce821a2bf7",
  "hotel_name": "JS Cape Colom - Adults only",
  "hotel_url": "https://www.holidaycheck.de/hi/js-cape-colom-adults-only/833f2cb5-22c9-351d-aef2-c4ce821a2bf7",
  "hotel_stars": 3,
  "hotel_rating_6": 5.3,
  "hotel_recommendation_rate": 0.96,
  "hotel_review_count": 2029,
  "hotel_city": "Porto Colom",
  "hotel_region": "Mallorca",
  "hotel_country": "Spanien",
  "review_title": "Eine rundum gelungene Auszeit am Meer",
  "review_text": "Trotz Saison-Ende war alles top: Personal hilfreich und freundlich, Auswahl des Essens perfekt (auch als Vegetarierin habe ich täglich varia...",
  "overall_rating": 1,
  "rating_6": 6,
  "rating_max": 6,
  "rating_value_for_money": 1,
  "criteria_ratings": { "ROOM_SIZE": 1, "FOOD_VARIETY": 1, "PRICE_PERFORMANCE": 1, "SLEEP": 1, "ROOM_CLEANLINESS": 1, "GERMAN_SKILLS": 1, "TASTINESS": 1, "TRANSPORTATION": 1 },
  "criteria_ratings_6": { "ROOM_SIZE": 6, "FOOD_VARIETY": 6, "PRICE_PERFORMANCE": 6, "SLEEP": 6, "ROOM_CLEANLINESS": 6, "GERMAN_SKILLS": 6, "TASTINESS": 6, "TRANSPORTATION": 6 },
  "ratings_by_aspect": { "GENERAL": { "GENERAL": 6 }, "LOCATION": { "TRAFFIC": 6 }, "HOTEL": { "GENERAL": 6 }, "ROOM": { "SIZE": 6, "CLEANNESS": 6 }, "FOOD": { "VARIETY": 6, "QUALITY": 6 } },
  "recommendation": true,
  "proofed_reservation": false,
  "traveled_with": "FRIENDS",
  "travel_reason": "BEACH",
  "travel_date": "2026-10-01",
  "entry_date": "2026-11-12T22:58:24.000Z",
  "original_locale": "de",
  "ranking": 0.5363,
  "helpful_count": 0,
  "cost_performance": "EXCELLENT",
  "user_first_name": "Mukti",
  "user_age_group": "FROM_51_TO_55",
  "user_hotel_review_count": 1,
  "user_origin": "Österreich",
  "has_owner_comment": true,
  "owner_comment_text": "Liebe Mukti,\nvielen lieben Dank für Ihre ausführliche und so begeisterte Rückmeldung! Es ist toll zu lesen, dass Sie bei uns eine so erholsa...",
  "owner_comment_entry_date": "2026-11-13T00:00:00.000Z",
  "topics": [
    { "id": "SERVICE", "name": "Service", "sentiment": 1, "quotes": ["Fast das gesamte Personal war sehr freundlich und hilfsbereit, und das am Saisonende.", "Alle Achtung!", "Personal hilfreich und freundlich"] },
    { "id": "FITNESS", "name": "Fitness", "sentiment": -1, "quotes": ["Bei Schlechtwetter hätte man mir zwar den Fitnessraum angeboten, aber da hätten wir nie genug Platz gehabt."] }
  ],
  "activities": ["Strand", "Sport", "Kultur & Erlebnis"],
  "review_choices": { "POPULAR_SERVICE": ["Zimmer", "Rezeption", "Bar, Disco & Restaurant"], "UNEXPECTED_COSTS": ["Nein, keine unerwarteten Kosten."] },
  "service_opinion": "Fast das gesamte Personal war sehr freundlich und hilfsbereit, und das am Saisonende. Alle Achtung!",
  "secret_tip": "Naturpark Mondrago",
  "photos": [{ "id": "04fe67ca-81d1-46f4-ac39-73c0a31df9b1", "type": "PICTURE", "title": "Ausblick", "description": null, "url": "https://media-cdn.holidaycheck.com/w_1024,h_768,c_fit,q_auto,f_auto/ugc/images/04fe67ca-81d1-46f4-ac39-73c0a31df9b1" }],
  "photo_count": 5,
  "sort": "newest",
  "review_position": 120,
  "review_page": 12,
  "search_input": "Mallorca",
  "search_match": "HolidayCheck search: region: newest reviews in the destination",
  "scraped_at": "2026-11-13T17:27:17.371Z"
}
```

A real hotel row (run 2tupQYAyHBWitOlfZ, Antalya hotels; lists and descriptions cut here):

```json
{
  "record_type": "hotel",
  "hotel_id": "a53e30dd-0e87-3bcf-945d-b7bc01357f7b",
  "name": "Hotel Adonis",
  "hotel_url": "https://www.holidaycheck.de/hi/hotel-adonis/a53e30dd-0e87-3bcf-945d-b7bc01357f7b",
  "stars": 4,
  "rating_6": 4.64,
  "recommendation_percent": 70,
  "review_count": 191,
  "location": "Antalya, Türkische Riviera, Türkei",
  "address": "Eski Lara Yolu Uzeri Muratpasa\n07100\nAntalya\nTürkei",
  "phone": "+902423164444",
  "email": "sales1@adonishotel.com.tr",
  "website": "http://www.adonishotel.com",
  "latitude": 36.8586997,
  "longitude": 30.7316396,
  "facilities": ["Innenpool", "Eigener Balkon", "Halbpension", "Sitzecke", "Behindertenfreundliche Zimmer", "Pool", "..."],
  "facility_count": 160,
  "aspect_ratings_6": { "LOCATION": 5.13, "HOTEL": 4.64, "ROOM": 5.19, "FOOD": 4.47, "SPORT": 3.85, "SERVICE": 4.96 },
  "ratings_by_traveled_with": { "COUPLE": { "count": 93, "rating_6": 4.69, "recommendation_rate": 0.641 }, "FAMILY": { "count": 37, "rating_6": 4.74, "recommendation_rate": 0.757 } },
  "rating_breakdown": { "EXCELLENT": 66, "VERY_GOOD": 49, "ACCEPTABLE": 40, "POOR": 21, "TERRIBLE": 15 },
  "price_per_person": 521,
  "total_price": 1042,
  "price_currency": "EUR",
  "price_travelkind": "package",
  "offer_departure_date": "2027-03-25",
  "offer_return_date": "2027-04-01",
  "offer_meal_type": "Frühstück",
  "offer_room": "Doppelzimmer",
  "offer_tour_operator": "DERTOUR Packaging",
  "offer_departure_airport": "Wien (VIE)",
  "offer_deal": "Frühbucher Deal",
  "cashback_amount": 10,
  "price_after_cashback": 1032,
  "price_range_text": "ab 521 EUR (Frühstück, 8 Tage, inkl. Flug p.P.)",
  "primary_image_url": "https://media-cdn.holidaycheck.com/w_1024,h_768,c_fit,q_auto,f_auto/ugc/images/7beeb50d-2c3b-4b36-90ef-6bd0d4f64bb3",
  "picture_count": 146,
  "price_fetched": true
}
```

#### Fill rates (measured)

Reviews, run ddqZDYCfXFYBzHRsW (1,500 newest Mallorca reviews): id, link, hotel and hotel columns, title, text, rating,
recommendation, verified flag, travel and review dates, reviewer first name, origin and review count, topics 93%, helpful votes
100%. Hotel reply 38%, criteria ratings 66%, trip reason 36%, trip length 39%, room text 34%, service text 30%, insider tip 23%,
tour operator 13%, photos 11% of reviews (the share of guests who uploaded photos for their stay). Fields a guest leaves empty
stay `null`.

Hotels, run 2tupQYAyHBWitOlfZ (50 Antalya hotels, 4+ stars): phone 100%, e-mail 96%, website 90%, address, coordinates, ratings
and facilities 96-100%, description 30%; the hotel page's offer 80% (hotels with no bookable offer for HolidayCheck's default
dates have none), cashback 6%.

### How much does it cost to scrape HolidayCheck?

Pay per row, no start fee:

| Event | Price | When |
|---|---|---|
| `review` | **$0.00081** ($0.81 per 1,000) | each review row delivered |
| `hotel` | **$0.00089** ($0.89 per 1,000) | each hotel row delivered (Hotels mode) |

Hotel columns, photos, helpful votes, reviewer origin and the hotel price are included. Reviews removed by your filters and
reviews an earlier monitor run already delivered are never charged. Examples: a hotel's 1,619 reviews = $1.31; 1,500 newest
reviews of Mallorca = $1.22; 200 Antalya hotels with contacts and prices = $0.18.

Set **Maximum cost per run** in the run options to cap a run: it stops cleanly at the limit and charges only rows delivered.

### Run it on a schedule (only new reviews)

Switch on **Monitor: only new reviews** and schedule the same input daily or weekly. Each run asks HolidayCheck only for reviews
written since the previous run and delivers the new ones (`change_type: NEW`); an empty run costs almost nothing. A review an
earlier run delivered without an add-on you have since switched on comes back once as `DETAILS`. Use **Monitor name** to keep
several monitors apart, and **Deliver the first run** off to start from today without receiving the backlog.

### Integrations, API, scheduling & MCP

Run it from the Apify API, the JavaScript / Python clients, Make, Zapier, n8n or any MCP client, schedule it in the Console,
and send results to Google Sheets, Slack, webhooks or your database through Apify integrations.

### Limits & empty runs

- One link, id or name gives one hotel or one place; a place lists up to 20,000 hotels.
- HolidayCheck answers most cloud addresses with a refusal, so the actor moves through the Apify datacenter proxy to a
  residential one on its own. On the residential route the hotel page (the source of the price and the hotel photos, ~100 KB
  each) is read only for as many hotels as the run's rows pay for; hotel rows always carry the rest of their data, and
  `price_fetched` tells which rows have the page.
- A review with no photos, no hotel reply or no free text has those fields empty.
- Input that matches nothing ends with a status message that says why and is not charged.

### FAQ

#### How many reviews can it collect in one run?

As many as HolidayCheck has: a hotel's full history (`maxReviewsPerHotel: 0`) or every review of a place. Measured: 1,619
reviews of one hotel in 43 s, 1,500 reviews of Mallorca in 35-63 s.

#### Which rating scale is used?

HolidayCheck shows ratings as 1-6 suns (6 = best): `rating_6`, `criteria_ratings_6`, `hotel_rating_6`. `overall_rating` and
`criteria_ratings` keep HolidayCheck's stored 0-1 values.

#### Does it work for holidaycheck.at and holidaycheck.ch?

Yes. Links from all three sites work; the reviews are the same.

#### Do I need a HolidayCheck account, cookies or an API key?

No.

#### Why did my run return no results?

The link is not a HolidayCheck hotel or place, the name matched nothing, or the filters left no review. The status message says
which.

#### Your feedback

Found a bug or need a field? Open an issue on the actor's Issues tab.

# Actor input Schema

## `startUrls` (type: `array`):

Hotel pages (holidaycheck.de/hi/..., /hr/bewertungen-..., /ho/...), destination pages (/dh/hotels-..., /dr/bewertungen-..., /urlaub/spanien/mallorca), single review pages (/hrd/...) or bare HolidayCheck ids. .de, .at and .ch all work.

## `hotelIds` (type: `array`):

HolidayCheck hotel ids (the 36-character id at the end of a hotel link), one per line.

## `searchQueries` (type: `array`):

A hotel name ("Iberostar Selection Playa de Palma") or a place ("Mallorca", "Kos", "Antalya", "Sylt"), one per line. Each is matched by HolidayCheck's own search; the match is shown in every row (search_match).

## `mode` (type: `string`):

Reviews (one row per review), hotels (one row per hotel: contact details, address, coordinates, ratings, facilities, cheapest price) or both.

## `destinationMode` (type: `string`):

With a place or destination link in Reviews mode: the newest reviews of every hotel there (HolidayCheck's own review page for the place), or the reviews of its top hotels (up to "Max hotels per place", each up to "Max reviews per hotel"). Hotels mode always lists hotels.

## `maxReviewsPerHotel` (type: `integer`):

Reviews per hotel (0 = every review HolidayCheck has for the hotel).

## `maxItems` (type: `integer`):

Stop after this many rows (reviews and hotels together; 0 = no limit). Rows removed by filters and rows an earlier monitor run delivered do not count.

## `maxHotels` (type: `integer`):

Hotels read from each place or destination link (0 = every hotel HolidayCheck lists there, up to tens of thousands).

## `reviewSort` (type: `string`):

HolidayCheck's own orders. With a per-hotel limit, this decides which reviews you get.

## `reviewsFrom` (type: `string`):

Only reviews published on or after this date (e.g. 2026-01-01).

## `reviewsTo` (type: `string`):

Only reviews published before this date.

## `reviewsWithinDays` (type: `integer`):

Only reviews published in the last N days (a rolling window for scheduled runs).

## `travelDateFrom` (type: `string`):

Only reviews of stays from this month on (e.g. 2026-06-01).

## `travelDateTo` (type: `string`):

Only reviews of stays before this date.

## `traveledWith` (type: `array`):

Only reviews by these travellers.

## `ratings` (type: `array`):

Only reviews with these overall ratings on HolidayCheck's 1-6 scale (6 = best). E.g. 1, 2 and 3 for the critical ones.

## `recommendation` (type: `string`):

Only reviews that recommend the hotel, or only those that do not.

## `verifiedOnly` (type: `boolean`):

Only reviews HolidayCheck marks as a verified stay (proofed reservation).

## `ageGroups` (type: `array`):

Only reviewers in these age groups.

## `travelReasons` (type: `array`):

Only reviews of trips for these reasons.

## `topics` (type: `array`):

Only reviews HolidayCheck tagged with these topics, e.g. FOOD, SERVICE, ROOM, POOL, BEACH, LOCATION, CLEANLINESS, NOISE, HOTEL, ENTERTAINMENT, WIFI.

## `languages` (type: `array`):

Only reviews written in these languages (two-letter codes: de, en, fr, nl, pl...).

## `reviewSearch` (type: `string`):

HolidayCheck's own review search: only reviews containing every word (e.g. "pool kinder").

## `ownerReply` (type: `string`):

Only reviews the hotel answered, or only unanswered ones (checked before the charge).

## `withTextOnly` (type: `boolean`):

Skip rating-only reviews (checked before the charge).

## `withPhotosOnly` (type: `boolean`):

Only reviews whose author uploaded photos of the stay (checked before the charge).

## `minStars` (type: `integer`):

Hotels of a place: at least this many stars.

## `minHotelRating` (type: `string`):

Hotels of a place: overall HolidayCheck rating at least this (e.g. 5.0).

## `minHotelReviews` (type: `integer`):

Hotels of a place: at least this many reviews.

## `minRecommendationPercent` (type: `integer`):

Hotels of a place: at least this share of reviewers recommend it.

## `hotelSort` (type: `string`):

Which hotels of a place come first.

## `includeClosedHotels` (type: `boolean`):

Also list hotels HolidayCheck marks as closed.

## `includeHotelInfo` (type: `boolean`):

Add the hotel's stars, overall rating, recommendation rate, review count, city, region and country to every review row. Free.

## `includePhotos` (type: `boolean`):

The photos each reviewer uploaded for the stay (id, title, image link). Free.

## `includeHelpfulCount` (type: `boolean`):

How many readers marked each review as helpful. Free.

## `includeReviewerOrigin` (type: `boolean`):

The reviewer's home country or region as HolidayCheck shows it. Free.

## `includePrices` (type: `boolean`):

Hotel rows: the cheapest offer on the hotel's page (price per person, total, dates, board, room, tour operator, deal, cashback) plus its photos and picture count. Free.

## `includeRawData` (type: `boolean`):

Also attach HolidayCheck's full review record (every answered question) under raw.

## `excludeEmptyFields` (type: `boolean`):

Drop null and empty fields from each row (smaller exports).

## `monitorMode` (type: `boolean`):

Run on a schedule and get only reviews (and hotels) not delivered by an earlier run with the same input. A poll asks HolidayCheck only for reviews written since the previous run; reviews seen before are neither delivered nor charged; an empty poll costs almost nothing.

## `stateName` (type: `string`):

Keeps separate monitors apart when the same input runs on several schedules.

## `emitBaseline` (type: `boolean`):

On: the first monitor run delivers what exists now. Off: it only records it (nothing delivered or charged) and later runs deliver what is new.

## `includeUnchanged` (type: `boolean`):

Monitor runs: also deliver rows seen before, marked UNCHANGED (charged).

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered and start over.

## `maxConcurrency` (type: `integer`):

Hotels read in parallel (1-12).

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

Leave as it is. HolidayCheck refuses Apify's own addresses, so the actor moves to the Apify datacenter proxy on its own (and, paid by the run's rows, a residential one) when HolidayCheck refuses an address. A proxy set here is used first; if it does not answer, the run continues without it.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.holidaycheck.de/hi/iberostar-selection-playa-de-palma/7c552adb-248a-355a-9f41-659fb90ed364"
    }
  ],
  "mode": "reviews",
  "destinationMode": "latestReviews",
  "maxReviewsPerHotel": 20,
  "maxItems": 1000,
  "maxHotels": 20,
  "reviewSort": "newest",
  "recommendation": "any",
  "verifiedOnly": false,
  "ownerReply": "any",
  "withTextOnly": false,
  "withPhotosOnly": false,
  "hotelSort": "popular",
  "includeClosedHotels": false,
  "includeHotelInfo": true,
  "includePhotos": true,
  "includeHelpfulCount": true,
  "includeReviewerOrigin": true,
  "includePrices": true,
  "includeRawData": false,
  "excludeEmptyFields": false,
  "monitorMode": false,
  "stateName": "default",
  "emitBaseline": true,
  "includeUnchanged": false,
  "resetMonitor": false,
  "maxConcurrency": 6,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One item per HolidayCheck review (text, 1-6 ratings, criteria, hotel reply, photos, traveller, dates) or hotel (contact details, address, coordinates, ratings, facilities, cheapest price).

## `summary` (type: `string`):

Per-input counts (HolidayCheck's total, delivered, pages), filters, egress and requests. Written when an input failed or on runs of 1,000+ rows; every run logs it.

# 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 = {
    "startUrls": [
        {
            "url": "https://www.holidaycheck.de/hi/iberostar-selection-playa-de-palma/7c552adb-248a-355a-9f41-659fb90ed364"
        }
    ],
    "maxReviewsPerHotel": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/holidaycheck-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 = {
    "startUrls": [{ "url": "https://www.holidaycheck.de/hi/iberostar-selection-playa-de-palma/7c552adb-248a-355a-9f41-659fb90ed364" }],
    "maxReviewsPerHotel": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/holidaycheck-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.holidaycheck.de/hi/iberostar-selection-playa-de-palma/7c552adb-248a-355a-9f41-659fb90ed364"
    }
  ],
  "maxReviewsPerHotel": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call topapi/holidaycheck-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/holidaycheck-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/yyLxH6E4U5hMpxQaL/builds/kDSSzQm49Ih8YZFWV/openapi.json
