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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/viagogo/`
**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 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/credits/viagogo/get-category-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/viagogo/get-event-ticket-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/viagogo/get-performer-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/viagogo/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://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.