# Vividseats — 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 for events, venues, and performers, then browse current ticket listings with detailed seat information and pricing to find the perfect show. Analyze historical sales data to track ticket price trends and make informed purchasing decisions.

**Category:** Entertainment | **Website:** [vividseats.com/](https://vividseats.com/) | **Docs:** [parse.bot/marketplace/6cce81ee-e741-4fab-971c-1760b903e94b/vividseats-com-api](https://parse.bot/marketplace/6cce81ee-e741-4fab-971c-1760b903e94b/vividseats-com-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-vividseats-com-api-6cce81ee/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_details

Get full details for a specific ticket listing, including seller (broker) ID, delivery options, seat numbers, service charges, and valid purchase quantities. Returns listing fields at root level with nested production and deliveryOptions array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | Listing ID from get_listings tickets[*].i (e.g., VB15927078778) |
| `production_id` | string | Yes | Production (Event) ID from list_events items[*].id |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vividseats-com-api-6cce81ee/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>","production_id":"<string>"}'
```

### get_listings

Get current ticket listings for a specific event. Returns global venue/event stats and an array of available tickets with pricing, section, row, and deal scores. The global array contains one object with event-level aggregates. Tickets are sorted by price ascending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `production_id` | string | Yes | Production (Event) ID from list_events items[*].id |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vividseats-com-api-6cce81ee/get_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"production_id":"<string>"}'
```

### get_sold_listings

Get historical/recently sold listings for an event to analyze pricing trends. Uses cursor-based pagination. May return empty listings for future events with no sales history; use nextCursor to paginate through results for events with history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Cursor for pagination (from nextCursor in a previous response) |
| `production_id` | string | Yes | Production (Event) ID from list_events items[*].id |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vividseats-com-api-6cce81ee/get_sold_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","production_id":"<string>"}'
```

### list_events

List upcoming events (productions) with optional filters for query, performer, venue, category, and date. Returns paginated results sorted by rank. Each event includes venue details, pricing summary (min/avg/median), listing/ticket counts, and performer info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Filter by category ID (from search_suggestions performers[*].category.id) |
| `page` | integer | No | Page number for pagination (1-based) |
| `page_size` | integer | No | Results per page |
| `performer_id` | string | No | Filter by performer ID (from search_suggestions performers[*].id) |
| `query` | string | No | Search term for events |
| `start_date` | string | No | Filter events starting from this date in ISO format YYYY-MM-DD |
| `venue_id` | string | No | Filter by venue ID (from search_suggestions venues[*].id) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vividseats-com-api-6cce81ee/list_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","page_size":"<integer>","performer_id":"<string>","query":"<string>","start_date":"<string>","venue_id":"<string>"}'
```

### search_suggestions

Search for performers, venues, or productions (events) by name. Returns matching results across all three categories. Use performer/venue IDs from these results to filter list_events. Productions returned here include listing and ticket counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term (e.g., performer name, venue name, event name) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vividseats-com-api-6cce81ee/search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```