{
  "openapi": "3.0.1",
  "info": {
    "title": "HolidayCheck Scraper - Hotel Reviews, Ratings & Hotel Data",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "kDSSzQm49Ih8YZFWV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~holidaycheck-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-holidaycheck-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/topapi~holidaycheck-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-holidaycheck-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/topapi~holidaycheck-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-holidaycheck-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": {
          "startUrls": {
            "title": "HolidayCheck links",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "hotelIds": {
            "title": "Hotel ids",
            "type": "array",
            "description": "HolidayCheck hotel ids (the 36-character id at the end of a hotel link), one per line.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Hotel names or places",
            "type": "array",
            "description": "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).",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "What to deliver",
            "enum": [
              "reviews",
              "hotels",
              "both"
            ],
            "type": "string",
            "description": "Reviews (one row per review), hotels (one row per hotel: contact details, address, coordinates, ratings, facilities, cheapest price) or both.",
            "default": "reviews"
          },
          "destinationMode": {
            "title": "For a place: which reviews",
            "enum": [
              "latestReviews",
              "topHotels"
            ],
            "type": "string",
            "description": "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.",
            "default": "latestReviews"
          },
          "maxReviewsPerHotel": {
            "title": "Max reviews per hotel",
            "minimum": 0,
            "type": "integer",
            "description": "Reviews per hotel (0 = every review HolidayCheck has for the hotel).",
            "default": 100
          },
          "maxItems": {
            "title": "Max rows in total",
            "minimum": 0,
            "type": "integer",
            "description": "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.",
            "default": 1000
          },
          "maxHotels": {
            "title": "Max hotels per place",
            "minimum": 0,
            "type": "integer",
            "description": "Hotels read from each place or destination link (0 = every hotel HolidayCheck lists there, up to tens of thousands).",
            "default": 20
          },
          "reviewSort": {
            "title": "Review order",
            "enum": [
              "newest",
              "oldest",
              "relevance",
              "positive",
              "negative",
              "travelDate"
            ],
            "type": "string",
            "description": "HolidayCheck's own orders. With a per-hotel limit, this decides which reviews you get.",
            "default": "newest"
          },
          "reviewsFrom": {
            "title": "Reviews written from",
            "type": "string",
            "description": "Only reviews published on or after this date (e.g. 2026-01-01)."
          },
          "reviewsTo": {
            "title": "Reviews written before",
            "type": "string",
            "description": "Only reviews published before this date."
          },
          "reviewsWithinDays": {
            "title": "Reviews of the last N days",
            "minimum": 1,
            "type": "integer",
            "description": "Only reviews published in the last N days (a rolling window for scheduled runs)."
          },
          "travelDateFrom": {
            "title": "Travel date from",
            "type": "string",
            "description": "Only reviews of stays from this month on (e.g. 2026-06-01)."
          },
          "travelDateTo": {
            "title": "Travel date before",
            "type": "string",
            "description": "Only reviews of stays before this date."
          },
          "traveledWith": {
            "title": "Traveled with",
            "type": "array",
            "description": "Only reviews by these travellers.",
            "items": {
              "type": "string",
              "enum": [
                "SINGLE",
                "COUPLE",
                "FAMILY",
                "FRIENDS"
              ],
              "enumTitles": [
                "Alone",
                "Couple",
                "Family",
                "Friends"
              ]
            }
          },
          "ratings": {
            "title": "Ratings (suns, 1-6)",
            "type": "array",
            "description": "Only reviews with these overall ratings on HolidayCheck's 1-6 scale (6 = best). E.g. 1, 2 and 3 for the critical ones.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6"
              ],
              "enumTitles": [
                "1 sun",
                "2 suns",
                "3 suns",
                "4 suns",
                "5 suns",
                "6 suns"
              ]
            }
          },
          "recommendation": {
            "title": "Recommends the hotel",
            "enum": [
              "any",
              "true",
              "false"
            ],
            "type": "string",
            "description": "Only reviews that recommend the hotel, or only those that do not.",
            "default": "any"
          },
          "verifiedOnly": {
            "title": "Verified bookings only",
            "type": "boolean",
            "description": "Only reviews HolidayCheck marks as a verified stay (proofed reservation).",
            "default": false
          },
          "ageGroups": {
            "title": "Reviewer age groups",
            "type": "array",
            "description": "Only reviewers in these age groups.",
            "items": {
              "type": "string",
              "enum": [
                "FROM_14_TO_18",
                "FROM_19_TO_25",
                "FROM_26_TO_30",
                "FROM_31_TO_35",
                "FROM_36_TO_40",
                "FROM_41_TO_45",
                "FROM_46_TO_50",
                "FROM_51_TO_55",
                "FROM_56_TO_60",
                "FROM_61_TO_65",
                "FROM_66_TO_70",
                "FROM_71"
              ],
              "enumTitles": [
                "14-18",
                "19-25",
                "26-30",
                "31-35",
                "36-40",
                "41-45",
                "46-50",
                "51-55",
                "56-60",
                "61-65",
                "66-70",
                "71+"
              ]
            }
          },
          "travelReasons": {
            "title": "Travel reason",
            "type": "array",
            "description": "Only reviews of trips for these reasons.",
            "items": {
              "type": "string",
              "enum": [
                "BEACH",
                "CITY",
                "HIKING_WELLNESS",
                "WINTER_SPORT",
                "BUSINESS",
                "OTHER"
              ],
              "enumTitles": [
                "Beach",
                "City trip",
                "Hiking / wellness",
                "Winter sports",
                "Business",
                "Other"
              ]
            }
          },
          "topics": {
            "title": "Topics mentioned",
            "type": "array",
            "description": "Only reviews HolidayCheck tagged with these topics, e.g. FOOD, SERVICE, ROOM, POOL, BEACH, LOCATION, CLEANLINESS, NOISE, HOTEL, ENTERTAINMENT, WIFI.",
            "items": {
              "type": "string"
            }
          },
          "languages": {
            "title": "Review languages",
            "type": "array",
            "description": "Only reviews written in these languages (two-letter codes: de, en, fr, nl, pl...).",
            "items": {
              "type": "string"
            }
          },
          "reviewSearch": {
            "title": "Words in the review",
            "type": "string",
            "description": "HolidayCheck's own review search: only reviews containing every word (e.g. \"pool kinder\")."
          },
          "ownerReply": {
            "title": "Hotel reply",
            "enum": [
              "any",
              "true",
              "false"
            ],
            "type": "string",
            "description": "Only reviews the hotel answered, or only unanswered ones (checked before the charge).",
            "default": "any"
          },
          "withTextOnly": {
            "title": "Reviews with text only",
            "type": "boolean",
            "description": "Skip rating-only reviews (checked before the charge).",
            "default": false
          },
          "withPhotosOnly": {
            "title": "Reviews with photos only",
            "type": "boolean",
            "description": "Only reviews whose author uploaded photos of the stay (checked before the charge).",
            "default": false
          },
          "minStars": {
            "title": "Min hotel stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Hotels of a place: at least this many stars."
          },
          "minHotelRating": {
            "title": "Min hotel rating (1-6)",
            "type": "string",
            "description": "Hotels of a place: overall HolidayCheck rating at least this (e.g. 5.0)."
          },
          "minHotelReviews": {
            "title": "Min hotel review count",
            "minimum": 0,
            "type": "integer",
            "description": "Hotels of a place: at least this many reviews."
          },
          "minRecommendationPercent": {
            "title": "Min recommendation rate (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Hotels of a place: at least this share of reviewers recommend it."
          },
          "hotelSort": {
            "title": "Hotel order",
            "enum": [
              "popular",
              "rating",
              "recommendation",
              "trend",
              "stars"
            ],
            "type": "string",
            "description": "Which hotels of a place come first.",
            "default": "popular"
          },
          "includeClosedHotels": {
            "title": "Include closed hotels",
            "type": "boolean",
            "description": "Also list hotels HolidayCheck marks as closed.",
            "default": false
          },
          "includeHotelInfo": {
            "title": "Hotel columns on review rows",
            "type": "boolean",
            "description": "Add the hotel's stars, overall rating, recommendation rate, review count, city, region and country to every review row. Free.",
            "default": true
          },
          "includePhotos": {
            "title": "Review photos",
            "type": "boolean",
            "description": "The photos each reviewer uploaded for the stay (id, title, image link). Free.",
            "default": true
          },
          "includeHelpfulCount": {
            "title": "Helpful votes",
            "type": "boolean",
            "description": "How many readers marked each review as helpful. Free.",
            "default": true
          },
          "includeReviewerOrigin": {
            "title": "Reviewer origin",
            "type": "boolean",
            "description": "The reviewer's home country or region as HolidayCheck shows it. Free.",
            "default": true
          },
          "includePrices": {
            "title": "Hotel price and photos",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "includeRawData": {
            "title": "Raw review data",
            "type": "boolean",
            "description": "Also attach HolidayCheck's full review record (every answered question) under raw.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Drop null and empty fields from each row (smaller exports).",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor: only new reviews",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "stateName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Keeps separate monitors apart when the same input runs on several schedules.",
            "default": "default"
          },
          "emitBaseline": {
            "title": "Deliver the first run",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "includeUnchanged": {
            "title": "Also deliver unchanged rows",
            "type": "boolean",
            "description": "Monitor runs: also deliver rows seen before, marked UNCHANGED (charged).",
            "default": false
          },
          "resetMonitor": {
            "title": "Reset the monitor",
            "type": "boolean",
            "description": "Forget what earlier runs delivered and start over.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Hotels read at once",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "Hotels read in parallel (1-12).",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}