# Seat Geek

SeatGeek Platform API provides access to events, venues, and performers data for concerts, sports, theater, and other live entertainment

- **Category:** event management
- **Auth:** NO_AUTH
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `SEAT_GEEK`
- **Version:** 20260316_00

## Tools

### Get Event Details

**Slug:** `SEAT_GEEK_GET_EVENT_DETAILS`

Get comprehensive details about a specific event including venue, performers, date/time (in local venue time), ticket information, and a SeatGeek event URL. Performer and venue fields are basic summaries; use SEAT_GEEK_GET_PERFORMER_DETAILS or SEAT_GEEK_GET_VENUE_DETAILS for additional depth. For similarly named or recurring events, cross-check date, venue, league, and competition fields to confirm the correct event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | The unique numeric ID of the event to retrieve details for. Event IDs can be obtained from the search_events action or from event URLs on seatgeek.com. Passed as a string here; note that other SeatGeek tools (e.g., SEAT_GEEK_GET_EVENT_SEATING) may require the same ID as an integer — check each tool's schema when chaining. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Recommendations

**Slug:** `SEAT_GEEK_GET_EVENT_RECOMMENDATIONS`

Get personalized event recommendations based on your favorite performers, events, or location. Discover new events you might enjoy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lat` | number | No | Latitude for location-based recommendations. Must be provided with longitude. |
| `lon` | number | No | Longitude for location-based recommendations. Must be provided with latitude. |
| `geoip` | string | No | Use 'true' to geolocate by client IP or provide a specific IP address. |
| `range` | string | No | Radius from geolocation point to search within. Default is 200mi. |
| `per_page` | integer | No | Number of results per page. Default is 10. |
| `events_id` | string | No | A single event ID to use as recommendation seed. Get event IDs from the search_events action. |
| `postal_code` | string | No | Postal code for location-based recommendations. |
| `performers_id` | string | No | A single performer ID to use as recommendation seed. Get performer IDs from the search_performers action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Seating Information

**Slug:** `SEAT_GEEK_GET_EVENT_SEATING`

Get section and row layout information for a specific event's venue. Returns available sections (e.g., '101', 'floor', 'suite-14') mapped to their row identifiers. IMPORTANT: Only works for events at major venues with seating maps (stadiums, arenas). Small venue concerts or general admission events will return a 404 error. Use SEAT_GEEK_SEARCH_EVENTS with taxonomies_name='sports' to find events that have seating data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | integer | Yes | The unique SeatGeek event ID. Get this from SEAT_GEEK_SEARCH_EVENTS. Note: Seating info is only available for events at major venues (stadiums, arenas). Concerts at small venues or general admission events return 404. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Performer Details

**Slug:** `SEAT_GEEK_GET_PERFORMER_DETAILS`

Retrieves detailed information about a specific performer (artist, sports team, or theatrical production) from SeatGeek by their unique ID. Returns comprehensive data including performer name, type, images, popularity scores, upcoming event counts, genre/taxonomy classifications, and ticket URLs. Does not include box scores, match statistics, or performance stats. Use this action when you need fields beyond the basic performer info already embedded in event details (e.g., popularity scores, full taxonomy, upcoming event counts). To find performer IDs, first use the search_performers action to search by name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `performer_id` | string | Yes | The unique numeric ID of the performer to retrieve details for. Can be obtained from search_performers action or from event details. Examples: '266' (Beastie Boys), '303' (Billy Joel), '1' (LA Dodgers). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Performer Recommendations

**Slug:** `SEAT_GEEK_GET_PERFORMER_RECOMMENDATIONS`

Get recommendations for similar performers based on your interests. Discover new artists, bands, teams, or entertainers you might enjoy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per_page` | integer | No | Number of recommended performers to return per page. Default is 10 if not specified. |
| `events_id` | string | No | A single event ID to use as a recommendation seed. Get event IDs from the search_events action. Only one ID is allowed per request. |
| `performers_id` | string | No | A single performer ID to use as a recommendation seed. Get performer IDs from the search_performers action. Only one ID is allowed per request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Categories

**Slug:** `SEAT_GEEK_GET_TAXONOMIES`

Get a list of all available event categories and types (taxonomies) used on SeatGeek. Useful for understanding event classification and filtering options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results. Use with per_page parameter. Defaults to 1. |
| `per_page` | integer | No | Number of taxonomies to return per page. If not specified, returns all taxonomies. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Venue Details

**Slug:** `SEAT_GEEK_GET_VENUE_DETAILS`

Get detailed venue-specific information (location, address, metadata) beyond what SEAT_GEEK_GET_EVENT_DETAILS already returns. Only call this tool when additional venue fields are needed that are absent from the event details response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `venue_id` | string | Yes | The unique numeric ID of the venue to retrieve details for. Use the Search Venues action to find venue IDs. Deduplicate venue IDs before calling, as the same venue appears across many events. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Events

**Slug:** `SEAT_GEEK_SEARCH_EVENTS`

Search for ticketed events on SeatGeek by performers, venues, dates, or general queries. Covers concerts, sports games, theater shows, and other live entertainment. Only indexes ticketed events; empty results may indicate coverage gaps. Avoid over-filtering — start broad and progressively narrow. lat and lon parameters must be supplied together for location-based filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | General search query for events, performers, or venues. Supports natural language like 'yankees march' or 'skrillex on june 4th'. |
| `per_page` | integer | No | Number of results per page. Default is 10. Maximum is 100. Use the page parameter to paginate when meta.total exceeds per_page to avoid silently missing events. |
| `venue_id` | string | No | Venue ID to filter events to a specific venue. |
| `venue_city` | string | No | City name to filter events by venue location. |
| `venue_state` | string | No | Two-letter state code to filter events by venue location. |
| `datetime_utc` | string | No | Filter events by exact UTC date/time. Format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS. |
| `performers_id` | string | No | Performer ID(s) to filter events. Multiple IDs can be comma-separated for OR queries. IDs must come from prior SeatGeek search results; arbitrary or stale IDs may yield empty responses. |
| `taxonomies_id` | string | No | Filter events by taxonomy ID. |
| `datetime_local` | string | No | Filter events by exact local date/time. Format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS. |
| `performers_slug` | string | No | Performer slug(s) to filter events. Use URL-friendly format. |
| `taxonomies_name` | string | No | Filter events by category/type name. Accepts a single value only; comma-separated categories silently return zero results even when each category individually has matches. |
| `datetime_utc_gte` | string | No | Filter events happening on or after this UTC date/time. Convert relative expressions ('tomorrow', 'this weekend') to explicit UTC timestamps before use. Widen UTC range to fully cover the intended local time window to avoid off-by-one-day omissions near day boundaries. |
| `datetime_utc_lte` | string | No | Filter events happening on or before this UTC date/time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Performers

**Slug:** `SEAT_GEEK_SEARCH_PERFORMERS`

Search for performers including artists, bands, sports teams, comedians, and more. Find your favorite entertainers and see their upcoming events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | General search query for performers. Search artists, bands, sports teams, or any performers. |
| `id` | string | No | Performer ID(s) to retrieve. Can be comma-separated for multiple performers. Must be valid SeatGeek performer IDs obtained from prior search results; arbitrary or external IDs return empty responses. |
| `slug` | string | No | Search for a specific performer by their slug (URL-friendly name). |
| `per_page` | integer | No | Number of results per page. Default is 10. High values return large payloads; keep low when exploring. |
| `taxonomies_id` | string | No | Filter performers by taxonomy ID. |
| `taxonomies_name` | string | No | Filter performers by category/type name (e.g., 'sports', 'concert', 'theater'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Venues

**Slug:** `SEAT_GEEK_SEARCH_VENUES`

Search for venues by location, name, or other criteria. Find stadiums, theaters, concert halls, and other entertainment venues. Supports lat/lon coordinate filtering (both must be provided together).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | General search query for venues. |
| `id` | string | No | Venue ID(s) to retrieve. Can be comma-separated for multiple venues. |
| `city` | string | No | Filter venues by city name. |
| `page` | integer | No | Page number for pagination. Default is 1. |
| `state` | string | No | Filter venues by state (use two-letter state code). |
| `country` | string | No | Filter venues by country (use two-letter country code). |
| `per_page` | integer | No | Number of results per page. Default is 10. |
| `postal_code` | string | No | Filter venues by postal/zip code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |