# Stubhub — 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 and discover tickets across StubHub's marketplace by looking up events, performers, and categories to find exactly what you want to attend. Browse event details, performer schedules, and curated category collections to compare available tickets and make informed purchasing decisions.

**Category:** Marketplaces | **Website:** [stubhub.com/](https://stubhub.com/) | **Docs:** [parse.bot/marketplace/51225e55-32ab-49c9-a494-f231ca778e75/stubhub-com-api](https://parse.bot/marketplace/51225e55-32ab-49c9-a494-f231ca778e75/stubhub-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-stubhub-com-api-51225e55/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_category_components

Fetch homepage carousel components showing upcoming events near the user's inferred location. Returns event listings with dates, venues, and pricing information. Only the 'DontMissEvents' method is supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `method` | string | Yes | Component name. Accepted value: 'DontMissEvents' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stubhub-com-api-51225e55/browse_category_components \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"<string>"}'
```

### get_event_details

Get comprehensive details for a specific event, including all active ticket listings with seat info, prices, deal scores, and venue section map data. Returns up to 500 listings by paginating the upstream source. Optionally filter listings by section name or number. The event_slug and event_id are obtainable from performer events or search results URLs (pattern: /<slug>/event/<id>/).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric event ID (e.g., '160477665') |
| `event_slug` | string | Yes | Event URL slug (e.g., 'jefferson-starship-wichita-tickets-6-11-2026'). Obtainable from performer events or browse results URL path. |
| `section` | string | No | Filter listings to only those matching the specified section name or number (e.g., '423', '3', 'GA'). Case-insensitive. When omitted, all listings are returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stubhub-com-api-51225e55/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>","event_slug":"<string>","section":"<string>"}'
```

### get_performer_events

Retrieve upcoming events and related performers for a specific performer or team. Returns trending events, alternative performers, and total event count. The performer_id and performer_slug are obtainable from search_autocomplete results URL paths (pattern: /<slug>/performer/<id>).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `performer_id` | string | Yes | Internal performer ID (e.g., '2864'). Obtainable from search_autocomplete results URL path. |
| `performer_slug` | string | Yes | Performer URL slug (e.g., 'denver-nuggets-tickets'). Obtainable from search_autocomplete results URL path. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stubhub-com-api-51225e55/get_performer_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"performer_id":"<string>","performer_slug":"<string>"}'
```

### search_autocomplete

Get trending performer and event suggestions from StubHub. Returns popular categories with their names, IDs, relative URLs, and thumbnail images. Note: results reflect currently trending performers rather than query-filtered matches.

**Estimated cost:** Metered

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

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

### search_events

Full search for events, performers, and venues on StubHub. Returns structured results grouped by entity type (performers with entity=5, events with entity=2, venues with entity=3). Each result includes title, URL, category/event details, and image URLs. Requires an initial page visit to acquire WAF cookies before the API call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query (e.g., 'Lakers', 'Coldplay', 'World Cup') |

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