# Rausgegangen — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover events happening in German cities by searching for concerts, festivals, and shows—filtering by location, date, or category to find exactly what you're looking for. Get detailed information about venues, artists, and ticket lotteries all in one place.

**Category:** Entertainment | **Website:** [rausgegangen.de/](https://rausgegangen.de/) | **Docs:** [parse.bot/marketplace/929a0377-543a-4ca8-8c5a-7ec3031a1c03/rausgegangen-de-api](https://parse.bot/marketplace/929a0377-543a-4ca8-8c5a-7ec3031a1c03/rausgegangen-de-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_detail

Fetch details for a specific artist including bio, social links, and upcoming events. Artist slugs can be obtained from search_global results of type 'Artist' or from /artists/ URL paths on the site. Returns 422 stale_input if the artist slug is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_slug` | string | Yes | Artist slug from the /artists/ URL path (e.g. 'zoe-wees'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_artist_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_slug":"<string>"}'
```

### get_categories_list

Retrieve available event categories with German-language slugs. Use the value field as the category parameter in search_events.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_categories_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cities_list

Retrieve the list of all supported German cities with their URL slugs. Use these slugs as the city parameter in other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_cities_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_event_detail

Fetch full details for a single event by its slug. Event slugs can be obtained from listing endpoints or search results (e.g. 'cosmic-jazz-30'). Returns 422 stale_input if the event slug is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_slug` | string | Yes | Event slug from the URL path (e.g. 'cosmic-jazz-30', 'espresso-konzert-172'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_slug":"<string>"}'
```

### get_events_by_city

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug as used on rausgegangen.de. Use German-style slugs from get_cities_list (e.g. 'berlin', 'cologne', 'muenchen', 'hamburg', 'frankfurt'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_events_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>"}'
```

### get_events_by_date

Fetch events for a specific city filtered by a single date. Returns events happening on that date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug as used on rausgegangen.de (e.g. 'berlin', 'cologne', 'frankfurt'). |
| `date` | string | Yes | Date in YYYY-MM-DD format (e.g. '2026-06-15'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_events_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","date":"<string>"}'
```

### get_location_detail

Fetch details for a specific location/venue including description, address, and upcoming events. Location slugs can be obtained from search_global results of type 'Location' or from the /locations/ URL paths on the site. Returns 422 stale_input if the location slug is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location_slug` | string | Yes | Location slug from the /locations/ URL path (e.g. 'waldbuhne-berlin', 'jazz-point'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_location_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_slug":"<string>"}'
```

### get_lotteries

Fetch lottery events (ticket giveaways) for a city. These are special promotional events where users can win free tickets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug (e.g. 'berlin', 'cologne', 'frankfurt'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/get_lotteries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### search_events

Advanced event search with filters including query keyword, category, date range, and accessibility features. All filters are optional. Category values use German slugs from get_categories_list (e.g. 'konzerte-und-musik', 'party', 'ausstellung').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `accessibility` | string | No | Accessibility feature slug to filter events. Values include: 'wheelchair-accessible', 'accessible-toilet', 'mobility-impaired-access', 'audio-description', 'touch-tour', 'german-sign-language', 'captions-surtitles', 'hearing-loop-telecoil', 'wifi-audio-streaming', 'easy-language', 'neurodiversity-friendly', 'quiet-room', 'on-site-assistance', 'companion-free-ticket', 'assistance-dogs-welcome', 'relaxed-performance', 'content-advisory'. Multiple values can be comma-separated. |
| `category` | string | No | Category slug from get_categories_list (e.g. 'konzerte-und-musik', 'party', 'ausstellung', 'theater', 'sport', 'film'). |
| `city` | string | No | City slug (e.g. 'berlin', 'cologne', 'hamburg'). |
| `end_date` | string | No | End date filter in YYYY-MM-DD format. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter events. |
| `start_date` | string | No | Start date filter in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accessibility":"<string>","category":"<string>","city":"<string>","end_date":"<string>","page":"<integer>","query":"<string>","start_date":"<string>"}'
```

### search_global

Global search across events, locations, artists, and organizers. Returns mixed result types (Subevent, Location, Artist, Organizer, Tag) with a total count. City parameter provides geographic context but results may be national.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug for geographic context (e.g. 'berlin', 'cologne'). |
| `query` | string | Yes | Search query string (e.g. 'jazz', 'comedy'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rausgegangen-de-api-929a0377/search_global \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","query":"<string>"}'
```