rausgegangen.de APIrausgegangen.de ↗
Access events, venues, artists, and ticket lotteries across German cities via the rausgegangen.de API. Filter by city, date, category, and keyword.
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'
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": "",
"date": "PICK OF THE DAY",
"price": "8,00 to 19,00 €",
"title": "22. JAPANMARKT BERLIN - KIRSCHBLÜTENFEST",
"venue": "Festsaal Kreuzberg",
"category": "Festivals",
"image_url": "https://imageflow.rausgegangen.de/url/https%3A//s3.eu-central-1.amazonaws.com/rausgegangen/3deih1KT0O1Kb5wi5muA_japanmarkt-berlinfacebook-post1200x630px03-05-2026kirschblutekorr2.jpg?width=450&height=337&mode=crop"
}
]
},
"status": "success"
}
}About the rausgegangen.de 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.
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.
- 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 | 250 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.