# Ticketswap — 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.

> Search and discover events on TicketSwap, browse trending and rising events, and access detailed information about artists, listings, and specific events. Find tickets for concerts and live events with real-time data about what's popular and gaining momentum.

**Category:** Entertainment | **Website:** [ticketswap.nl/](https://ticketswap.nl/) | **Docs:** [parse.bot/marketplace/0d441026-a4e1-4f2a-91c3-5b3ae863baed/ticketswap-nl-api](https://parse.bot/marketplace/0d441026-a4e1-4f2a-91c3-5b3ae863baed/ticketswap-nl-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-ticketswap-nl-api-0d441026/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_events

Browse events by city or category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | No | Category slug (e.g., 'concerts') |
| `city_slug` | string | No | City slug (e.g., 'amsterdam/3') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/browse_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","city_slug":"<string>"}'
```

### get_artist_details

Get details for a specific artist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_slug` | string | Yes | Artist slug (e.g., 'bruno-mars-tickets-NU8u3K2etCGXszzYAm9ate') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/get_artist_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_slug":"<string>"}'
```

### get_event_details

Get detailed information for a specific event by slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug (e.g., 'harry-styles-new-york-city-madison-square-garden-2026-10-30-CXZjdTKRAfzhWuApfT5pi') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_listing_details

Get detailed information for a specific ticket listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hash` | string | Yes | Listing hash (from listing URL) |
| `listing_id` | string | Yes | Numeric listing ID (from listing URL) |
| `slug` | string | Yes | Listing event slug (from listing URL) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hash":"<string>","listing_id":"<string>","slug":"<string>"}'
```

### get_rising_events

Get rising/popular events for a given country, optionally filtered by category. Returns up to 9 events with detailed information including available ticket counts, venue, artists, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Event category filter. Accepted values: CONCERTS, FESTIVALS, SPORTS, CLUBS, THEATRE, COMEDY, AMUSEMENT_PARK |
| `country_code` | string | No | ISO country code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/get_rising_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","country_code":"<string>"}'
```

### get_trending_events

Get top 5 trending events for a given country. Returns events that are currently popular based on TicketSwap activity. Each result includes event name, date, location, city, category, and country.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | ISO country code to get trending events for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/get_trending_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>"}'
```

### search_events

Search for events, artists, venues, cities, and organizers by keyword on TicketSwap. Returns up to 20 results per page with pagination support via cursor. Results include event details like name, date, location, city, category, and country.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'coldplay', 'amsterdam', 'harry styles') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ticketswap-nl-api-0d441026/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```