# Viagogo — 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 and browse tickets across Viagogo's catalog, discovering performer schedules, ticket listings, and categories all in one place. Get detailed information about available tickets and events to find exactly what you're looking for.

**Category:** Entertainment | **Website:** [viagogo.com/](https://viagogo.com/) | **Docs:** [parse.bot/marketplace/d987e0c9-74af-4fb5-b783-051fdcd883b1/viagogo-com-api](https://parse.bot/marketplace/d987e0c9-74af-4fb5-b783-051fdcd883b1/viagogo-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-viagogo-com-api-d987e0c9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_listings

Browse subcategories within a top-level category on Viagogo. Returns the category's subcategories and all top-level categories available on the site. Useful for discovering the category tree before searching for specific performers or events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Category page URL path (e.g., '/Sports-Tickets/C/2', '/Concert-Tickets/C/3', '/Theater-Tickets/C/1'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-viagogo-com-api-d987e0c9/get_category_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_event_ticket_listings

Retrieve available ticket listings for a specific event. Returns tickets with section, row, pricing, quantity, deal scores, and listing notes. Event URLs are obtained from get_performer_events results by stripping the 'https://www.viagogo.com' prefix. Event IDs may expire over time as events pass.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Event page URL path (e.g., '/Concert-Tickets/Country-and-Folk-Music/Luke-Bryan-Tickets/E-160342652'). Obtain from get_performer_events results by removing the 'https://www.viagogo.com' prefix. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-viagogo-com-api-d987e0c9/get_event_ticket_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_performer_events

Retrieve all upcoming events for a specific performer or team. Returns a paginated list of events with venue, date, time, and location details. The performer URL path is obtained from search_events results by stripping the 'https://www.viagogo.com' prefix. Each event includes a URL for drilling into ticket listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Performer page URL path (e.g., '/Concert-Tickets/Country-and-Folk-Music/Luke-Bryan-Tickets'). Obtain from search_events results by removing the 'https://www.viagogo.com' prefix. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-viagogo-com-api-d987e0c9/get_performer_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_events

Full-text search across performers and events on Viagogo. Returns a list of matching performers with their page URLs for further drill-down. Results may reflect trending/featured items rather than exact query matches for broad queries. Each result includes a URL that can be passed to get_performer_events after stripping the base URL prefix.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'Hamilton', 'Yankees', 'Taylor Swift'). |

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