# Kurzurlaub Reviews Scraper (`knagymate/kurzurlaub-reviews-scraper`) Actor

Extract structured German hotel review data from Kurzurlaub.de. Get ratings, review titles, full comments, hotelier responses, category scores and hotel summaries. Perfect for travel SEO, reputation monitoring, sentiment analysis and AI training datasets.

- **URL**: https://apify.com/knagymate/kurzurlaub-reviews-scraper.md
- **Developed by:** [knagymate](https://apify.com/knagymate) (community)
- **Categories:** Travel, SEO tools, Automation
- **Stats:** 4 total users, 3 monthly users, 99.3% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## 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/platform/actors/running/actors-in-store#pay-per-event

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

## Kurzurlaub Reviews Scraper (Hotel Bewertungen)

Scrape **Kurzurlaub.de hotel reviews** at scale with a fast, reliable, and production-ready Apify Actor.

Extract structured **German hotel review data** (Hotelbewertungen) including:
- ⭐ Overall ratings & category scores
- 📝 Review titles & full review text
- 👤 Reviewer names
- 💬 Hotelier replies (Antwort vom Hotel)
- 📅 Review & reply dates
- 🏨 Hotel summary & aggregated ratings
- 🔢 Total number of reviews per hotel

Perfect for:
- Travel & hospitality startups
- SEO teams
- AI / LLM companies
- Data analysts
- Market researchers
- Hotel reputation management platforms

Optimized for large-scale review extraction across **Kurzurlaub.de**, one of the leading German-language platforms for short trips, wellness breaks, and hotel getaways (Kurzreisen, Wellnessurlaub, Städtereisen).

---

## ✨ Features

- ✅ Scrape **Kurzurlaub.de hotel reviews** (Hotelbewertungen)
- ✅ Extract review title, comment & reviewer name
- ✅ Extract **hotelier responses** with reply dates
- ✅ Detailed category ratings (room, service, gastronomy, wellness, location)
- ✅ Aggregated hotel rating summary
- ✅ Total review count per hotel
- ✅ Multiple start URLs in a single run
- ✅ Optional cutoff date filtering
- ✅ Configurable max reviews per hotel
- ✅ Automatic pagination
- ✅ Apify API ready
- ✅ Works with webhooks, schedules, Make, Zapier, Python, and LangChain

---

## 🔍 Supported Kurzurlaub Pages

The scraper works with any **Kurzurlaub.de hotel page** or its dedicated **reviews page** (`hotelbewertungen.html`).

Example URLs:
```text
https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html
https://www.kurzurlaub.de/hotel/usedom/balm/golf-und-wellnesshotel-balmer-see.html
https://www.kurzurlaub.de/hotel/nord_schwarzwald/freudenstadt/hotel-gruener-wald/hotelbewertungen.html
````

Both URL formats are supported — the Actor automatically resolves the hotel ID and collects all available reviews.

***

## ⚙️ Input Configuration

| Field | Type | Description |
|---|---|---|
| `startUrls` | array | One or more Kurzurlaub.de hotel or review URLs |
| `maxReviewsPerHotel` | integer | Maximum number of reviews to scrape per hotel. Default: `100` |
| `cutoffDate` | date | Return only reviews newer than this date (e.g. `2026-06-01`) |

***

## 📥 Example Input

```json
{
  "startUrls": [
    {
      "url": "https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html"
    },
    {
      "url": "https://www.kurzurlaub.de/hotel/usedom/balm/golf-und-wellnesshotel-balmer-see.html"
    }
  ],
  "maxReviewsPerHotel": 100,
  "cutoffDate": "2026-06-01"
}
```

***

## 📦 Output Dataset

For every review, the Actor returns a clean, structured record that combines the **individual review**, its **category ratings**, the **hotelier reply**, and an **aggregated hotel summary** — making downstream processing simple and scalable.

***

## 🧾 Output Fields

| Field | Description |
|---|---|
| `reviewDate` | Date the review was published |
| `reviewerName` | Reviewer display name |
| `reviewTitle` | Title / headline of the review |
| `reviewerComment` | Full review text written by the guest |
| `hotelierComment` | Hotelier's reply text (Antwort vom Hotel) |
| `hotelierDate` | Date the hotelier replied |
| `ratings.overall` | Overall review rating |
| `ratings.hotel` | Hotel rating |
| `ratings.room` | Room rating (Zimmer) |
| `ratings.service` | Service rating |
| `ratings.gastronomy` | Gastronomy / food rating (Gastronomie) |
| `ratings.wellness` | Wellness rating |
| `ratings.location` | Location rating (Lage) |
| `hotelSummary.hotelId` | Internal Kurzurlaub hotel ID |
| `hotelSummary.startUrl` | Original input URL |
| `hotelSummary.numberOfReviews` | Total number of reviews for the hotel |
| `hotelSummary.ratings` | Aggregated category ratings for the hotel |

***

## 🏨 Example Review Output

```json
{
  "reviewDate": "2026-06-08 00:00:00",
  "reviewerName": "Angelika",
  "reviewTitle": "Leipziger Pentastyle Pur inkl. Penta-Burger",
  "reviewerComment": "Antwort vom Hotel: Liebe Angelika, danke, dass Sie sich die Zeit für ein Feedback genommen haben...",
  "hotelierComment": "Liebe Angelika, danke, dass Sie sich die Zeit für ein Feedback genommen haben...",
  "hotelierDate": "2026-06-08 00:00:00",
  "ratings": {
    "overall": 5.3,
    "hotel": 5.5,
    "room": 5.3,
    "service": 5.2,
    "gastronomy": 5.0,
    "wellness": 4.0,
    "location": 6.0
  },
  "hotelSummary": {
    "hotelId": "7379",
    "startUrl": "https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html",
    "numberOfReviews": 2678,
    "ratings": {
      "overall": 5.3,
      "hotel": 5.5,
      "room": 5.3,
      "service": 5.4,
      "gastronomy": 5.2,
      "wellness": 5.1,
      "location": 5.7
    }
  }
}
```

> ℹ️ Kurzurlaub.de uses a **6-point rating scale** (where 6.0 is the best possible score), unlike platforms that use 5- or 10-point scales.

***

## 🌍 Ideal Use Cases

Perfect for:

- Travel SEO & programmatic SEO
- Hotel reputation monitoring
- AI training datasets
- Sentiment analysis (German-language reviews)
- Travel review aggregation
- Competitor benchmarking
- Tourism market intelligence
- Hospitality analytics dashboards
- LLM fine-tuning datasets
- Customer experience analysis

Especially useful for:

- DACH region (Germany, Austria, Switzerland) travel market research
- German hotel & wellness resort analysis
- Short-trip & getaway market intelligence
- OTA review intelligence
- Travel-tech companies

***

## 🚀 Integrations

Use with:

- Apify API
- Python
- Node.js
- Make.com
- Zapier
- Google Sheets
- BigQuery
- Snowflake
- AWS S3
- Airbyte
- LangChain

Export formats:

- JSON
- CSV
- Excel
- XML

***

## ⚡ Reliability & Performance

Built with:

- Smart pagination
- Automatic retries
- Session management
- Proxy support
- Configurable concurrency
- High-scale scraping architecture

Designed for stable production workloads and large-scale review extraction.

***

## 👨‍💻 About the Author

Created by **[knagymate](https://apify.com/knagymate)** — developer of multiple high-performance Apify review scrapers focused on:

- Reviews
- Travel platforms
- SEO datasets
- AI-ready structured data

Need:

- custom integrations
- enterprise scraping
- tailored outputs
- private Actors

👉 Feel free to reach out via Apify.

***

## ⭐ If this Actor helps you

Please leave a rating or review on Apify — it helps a lot and supports future improvements.

# Actor input Schema

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

Hotel detail page URLs on kurzurlaub.de 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 — kurzurlaub.de does not expose timezone information. Leave empty to scrape all available reviews.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html"
    }
  ],
  "maxReviewsPerHotel": 100,
  "cutoffDate": "2025-01-01"
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html"
        }
    ],
    "maxReviewsPerHotel": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("knagymate/kurzurlaub-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html" }],
    "maxReviewsPerHotel": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("knagymate/kurzurlaub-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 '{
  "startUrls": [
    {
      "url": "https://www.kurzurlaub.de/hotel/burgen_heideland/leipzig/hotel-pentahotel-leipzig/hotelbewertungen.html"
    }
  ],
  "maxReviewsPerHotel": 100
}' |
apify call knagymate/kurzurlaub-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=knagymate/kurzurlaub-reviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Kurzurlaub Reviews Scraper",
        "description": "Extract structured German hotel review data from Kurzurlaub.de. Get ratings, review titles, full comments, hotelier responses, category scores and hotel summaries. Perfect for travel SEO, reputation monitoring, sentiment analysis and AI training datasets.",
        "version": "0.0",
        "x-build-id": "kbI4g9MhLbmtMX1Ib"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/knagymate~kurzurlaub-reviews-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-knagymate-kurzurlaub-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/knagymate~kurzurlaub-reviews-scraper/runs": {
            "post": {
                "operationId": "runs-sync-knagymate-kurzurlaub-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/knagymate~kurzurlaub-reviews-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-knagymate-kurzurlaub-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": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Hotel URLs",
                        "type": "array",
                        "description": "Hotel detail page URLs on kurzurlaub.de to scrape reviews from.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxReviewsPerHotel": {
                        "title": "Maximum number of reviews per hotel",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of reviews to scrape per hotel",
                        "default": 100
                    },
                    "cutoffDate": {
                        "title": "Cutoff date",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                        "type": "string",
                        "description": "Only keep reviews on or after this date (YYYY-MM-DD). Interpreted as a local date, assumed to be in the Europe/Berlin timezone — kurzurlaub.de does not expose timezone information. Leave empty to scrape all available reviews."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```