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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ticketswap/`
**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

### 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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/browse-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/get-artist-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/get-event-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/get-listing-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/get-rising-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/get-trending-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ticketswap/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.