# SeatGeek — 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 for events and performers, view ticket listings with pricing data, and explore venue information across multiple event categories. Get real-time insights into event details, ticket price trends, and what's currently trending to help you find and compare tickets.

**Category:** Entertainment | **Website:** [seatgeek.com/](https://seatgeek.com/) | **Docs:** [parse.bot/marketplace/3ad3fb87-f7c4-43fb-8822-b597832e3458/seatgeek-com-api](https://parse.bot/marketplace/3ad3fb87-f7c4-43fb-8822-b597832e3458/seatgeek-com-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/seatgeek/`
**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 event detail

Retrieve full details for a specific event by its ID, including venue, performers, pricing stats, schedule status, and configuration.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Unique numeric event ID (from search_events results) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/get-event-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### Get event ticket listings

Get all ticket listings for a specific event. Requires a warmup page load to establish session state on seatgeek.com before calling the listings API. Returns individual ticket listings with section, row, seat numbers, and price data. The endpoint uses a different internal API than other endpoints and may occasionally be blocked by protection systems requiring proxy rotation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Unique numeric event ID (from search_events or get_trending_events results) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/get-event-ticket-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### Get event ticket prices summary

Get aggregated pricing summary for a specific event: listing count, lowest, highest, median, and average prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Unique numeric event ID (from search_events results) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/get-event-ticket-prices-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### Get taxonomies

List all event categories/taxonomies used by SeatGeek, including Sports, Concerts, Theater, and their subcategories with event counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/get-taxonomies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get trending events

Retrieve currently trending/popular events sorted by score. Returns the highest-ranked events across all categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | No | Latitude for location-based trending events |
| `lon` | string | No | Longitude for location-based trending events |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/get-trending-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>"}'
```

### Get venue events

List all upcoming events at a specific venue by venue ID. Returns events with full details including performers, pricing, and schedule.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `venue_id` | string | Yes | Unique numeric venue ID (from event venue objects in search_events or get_event_detail results) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/get-venue-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"venue_id":"<string>"}'
```

### Search events

Search for events by keyword/name, returning event titles, dates, venues, categories, performers, and ticket price statistics. Supports filtering by taxonomy, location, and pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | No | Latitude for location-based search |
| `lon` | string | No | Longitude for location-based search |
| `page` | integer | No | Page number for pagination |
| `per_page` | integer | No | Results per page |
| `query` | string | No | Search keyword or event name |
| `taxonomy_id` | string | No | Category/taxonomy ID to filter events by (e.g. '1000000' for Sports, '2000000' for Concerts) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/search-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>","page":"<integer>","per_page":"<integer>","query":"<string>","taxonomy_id":"<string>"}'
```

### Search performers

Search for artists, bands, sports teams, or other performers by name. Returns performer details including type, images, genres, popularity, and upcoming event count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return |
| `query` | string | Yes | Performer name or keyword to search for |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/seatgeek/search-performers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","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.