Rausgegangen APIrausgegangen.de ↗
Access events, venues, artists, and ticket lotteries across German cities via the rausgegangen.de API. Filter by city, date, category, and keyword.
What is the Rausgegangen API?
The rausgegangen.de API exposes 10 endpoints covering event listings, venue details, artist profiles, and ticket lotteries across German cities. Use get_events_by_city to pull paginated event arrays with title, venue, date, price, image_url, and category, or use search_events to filter by keyword, category slug, and date range. Each event object links back to the source page and, where available, a direct ticket URL.
curl -X GET 'https://api.parse.bot/scraper/6a2f27a8-248a-4bbb-bbbe-b184249c16db/get_events_by_city?city=berlin&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace rausgegangen-de-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Rausgegangen SDK — discover events across German cities."""
from parse_apis.rausgegangen_events_api import Rausgegangen, NotFound
client = Rausgegangen()
# List available cities and categories for reference.
for city in client.cities.list(limit=5):
print(city.name, city.slug)
# Search for party events in Berlin with pagination auto-handled.
for event in client.events.search(city="berlin", category="party", limit=3):
print(event.title, event.venue, event.price)
# Global search across events, locations, artists — take the first result.
result = client.events.search_global(query="jazz", limit=1).first()
if result:
print(result.title, result.type, result.category)
# Fetch events happening on a specific date.
for event in client.events.by_date(date="2026-06-15", city="berlin", limit=3):
print(event.title, event.date, event.category)
# Browse lottery events (ticket giveaways) in Berlin; handle not-found gracefully.
try:
for lottery in client.events.lotteries(city="berlin", limit=3):
print(lottery.title, lottery.date, lottery.venue)
except NotFound as exc:
print(f"Not found: {exc}")
print("exercised: cities.list / events.search / events.search_global / events.by_date / events.lotteries")
Fetch paginated event listings for a specific city. City slugs use German spelling (e.g. 'muenchen' not 'munich'). Use get_cities_list to discover valid city slugs. Returns upstream 404 for unrecognized city slugs.
| Param | Type | Description |
|---|---|---|
| city | string | City slug as used on rausgegangen.de. Use German-style slugs from get_cities_list (e.g. 'berlin', 'cologne', 'muenchen', 'hamburg', 'frankfurt'). |
| page | integer | Page number for pagination. |
{
"type": "object",
"fields": {
"city": "city slug used in the request",
"page": "page number as string",
"events": "array of event objects with title, url, venue, date, price, image_url, and category"
},
"sample": {
"data": {
"city": "berlin",
"page": "1",
"events": [
{
"url": "https://rausgegangen.de/en/events/paradise-must-be-nice-2026-0/",
"date": "Today, 11. Jun | 19:30",
"price": "15-60 EUR + VVK",
"title": "Paradise Must Be Nice 2026",
"venue": "KulturRaum Zwingli-Kirche e.V.",
"category": "Concerts & Music",
"image_url": "https://imageflow.rausgegangen.de/url/https%3A//s3.eu-central-1.amazonaws.com/rausgegangen/gEaXM8BPQE2Isr3QCfOD_pmbn-eventfrog-header-784x479-black.png?width=450&height=253&mode=crop"
}
]
},
"status": "success"
}
}About the Rausgegangen API
Event Discovery and Search
get_events_by_city returns paginated event listings for any supported German city using German-style slugs (e.g. muenchen, berlin, koeln). Each event object includes title, url, venue, date, price, image_url, and category. To filter by a single date, use get_events_by_date with the date parameter in YYYY-MM-DD format. For more granular control, search_events accepts a query keyword, a category slug (e.g. konzerte-und-musik, party, ausstellung), start_date, and end_date — all optional and combinable. Valid city slugs and category slugs can be enumerated upfront via get_cities_list and get_categories_list respectively.
Event and Venue Detail
get_event_detail takes an event slug (obtainable from listing or search results) and returns the full record: title, description, start_date, end_date, location_name, organizer_name, price_info, ticket_url, image_url, and a more_shows array listing additional show dates with individual buy_url fields. get_location_detail retrieves venue metadata including a structured address object (streetAddress, addressLocality, postalCode, addressCountry), description, image_url, and an upcoming_events array. Location slugs can be sourced from search_global results of type Location.
Artists and Global Search
get_artist_detail returns an artist's name, bio, image_url, a links array of external social and website URLs, and their upcoming_events. search_global accepts a free-text query and returns mixed result types — Subevent, Location, Artist, Organizer, and Tag — along with a numFound total count. This endpoint is useful for resolving slugs when you know a name but not the URL path.
Ticket Lotteries
get_lotteries returns city-scoped promotional ticket giveaway events. The response shape matches the standard event object (title, url, venue, date, price, image_url, category), making it straightforward to render alongside regular event listings. This data is specific to rausgegangen.de's lottery feature and is not exposed through the generic event listing endpoints.
The Rausgegangen API is a managed, monitored endpoint for rausgegangen.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when rausgegangen.de changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official rausgegangen.de API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a city-specific event calendar app for Berlin, Hamburg, or Munich using get_events_by_city with pagination
- Send weekly digest emails of concerts and club nights by filtering search_events with category 'konzerte-und-musik' and a date range
- Display venue profiles with address, description, and upcoming events using get_location_detail
- Aggregate artist tour schedules in Germany by querying get_artist_detail for bio, links, and upcoming_events
- Surface free ticket giveaway opportunities to users via get_lotteries filtered by city
- Power a cross-city event search widget using search_global to resolve artists, venues, and event names simultaneously
- Monitor new events in a category by polling search_events with a fixed category slug and advancing start_date daily
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.