# Hochzeitslocation.de Scraper — German Wedding Venues (`studio-amba/hochzeitslocation-scraper`) Actor
Scrape wedding venue listings from Hochzeitslocation.de — Germany's largest wedding venue directory run by Confetti GmbH. Get venue names, full addresses, GPS coordinates, capacity, descriptions, and photos across every German city.
- **URL**: https://apify.com/studio-amba/hochzeitslocation-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Business, Lead generation
- **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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
## Hochzeitslocation.de Scraper — German Wedding Venue Directory Data
Scrape wedding venue listings from [Hochzeitslocation.de](https://hochzeitslocation.de), Germany's largest wedding venue directory, run by Confetti GmbH. Get venue names, full postal addresses, GPS coordinates, guest capacity, long-form descriptions, and photos for castles, event locations, hotels, restaurants, and ships across every German city and region.
### What is Hochzeitslocation.de Scraper?
Hochzeitslocation.de lists thousands of wedding venues across Germany, organized by federal state and city, with a detail page for every venue: eventlocations, castles (Schlösser), hotels, restaurants, and even wedding boats. Each detail page carries full `LocalBusiness` schema.org markup — street address, postal code, city, region, GPS coordinates, and a long editorial description that usually includes the guest capacity and square footage.
This actor scrapes venue detail pages by walking city listing pages, following the site's own pagination, and parsing the JSON-LD structured data directly (with HTML fallbacks where JSON-LD is thin). What people build with it:
- **Wedding vendor market research** — wedding planners, florists, and caterers map venue density and price positioning by German city before pitching partnerships.
- **Venue sourcing tools** — wedding planning platforms and marketplaces build their own searchable venue databases without maintaining a directory from scratch.
- **Lead generation** — B2B services selling to wedding venues (insurance, POS systems, event software) build outreach lists filtered by city, capacity, or venue type.
- **Local market mapping** — real estate and events researchers plot event-capable venues by city and region using the GPS coordinates.
- **Competitive intelligence** — venue owners benchmark their own listing (description quality, capacity, photos) against competitors in the same city.
### What data does Hochzeitslocation.de Scraper extract?
Each venue record includes:
- **Name** — the wedding venue name
- **Address** — street address, postal code, city, and federal state (region)
- **Coordinates** — latitude and longitude for mapping
- **Category** — venue type as listed on the site (Eventlocation, Schlösser, Hotel, Restaurant, Gaststätte, Schiff)
- **Description** — the venue's editorial profile text, usually including ambience and capacity details
- **Guest capacity** — approximate guest number extracted from the description text, when stated
- **Price range** — price category indicator, where the venue has set one
- **Website** — the venue's own external website, where published
- **Image** — the venue's main listing photo
- **URL** — the source detail page
### How to scrape hochzeitslocation.de data
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `startUrls` | Array | No | City or region listing pages, e.g. `https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/` |
| `searchQuery` | String | No | German city name: `"berlin"`, `"hamburg"`, `"muenchen"` |
| `maxResults` | Integer | No | Maximum venues to return (default: 100, max: 50,000) |
| `proxyConfiguration` | Object | No | Proxy settings (recommended for 1,000+ venues) |
**Tips:**
- Start with a specific city for focused results: `searchQuery: "berlin"` or a `startUrls` entry pointing straight at a city listing page.
- The site has no anti-bot protection and returns clean HTML on a plain GET, so runs are fast and cheap.
- Pagination is handled automatically via the site's own `` markup — no need to guess page counts.
- For a nationwide database, run once per major city (Berlin, Hamburg, München, Köln, Frankfurt...) with a high `maxResults`.
### Output
```json
{
"name": "Umweltforum in Berlin (Berlin)",
"address": "Pufendorfstraße 11",
"city": "Berlin",
"postalCode": "10249",
"region": "Berlin",
"category": "Eventlocation",
"latitude": 52.5210383,
"longitude": 13.4380993,
"description": "Umweltforum – Ihre nachhaltige Hochzeitslocation in Berlin. Das Umweltforum in Berlin bietet eine einzigartige und nachhaltige Kulisse für Paare...",
"capacityGuests": 300,
"imageUrl": "https://hochzeitslocation.de/wp-content/uploads/2025/02/hochzeit-in-einer-eventlocation.jpg",
"url": "https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/berlin-1/eventlocation/umweltforum-in-berlin-berlin/",
"scrapedAt": "2026-07-23T14:19:07.688Z"
}
````
### How much does it cost?
Hochzeitslocation.de Scraper uses CheerioCrawler (no browser needed):
| Volume | Estimated CUs | Estimated Cost |
|--------|--------------|----------------|
| 100 venues | ~0.03 | ~$0.015 |
| 500 venues | ~0.12 | ~$0.06 |
| 1,000 venues | ~0.25 | ~$0.13 |
| 5,000 venues | ~1.10 | ~$0.55 |
The actor first collects venue URLs from listing pages, then visits each detail page. Costs scale linearly.
### Can I integrate?
Push German wedding venue data into your tools:
- **Google Sheets** — build a sortable venue database filtered by city, category, or capacity
- **Google Maps / Mapbox** — plot venues on an interactive map using coordinates
- **CRM / outreach tools** — feed venue lists into a B2B sales pipeline for vendors selling into the wedding industry
- **Zapier / Make** — trigger workflows when new venues appear in a target city
- **PostgreSQL / MongoDB** — power a searchable venue-finder app
- **Power BI / Tableau** — visualise venue density and capacity distribution by German region
### Can I use it as an API?
Yes. Build German wedding venue intelligence into your product:
**Python:**
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("studio-amba/hochzeitslocation-scraper").call(run_input={
"searchQuery": "berlin",
"maxResults": 200,
})
for venue in client.dataset(run["defaultDatasetId"]).iterate_items():
cap = f" ({venue['capacityGuests']} Gäste)" if venue.get("capacityGuests") else ""
print(f"{venue['name']}{cap} — {venue['city']}")
```
**JavaScript:**
```javascript
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "YOUR_API_TOKEN" });
const run = await client.actor("studio-amba/hochzeitslocation-scraper").call({
searchQuery: "hamburg",
maxResults: 200,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
const withWebsite = items.filter((v) => v.website);
console.log(`${withWebsite.length}/${items.length} Hamburg venues have a listed website`);
```
### FAQ
**Does this cover all of Germany?**
Yes. Hochzeitslocation.de organizes venues by federal state and city across the whole country. Run the actor once per city or region to build a nationwide dataset.
**Is phone number always available?**
No. Hochzeitslocation.de rarely publishes a venue's direct phone number on the public listing page (most venues route contact through the site's own inquiry form) — the `phone` field is included in the schema but will usually be empty. `website` is more commonly populated, straight from the venue's own structured data.
**Are ratings and review counts available?**
Only when a venue has received on-platform reviews, which is uncommon on this directory today. The `rating` and `reviewCount` fields are included for forward compatibility but will typically be empty.
**How is `capacityGuests` calculated?**
It's parsed from the German-language description text (phrases like "bis zu 300 Gästen"), when the venue operator has included a guest number. Not every listing states an exact capacity.
**Is this the same as Hochzeitsportal24.de?**
No. Hochzeitslocation.de is run by Confetti GmbH and is a distinct directory with its own catalogue and URL structure — it is not the same company or dataset as Hochzeitsportal24.de.
### Limitations
- Not every listing has a phone number, external website, price range, or review data — this directory relies on venue operators to fill in optional fields.
- Descriptions vary in length and quality; smaller or unclaimed listings may have a short or empty profile text.
- `capacityGuests` is a best-effort extraction from free text, not a structured field on the site — treat it as approximate.
- Large nationwide scrapes (all German cities) benefit from a proxy configuration, though the site has no bot-detection in place today.
### Related German and directory scrapers
- [Resto.be Scraper](https://apify.com/studio-amba/resto-scraper) — venue/restaurant directory scraping with the same JSON-LD LocalBusiness pattern
- [ImmoScout24 Scraper](https://apify.com/studio-amba/immoscout24-scraper) — German real estate listings
- [Kleinanzeigen Scraper](https://apify.com/studio-amba/kleinanzeigen-scraper) — German classifieds marketplace
- [Doctoralia ES Scraper](https://apify.com/studio-amba/doctoralia-es-scraper) — local business directory scraping, same output contract
### Your feedback
Want venue reviews, contact-form email harvesting, or a specific city bundled by default? Open an issue on GitHub or contact us through the Apify platform. We prioritise improvements based on user demand.
# Actor input Schema
## `startUrls` (type: `array`):
Hochzeitslocation.de city or region listing pages to scrape. Example: https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/ or https://hochzeitslocation.de/hochzeitslocations/deutschland/hamburg/
## `searchQuery` (type: `string`):
German city or region name (e.g., 'berlin', 'hamburg', 'muenchen'). Used to build a listing URL if no startUrls are provided.
## `maxResults` (type: `integer`):
Maximum number of wedding venues to return.
## `proxyConfiguration` (type: `object`):
Proxy settings. Recommended for scraping more than 1,000 venues.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/"
}
],
"maxResults": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "DE"
}
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
{
"url": "https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/"
}
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "DE"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/hochzeitslocation-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"startUrls": [{ "url": "https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/" }],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "DE",
},
}
# Run the Actor and wait for it to finish
run = client.actor("studio-amba/hochzeitslocation-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://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/"
}
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "DE"
}
}' |
apify call studio-amba/hochzeitslocation-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=studio-amba/hochzeitslocation-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Hochzeitslocation.de Scraper — German Wedding Venues",
"description": "Scrape wedding venue listings from Hochzeitslocation.de — Germany's largest wedding venue directory run by Confetti GmbH. Get venue names, full addresses, GPS coordinates, capacity, descriptions, and photos across every German city.",
"version": "0.1",
"x-build-id": "Bev1AfurnXz5Lc1AF"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/studio-amba~hochzeitslocation-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-studio-amba-hochzeitslocation-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/studio-amba~hochzeitslocation-scraper/runs": {
"post": {
"operationId": "runs-sync-studio-amba-hochzeitslocation-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/studio-amba~hochzeitslocation-scraper/run-sync": {
"post": {
"operationId": "run-sync-studio-amba-hochzeitslocation-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": "City or Region Listing URLs",
"type": "array",
"description": "Hochzeitslocation.de city or region listing pages to scrape. Example: https://hochzeitslocation.de/hochzeitslocations/deutschland/berlin/ or https://hochzeitslocation.de/hochzeitslocations/deutschland/hamburg/",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"searchQuery": {
"title": "City Name",
"type": "string",
"description": "German city or region name (e.g., 'berlin', 'hamburg', 'muenchen'). Used to build a listing URL if no startUrls are provided."
},
"maxResults": {
"title": "Max Results",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Maximum number of wedding venues to return.",
"default": 100
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings. Recommended for scraping more than 1,000 venues."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```