# SeatGeek — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/get_event_ticket_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/get_event_ticket_prices_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/get_taxonomies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/get_trending_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/get_venue_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-seatgeek-com-api-3ad3fb87/search_performers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```