# Kurzurlaub.de Scraper — German Short-Break Hotel Deals (`studio-amba/kurzurlaub-scraper`) Actor

Scrape short-break hotel package deals from kurzurlaub.de: deal price, duration, occupancy, hotel address, star rating, aggregate rating, and amenities. Covers German states and cities. No login or cookies required.

- **URL**: https://apify.com/studio-amba/kurzurlaub-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Travel
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Kurzurlaub.de Scraper — German Short-Break Hotel Deals (No Login)

Scrape short-break hotel package deals from kurzurlaub.de, one of Germany's largest short-break/weekend-trip booking platforms operated by Super Urlaub GmbH — deal price, duration, occupancy, board basis, and the hotel's address, star rating, and aggregate review score.

### What is Kurzurlaub.de?

Kurzurlaub.de specializes in short "Kurzurlaub" (short-break) hotel packages across Germany — 2-5 night arrangements bundling accommodation with extras like spa access, half-board, or local attraction tickets. It covers thousands of hotels across every German state, from city breaks in Hamburg or München to wellness stays in the Allgäu.

- **Rate monitoring** — Track how a hotel or region prices its short-break packages over time
- **Market research** — Compare package prices, durations, and board types across German destinations
- **Competitive benchmarking** — See how independent hotels and regional chains price against each other in the same state or city
- **Lead generation** — Build a directory of bookable hotels by region with contact-relevant address and rating data

### What data does Kurzurlaub.de Scraper extract?

- Deal title, total package price (EUR), duration in nights, and adult/child occupancy
- Board-basis code (e.g. `VM` = Vollpension/full board) and the site's own category tags (e.g. "Wellnessurlaub", "Familienurlaub")
- Hotel name, street address, postal code, city, region, state (Bundesland), and GPS coordinates
- Official star rating and the hotel's aggregate review rating (with the scale documented — see note below)
- Amenities list (payment methods, family features, accessibility, wellness facilities, ...)
- Hotel's general price range and primary image URL

### How to scrape Kurzurlaub.de data

| Field | Type | Description |
|-------|------|-------------|
| `location` | String (optional) | A German Bundesland (e.g. `"Bayern"`, `"Hamburg"`, `"Sachsen"`) or city name (e.g. `"München"`, `"Köln"`). Defaults to `"Bayern"`. |
| `maxResults` | Integer | Maximum deals to return (default: 30) |
| `proxyConfiguration` | Object | Apify proxy settings. RESIDENTIAL (Germany) recommended, though this site has no anti-bot protection. |

**How location resolution works:** only 10 of the 16 German Bundesländer have a dedicated state-level browse page on kurzurlaub.de (verified live 2026-08-05) — Bayern, Berlin, Brandenburg, Bremen, Hamburg, Hessen, Niedersachsen, Saarland, Sachsen, and Thüringen. Baden-Württemberg, Mecklenburg-Vorpommern, Nordrhein-Westfalen, Rheinland-Pfalz, Sachsen-Anhalt, and Schleswig-Holstein return 404 on that URL pattern — a real gap in the site's own navigation, not a bug in this actor. Any other `location` value is resolved as a city-level page instead (`ort-kurzurlaub-{slug}.html`), which works for most German cities and towns.

**How it works internally:** kurzurlaub.de disallows `/suche.html` (its search form) in robots.txt and has no visible pagination or AJAX search endpoint on its browse pages, so this actor walks the site's own browse hierarchy instead. A state page lists ~10 recommended deals directly plus links to its child city pages; the actor visits child city pages (up to 8) to collect enough unique deals to satisfy `maxResults`, deduplicating by the site's internal deal ID. Each deal is then fetched from its own detail page, where all data is embedded as structured JSON — a `Hotel` JSON-LD block, a `BreadcrumbList` JSON-LD block for the location hierarchy, and a `window.itemPool` JavaScript object carrying the actual package fields (price, duration, occupancy). No anti-bot protection was found on this site (plain HTTP requests return clean 200 responses on every URL pattern tested), so no Bright Data or browser rendering is required.

### Output

Each result is one hotel deal:

| Field | Type | Example |
|-------|------|---------|
| `dealId` | String | `"201634"` |
| `dealTitle` | String | `"Zu kurz aber schön! im Allgäu"` |
| `url` | String | Full deal detail page URL |
| `price` | Number | `155` |
| `currency` | String | `"EUR"` |
| `duration` | Integer | `1` (nights) |
| `numAdults` | Integer | `2` |
| `numChildren` | Integer | `0` |
| `contractType` | String | `"VM"` (Vollpension/full board) |
| `categoryTags` | Array | `["arrangement", "Aktivurlaub", "Singlereisen", "Wochenendreisen", "Wellnessurlaub"]` |
| `hotelName` | String | `"Best Western Plus Hotel Füssen"` |
| `starRating` | Integer | `4` |
| `streetAddress` | String | `"Augsburger Strasse 18"` |
| `postalCode` | String | `"87629"` |
| `city` | String | `"Füssen"` |
| `region` | String | `"Allgäu"` |
| `state` | String | `"Bayern"` |
| `country` | String | `"Deutschland"` |
| `latitude` / `longitude` | Number | `47.57194946` / `10.70186913` |
| `priceRangeRaw` | String | `"49,00 EUR - 312,50 EUR"` |
| `priceRangeMin` / `priceRangeMax` | Number | `49` / `312.5` |
| `aggregateRatingValue` | Number | `5.4` |
| `aggregateRatingCount` | Integer | `842` |
| `aggregateRatingWorst` / `aggregateRatingBest` | Number | `1` / `6` |
| `aggregateRatingScale` | String | `"1-6"` |
| `amenities` | Array | `["American Express", "Frühstück", "Fitness-Center", ...]` |
| `imageUrl` | String | Primary hotel image URL |
| `scrapedAt` | String | ISO 8601 timestamp |

**Important — the rating scale is not the usual 1-5.** kurzurlaub.de uses a German hotel-review-portal style scale where `bestRating` is `6`, not `5` or `10`. `aggregateRatingScale` documents the exact scale for every record (`"1-6"`) — never assume a standard 5-star normalization when consuming this field.

### Example output

```json
{
    "dealId": "201634",
    "dealTitle": "Zu kurz aber schön! im Allgäu",
    "url": "https://www.kurzurlaub.de/angebote/201634-zu-kurz-aber-schoen-im-allgaeu-best-western-plus-hotel-fuessen.html",
    "scrapedAt": "2026-08-05T20:22:28.597Z",
    "price": 155,
    "currency": "EUR",
    "duration": 1,
    "numAdults": 2,
    "numChildren": 0,
    "contractType": "VM",
    "categoryTags": ["arrangement", "Aktivurlaub", "Singlereisen", "Wochenendreisen", "Wellnessurlaub"],
    "hotelName": "Best Western Plus Hotel Füssen",
    "starRating": 4,
    "streetAddress": "Augsburger Strasse 18",
    "postalCode": "87629",
    "city": "Füssen",
    "region": "Allgäu",
    "state": "Bayern",
    "country": "Deutschland",
    "latitude": 47.57194946,
    "longitude": 10.70186913,
    "priceRangeRaw": "49,00 EUR - 312,50 EUR",
    "priceRangeMin": 49,
    "priceRangeMax": 312.5,
    "aggregateRatingValue": 5.4,
    "aggregateRatingCount": 842,
    "aggregateRatingWorst": 1,
    "aggregateRatingBest": 6,
    "aggregateRatingScale": "1-6",
    "amenities": ["American Express", "EC - Electronic Cash / Maestro", "Frühstück", "Fitness-Center", "Bar"],
    "imageUrl": "https://www.kurzurlaub.de/images/object/006972/hotel/8516257-lobby-original.jpg",
    "searchLocation": "Bayern"
}
```

### Cost estimate

Priced per result on Apify's Pay-Per-Event model (see the actor's pricing tab for current numbers). This is a plain HTTP scrape with no anti-bot bypass required, so cost per run stays low — roughly one request per browse page visited plus one request per deal returned. Usage cost only settles once a run reports SUCCEEDED — reading the dataset mid-run will undercount what the run actually costs.

### Limitations

- `location` resolves against kurzurlaub.de's own browse hierarchy — 6 of the 16 German states have no dedicated state-level page on the site itself (see "How location resolution works" above) and must be queried by city name instead.
- `aggregateRatingValue` uses kurzurlaub.de's 1-6 scale, not a standard 1-5 or 1-10 scale — see the note under Output above.
- Data is scraped from the public website and may change if kurzurlaub.de updates its page structure.
- Respect kurzurlaub.de's terms of service and use responsibly.

### Frequently asked questions

**Do I need a Bright Data key or residential proxy?**
No. kurzurlaub.de has no anti-bot protection (verified live, 2026-08-05) — plain Apify proxies work fine.

**Can I scrape a specific city instead of a whole state?**
Yes — pass the city name as `location` (e.g. `"München"`, `"Dresden"`, `"Oberstdorf"`). Most German towns and cities resolve to their own browse page.

**Why do some German states return fewer results than others?**
State page coverage varies by how much inventory kurzurlaub.de carries there. Bayern (Bavaria) has the most cities and deals; smaller states may return fewer unique deals even at a high `maxResults`.

**What does `contractType` mean?**
The site's internal board-basis code — most commonly `VM` (Vollpension/full board). Other codes reflect the specific meal plan bundled into that package.

### Related scrapers

- [HolidayCheck.de Scraper](https://apify.com/studio-amba/holidaycheck-de-scraper) — Hotel reviews and ratings for the same DACH travel market.
- [TUI Scraper](https://apify.com/studio-amba/tui-scraper) — Package holiday listings.
- [GetYourGuide Scraper](https://apify.com/studio-amba/getyourguide-scraper) — Tours and activities.

### Disclaimer

This actor collects only publicly available deal and hotel data from kurzurlaub.de for legitimate use such as market research and rate monitoring. Respect kurzurlaub.de's terms of service and applicable data-protection law when using the output.

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API — maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email <hello@studioamba.dev> for a free data sample. We maintain 300+ European web scrapers and answer within one business day.

# Actor input Schema

## `location` (type: `string`):

A German Bundesland (e.g. 'Bayern', 'Hamburg', 'Sachsen') or city name (e.g. 'München', 'Köln', 'Dresden') to scrape hotel deals for. Only 10 of the 16 states have a dedicated state-level page on this site (Bayern, Berlin, Brandenburg, Bremen, Hamburg, Hessen, Niedersachsen, Saarland, Sachsen, Thüringen) — other inputs are resolved as a city page instead. Defaults to Bayern.

## `maxResults` (type: `integer`):

Maximum number of hotel deals to return. The actor walks the state's browse page and, if needed, its child city pages to collect enough unique deals.

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

Apify proxy configuration. RESIDENTIAL (Germany) is the default and recommended setting.

## Actor input object example

```json
{
  "location": "Bayern",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}
```

# 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 = {
    "location": "Bayern",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "DE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/kurzurlaub-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 = {
    "location": "Bayern",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/kurzurlaub-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 '{
  "location": "Bayern",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}' |
apify call studio-amba/kurzurlaub-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/bbbkjCQbsMc82gZbR/builds/d4eihj5OAD1mi2279/openapi.json