# Rausgegangen — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-artist-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-categories-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-cities-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-event-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-events-by-city \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-events-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-location-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/get-lotteries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/rausgegangen/search-global \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.