# Shop Ticketera — 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 on Ticketera, retrieve detailed event information including pricing and ticket categories, and check real-time seat availability for any performance. Ideal for browsing upcoming shows, comparing ticket options, and finding open seats before purchasing.

**Category:** Entertainment | **Website:** [shop.ticketera.com/](https://shop.ticketera.com/) | **Docs:** [parse.bot/marketplace/45450109-c0a8-4980-94bf-15229b7d28d1/shop-ticketera-com-api](https://parse.bot/marketplace/45450109-c0a8-4980-94bf-15229b7d28d1/shop-ticketera-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-shop-ticketera-com-api-45450109/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_empty_seats

Get all empty (available/free) seats for a seated event, with section, row, seat number, and category for each. Also returns a summary count by section. Returns sold_out=true if no seats are available. Only works for events where seating.active is true in get_event_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_slug` | string | Yes | Event slug from search_events results[*].event_slug or from a ticket URL path (e.g. 'concierto-familiar-3-scheherazade-el-poder-de-co-l9275y') |
| `shop_domain` | string | No | Shop domain hosting the event (e.g. 'shop.ticketera.com', 'choli.ticketera.com', 'cmh.ticketera.com'). Auto-detected across known domains if not specified. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-ticketera-com-api-45450109/get_empty_seats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_slug":"<string>","shop_domain":"<string>"}'
```

### get_event_details

Get detailed event information including seating categories, ticket types with prices, venue location, and seating configuration. Requires the event_slug from search results or a ticket URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_slug` | string | Yes | Event slug from search_events results[*].event_slug or from a ticket URL path (e.g. 'concierto-familiar-3-scheherazade-el-poder-de-co-l9275y') |
| `shop_domain` | string | No | Shop domain hosting the event (e.g. 'shop.ticketera.com', 'choli.ticketera.com', 'cmh.ticketera.com'). Auto-detected across known domains if not specified. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shop-ticketera-com-api-45450109/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_slug":"<string>","shop_domain":"<string>"}'
```

### search_events

Search for events on Ticketera by keyword. Returns event names, venues, dates, ticket URLs, and event slugs that can be used with other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'basketball', 'concierto'). Use empty string for all events. |

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