---
type: "firecrawl-provider"
description: "SeatGeek event discovery: search events by team, artist, venue, place, date and category; event, performer and venue detail; search-box suggestions; event-level ticket availability snapshots (listing and ticket counts, price range). Reads the anonymous SeatGeek Platform API (api.seatgeek.com/2) with the web app's public client id. Per-listing offers are behind DataDome and not covered."
use_when: "SeatGeek event discovery: search events by team, artist, venue, place, date and category; event, performer and venue detail; search-box suggestions; event-level ticket availability snapshots (listing and ticket counts, price range). Reads the anonymous SeatGeek Platform API (api.seatgeek.com/2) with the web app's public client id. Per-listing offers are behind DataDome and not covered."
categories: "Travel"
capabilities: 7
credits_per_call: 5
---
# SeatGeek on Firecrawl Alexandria

SeatGeek event discovery: search events by team, artist, venue, place, date and category; event, performer and venue detail; search-box suggestions; event-level ticket availability snapshots (listing and ticket counts, price range). Reads the anonymous SeatGeek Platform API (api.seatgeek.com/2) with the web app's public client id. Per-listing offers are behind DataDome and not covered.

- Categories: Travel
- Category index: [Travel category](https://firecrawl.dev/alexandria/agents/categories/travel)
- Provider key: `seatgeek-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/seatgeek-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/openapi.json)

## Capabilities

- [Event](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/event): One SeatGeek event by id or public URL (api.seatgeek.com /2/events/{id}): the search_events record plus description, provider ids at other ticketing sites, seating map configuration and sales end. Availability is the API's event-level stats snapshot (listing and ticket counts, price range across listings); per-listing offers with section, row and quantity live behind DataDome (/2/event_listings_v2) and are not available. Unknown ids fail with not_found.
- [Performer](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/performer): One SeatGeek performer by numeric id (api.seatgeek.com /2/performers/{id}) or by URL slug (/2/performers?slug=). Unknown ids and slugs fail with not_found.
- [Search events](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/search_events): Search SeatGeek events (api.seatgeek.com /2/events) by free text, performer slug or id, venue id, explicit event ids, a lat/lon radius, a local date window and/or a taxonomy name, sorted and paged (per_page up to 100). At least one filter is required. Each event carries its stable id, public URL, local and UTC start, venue with timezone, performers, taxonomies, status/schedule_status and an event-level availability snapshot (listing and ticket counts, price range). Coverage is the SeatGeek marketplace (US and Canada); prices carry no currency in the API (the US site displays USD) and fee inclusion is unknown.
- [Search performers](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/search_performers): Search SeatGeek performers (teams, artists, shows; api.seatgeek.com /2/performers?q=) by free text, paged. Returns ids and slugs for search_events and performer, upcoming event counts and taxonomies.
- [Search venues](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/search_venues): Search SeatGeek venues (api.seatgeek.com /2/venues) by free text and/or city and state, paged. Returns venue ids for search_events.venue_id and venue, with address, timezone, capacity and upcoming event counts.
- [Suggest](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/suggest): SeatGeek search-box suggestions (api.seatgeek.com /2/autosuggest) for a partial query: mixed top results plus separate event, performer and venue lists with ids for event, performer and venue. Rate limited upstream to 25 requests per 10 seconds.
- [Venue](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/venue): One SeatGeek venue by numeric id (api.seatgeek.com /2/venues/{id}): address, timezone, coordinates, capacity and upcoming event count. Unknown ids fail with not_found.

## 1. Choose this provider when

SeatGeek event discovery: search events by team, artist, venue, place, date and category; event, performer and venue detail; search-box suggestions; event-level ticket availability snapshots (listing and ticket counts, price range). Reads the anonymous SeatGeek Platform API (api.seatgeek.com/2) with the web app's public client id. Per-listing offers are behind DataDome and not covered.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "seatgeek-com",
  "capability": "events/event",
  "options": {
    "event_id": 18271342
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `event_id` (number): Numeric SeatGeek event id. Exactly one of event_id or url. Example: `10`
- `url` (string): A seatgeek.com event URL (https://seatgeek.com/{slug}-tickets/{type}/{date}/{id}); the trailing number is the event id. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "seatgeek-com",
    capability: "events/event",
    options: {
      event_id: 18271342,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "seatgeek-com",
  "capability": "events/event",
  "options": {
    "event_id": 18271342
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "seatgeek-com",
    "capability": "events/event",
    "options": {
      "event_id": 18271342
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'seatgeek-com/events/event' \
  --options '{"event_id":18271342}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "seatgeek-com",
  "capability": "events/event",
  "options": {
    "event_id": 18271342
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "seatgeek-com",
  "capability": "events/event",
  "options": {
    "event_id": 18271342
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "all_in_price_on_event_page": true,
  "announce_date": "2026-05-28T00:00:00",
  "availability": {
    "average_price": 554,
    "highest_price": 1090,
    "listing_count": 87,
    "lowest_price": 206,
    "lowest_sg_base_price": 172,
    "median_price": 381,
    "ticket_count": 480
  },
  "date_tbd": false,
  "datetime_local": "2027-04-01T14:00:00",
  "datetime_tbd": false,
  "datetime_utc": "2027-04-01T18:00:00",
  "description": "",
  "enddatetime_utc": "2027-04-01T18:00:00",
  "external_ids": [
    {
      "id": "Z1r9uZruZqGZ1AvZFk6",
      "provider": "ticketmaster"
    }
  ],
  "id": 18271342,
  "is_open": false,
  "observed_at_ms": 1790018844045,
  "performers": [
    {
      "id": 7300,
      "name": "Evita",
      "primary": true,
      "slug": "evita",
      "type": "theater_broadway_national_tours",
      "url": "https://seatgeek.com/evita-tickets"
    }
  ],
  "sales_end_datetime_utc": null,
  "schedule_status": "as_originally_scheduled",
  "seating_map": {
    "is_ga": false,
    "is_mapped": true,
    "map_config_key": "v2940-1690-14",
    "static_map_url": "https://static-maps.seatgeekimages.com/map/venue/1690/78e7658d9493c5bdde32a5b5f5e84acb.png?width=512&height=512"
  },
  "short_title": "Evita - New York",
  "source_url": "https://api.seatgeek.com/2/events/18271342?client_id=MTY2MnwxMzgzMzIwMTU4",
  "status": "normal",
  "taxonomies": [
    {
      "id": 3000000,
      "name": "theater",
      "parent_id": null
    },
    {
      "id": 3030000,
      "name": "broadway",
      "parent_id": 3000000
    }
  ],
  "time_tbd": false,
  "timezone": "America/New_York",
  "title": "Evita - New York",
  "type": "broadway",
  "url": "https://seatgeek.com/evita-tickets/broadway/2027-04-01-2-pm/18271342",
  "venue": {
    "address": "1634 Broadway",
    "city": "New York",
    "country": "US",
    "display_location": "New York, NY",
    "id": 2940,
    "latitude": 40.7617,
    "longitude": -73.9837,
    "name": "Winter Garden Theatre",
    "postal_code": "10019",
    "slug": "winter-garden-theatre",
    "state": "NY",
    "timezone": "America/New_York",
    "url": "https://seatgeek.com/venues/winter-garden-theatre/tickets"
  },
  "visible_until_utc": "2027-04-01T18:00:00"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Event

- Capability: `events/event`
- Description: One SeatGeek event by id or public URL (api.seatgeek.com /2/events/{id}): the search_events record plus description, provider ids at other ticketing sites, seating map configuration and sales end. Availability is the API's event-level stats snapshot (listing and ticket counts, price range across listings); per-listing offers with section, row and quantity live behind DataDome (/2/event_listings_v2) and are not available. Unknown ids fail with not_found.
- Instructions: Detail for an event id from search_events, suggest or a pasted seatgeek.com event URL.
- Cost: 5 credits per call
- Capability file: [Event](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/event)

Accepted options:
- `event_id` (number): Numeric SeatGeek event id. Exactly one of event_id or url. Example: `10`
- `url` (string): A seatgeek.com event URL (https://seatgeek.com/{slug}-tickets/{type}/{date}/{id}); the trailing number is the event id. Example: `<url>`

Response schema example:
```json
{
  "all_in_price_on_event_page": true,
  "announce_date": "2026-05-28T00:00:00",
  "availability": {
    "average_price": 554,
    "highest_price": 1090,
    "listing_count": 87,
    "lowest_price": 206,
    "lowest_sg_base_price": 172,
    "median_price": 381,
    "ticket_count": 480
  },
  "date_tbd": false,
  "datetime_local": "2027-04-01T14:00:00",
  "datetime_tbd": false,
  "datetime_utc": "2027-04-01T18:00:00",
  "description": "",
  "enddatetime_utc": "2027-04-01T18:00:00",
  "external_ids": [
    {
      "id": "Z1r9uZruZqGZ1AvZFk6",
      "provider": "ticketmaster"
    }
  ],
  "id": 18271342,
  "is_open": false,
  "observed_at_ms": 1790018844045,
  "performers": [
    {
      "id": 7300,
      "name": "Evita",
      "primary": true,
      "slug": "evita",
      "type": "theater_broadway_national_tours",
      "url": "https://seatgeek.com/evita-tickets"
    }
  ],
  "sales_end_datetime_utc": null,
  "schedule_status": "as_originally_scheduled",
  "seating_map": {
    "is_ga": false,
    "is_mapped": true,
    "map_config_key": "v2940-1690-14",
    "static_map_url": "https://static-maps.seatgeekimages.com/map/venue/1690/78e7658d9493c5bdde32a5b5f5e84acb.png?width=512&height=512"
  },
  "short_title": "Evita - New York",
  "source_url": "https://api.seatgeek.com/2/events/18271342?client_id=MTY2MnwxMzgzMzIwMTU4",
  "status": "normal",
  "taxonomies": [
    {
      "id": 3000000,
      "name": "theater",
      "parent_id": null
    },
    {
      "id": 3030000,
      "name": "broadway",
      "parent_id": 3000000
    }
  ],
  "time_tbd": false,
  "timezone": "America/New_York",
  "title": "Evita - New York",
  "type": "broadway",
  "url": "https://seatgeek.com/evita-tickets/broadway/2027-04-01-2-pm/18271342",
  "venue": {
    "address": "1634 Broadway",
    "city": "New York",
    "country": "US",
    "display_location": "New York, NY",
    "id": 2940,
    "latitude": 40.7617,
    "longitude": -73.9837,
    "name": "Winter Garden Theatre",
    "postal_code": "10019",
    "slug": "winter-garden-theatre",
    "state": "NY",
    "timezone": "America/New_York",
    "url": "https://seatgeek.com/venues/winter-garden-theatre/tickets"
  },
  "visible_until_utc": "2027-04-01T18:00:00"
}
```

### Performer

- Capability: `events/performer`
- Description: One SeatGeek performer by numeric id (api.seatgeek.com /2/performers/{id}) or by URL slug (/2/performers?slug=). Unknown ids and slugs fail with not_found.
- Instructions: Detail for a performer id or slug from search_performers, search_events or suggest.
- Cost: 5 credits per call
- Capability file: [Performer](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/performer)

Accepted options:
- `performer_id` (number): Numeric SeatGeek performer id. Exactly one of performer_id or slug. Example: `10`
- `slug` (string): Performer URL slug, e.g. new-york-yankees. Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$. Example: `<slug>`

Response schema example:
```json
{
  "divisions": [
    {
      "display_name": "American League",
      "display_type": "League",
      "short_name": "AL East",
      "slug": "american-league-east",
      "taxonomy_id": 1010100
    },
    {
      "display_name": "American League East",
      "display_type": "Division",
      "short_name": "AL East",
      "slug": "american-league-east",
      "taxonomy_id": 1010100
    }
  ],
  "has_upcoming_events": true,
  "home_venue_id": 8,
  "id": 8,
  "image": "https://seatgeekimages.com/performers-landscape/new-york-yankees-c669dc/8/huge.jpg",
  "name": "New York Yankees",
  "num_upcoming_events": 214,
  "observed_at_ms": 1790018852043,
  "short_name": "Yankees",
  "slug": "new-york-yankees",
  "source_url": "https://api.seatgeek.com/2/performers/8?client_id=MTY2MnwxMzgzMzIwMTU4",
  "taxonomies": [
    {
      "id": 1000000,
      "name": "sports",
      "parent_id": null
    },
    {
      "id": 1010000,
      "name": "baseball",
      "parent_id": 1000000
    },
    {
      "id": 1010100,
      "name": "mlb",
      "parent_id": 1010000
    }
  ],
  "type": "mlb",
  "url": "https://seatgeek.com/new-york-yankees-tickets"
}
```

### Search events

- Capability: `events/search_events`
- Description: Search SeatGeek events (api.seatgeek.com /2/events) by free text, performer slug or id, venue id, explicit event ids, a lat/lon radius, a local date window and/or a taxonomy name, sorted and paged (per_page up to 100). At least one filter is required. Each event carries its stable id, public URL, local and UTC start, venue with timezone, performers, taxonomies, status/schedule_status and an event-level availability snapshot (listing and ticket counts, price range). Coverage is the SeatGeek marketplace (US and Canada); prices carry no currency in the API (the US site displays USD) and fee inclusion is unknown.
- Instructions: Discovery: find events for a team, artist, venue, place or date range, then pass an event id to event.
- Cost: 5 credits per call
- Capability file: [Search events](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/search_events)

Accepted options:
- `end_date` (string): Latest local event date, YYYY-MM-DD inclusive (datetime_local.lte). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<end_date>`
- `event_ids` (number[]): Explicit event ids to look up in bulk (1-50). Example: `[]`
- `latitude` (number): Centre of a radius search; requires longitude. Example: `10`
- `longitude` (number): longitude Example: `10`
- `page` (number): 1-based page; use next_page from the previous call. Example: `1`
- `per_page` (number): Results per page; the API caps at 100. Example: `20`
- `performer_id` (number): Numeric SeatGeek performer id. Example: `10`
- `performer_slug` (string): Performer URL slug, e.g. new-york-yankees (from performer or search_performers). Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$. Example: `<performer_slug>`
- `query` (string): Free-text search (team, artist, show, venue). Example: `<query>`
- `range_miles` (number): Radius in miles around latitude/longitude (default 30 when a centre is given). Example: `10`
- `sort` (string): Result order. Default is the API's relevance order. Example: `datetime_utc.asc`
- `start_date` (string): Earliest local event date, YYYY-MM-DD (datetime_local.gte). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<start_date>`
- `taxonomy` (string): Taxonomy name as the API uses it, e.g. concert, mlb, theater, comedy (taxonomies.name). Pattern: ^[a-z0-9_]+$. Example: `<taxonomy>`
- `venue_id` (number): Numeric SeatGeek venue id. Example: `10`

Response schema example:
```json
{
  "events": [
    {
      "all_in_price_on_event_page": true,
      "announce_date": "2026-07-08T00:00:00",
      "availability": {
        "average_price": 632,
        "highest_price": 2209,
        "listing_count": 7,
        "lowest_price": 22,
        "lowest_sg_base_price": 16,
        "median_price": 49,
        "ticket_count": 37
      },
      "date_tbd": false,
      "datetime_local": "2026-09-21T18:00:00",
      "datetime_tbd": false,
      "datetime_utc": "2026-09-21T22:00:00",
      "enddatetime_utc": "2026-09-21T23:30:00",
      "id": 18356084,
      "is_open": false,
      "performers": [
        {
          "id": 1971728,
          "name": "Ryman",
          "primary": true,
          "slug": "ryman",
          "type": "band",
          "url": "https://seatgeek.com/ryman-tickets"
        },
        {
          "id": 387311,
          "name": "Darryl Rahn",
          "primary": null,
          "slug": "darryl-rahn",
          "type": "band",
          "url": "https://seatgeek.com/darryl-rahn-tickets"
        }
      ],
      "schedule_status": "as_originally_scheduled",
      "short_title": "Ryman with Darryl Rahn",
      "status": "normal",
      "taxonomies": [
        {
          "id": 2000000,
          "name": "concert",
          "parent_id": null
        }
      ],
      "time_tbd": false,
      "timezone": "America/New_York",
      "title": "Ryman with Darryl Rahn",
      "type": "concert",
      "url": "https://seatgeek.com/ryman-tickets/new-york-new-york-mercury-lounge-new-york-2026-09-21-6-pm/concert/18356084",
      "venue": {
        "address": "217 East Houston Street",
        "city": "New York",
        "country": "US",
        "display_location": "New York, NY",
        "id": 327,
        "latitude": 40.72211,
        "longitude": -73.986786,
        "name": "Mercury Lounge - New York",
        "postal_code": "10002",
        "slug": "mercury-lounge-new-york",
        "state": "NY",
        "timezone": "America/New_York",
        "url": "https://seatgeek.com/venues/mercury-lounge-new-york/tickets"
      },
      "visible_until_utc": "2026-09-21T23:30:00"
    },
    {
      "all_in_price_on_event_page": true,
      "announce_date": "2026-09-15T00:00:00",
      "availability": {
        "average_price": 527,
        "highest_price": 2209,
        "listing_count": 9,
        "lowest_price": 31,
        "lowest_sg_base_price": 24,
        "median_price": 88,
        "ticket_count": 37
      },
      "date_tbd": false,
      "datetime_local": "2026-09-21T19:00:00",
      "datetime_tbd": false,
      "datetime_utc": "2026-09-21T23:00:00",
      "enddatetime_utc": "2026-09-22T00:30:00",
      "id": 18590872,
      "is_open": false,
      "performers": [
        {
          "id": 1964235,
          "name": "Culture Wars",
          "primary": true,
          "slug": "culture-wars",
          "type": "band",
          "url": "https://seatgeek.com/culture-wars-tickets"
        }
      ],
      "schedule_status": "as_originally_scheduled",
      "short_title": "Culture Wars",
      "status": "normal",
      "taxonomies": [
        {
          "id": 2000000,
          "name": "concert",
          "parent_id": null
        }
      ],
      "time_tbd": false,
      "timezone": "America/New_York",
      "title": "Culture Wars",
      "type": "concert",
      "url": "https://seatgeek.com/culture-wars-tickets/new-york-new-york-irving-plaza-2026-09-21-7-pm/concert/18590872",
      "venue": {
        "address": "17 Irving Place",
        "city": "New York",
        "country": "US",
        "display_location": "New York, NY",
        "id": 519,
        "latitude": 40.734905,
        "longitude": -73.98838,
        "name": "Irving Plaza",
        "postal_code": "10003",
        "slug": "irving-plaza",
        "state": "NY",
        "timezone": "America/New_York",
        "url": "https://seatgeek.com/venues/irving-plaza/tickets"
      },
      "visible_until_utc": "2026-09-22T00:30:00"
    },
    {
      "all_in_price_on_event_page": true,
      "announce_date": "2026-02-04T00:00:00",
      "availability": {
        "average_price": 657,
        "highest_price": 2209,
        "listing_count": 8,
        "lowest_price": 59,
        "lowest_sg_base_price": 49,
        "median_price": 209,
        "ticket_count": 49
      },
      "date_tbd": false,
      "datetime_local": "2026-09-21T19:00:00",
      "datetime_tbd": false,
      "datetime_utc": "2026-09-21T23:00:00",
      "enddatetime_utc": "2026-09-22T00:30:00",
      "id": 18051359,
      "is_open": false,
      "performers": [
        {
          "id": 246296,
          "name": "Ben Harper & the Innocent Criminals",
          "primary": true,
          "slug": "ben-harper-and-the-innocent-criminals",
          "type": "band",
          "url": "https://seatgeek.com/ben-harper-tickets"
        },
        {
          "id": 275,
          "name": "Ben Harper",
          "primary": null,
          "slug": "ben-harper",
          "type": "band",
          "url": "https://seatgeek.com/ben-harper-tickets"
        }
      ],
      "schedule_status": "as_originally_scheduled",
      "short_title": "Ben Harper & the Innocent Criminals",
      "status": "normal",
      "taxonomies": [
        {
          "id": 2000000,
          "name": "concert",
          "parent_id": null
        }
      ],
      "time_tbd": false,
      "timezone": "America/New_York",
      "title": "Ben Harper & the Innocent Criminals",
      "type": "concert",
      "url": "https://seatgeek.com/ben-harper-and-the-innocent-criminals-tickets/new-york-new-york-bowery-ballroom-2026-09-21-7-pm/concert/18051359",
      "venue": {
        "address": "6 Delancey Street",
        "city": "New York",
        "country": "US",
        "display_location": "New York, NY",
        "id": 719,
        "latitude": 40.7204,
        "longitude": -73.9934,
        "name": "Bowery Ballroom",
        "postal_code": "10002",
        "slug": "bowery-ballroom",
        "state": "NY",
        "timezone": "America/New_York",
        "url": "https://seatgeek.com/venues/bowery-ballroom/tickets"
      },
      "visible_until_utc": "2026-09-22T00:30:00"
    }
  ],
  "filters": {
    "end_date": null,
    "event_ids": null,
    "latitude": 40.7128,
    "longitude": -74.006,
    "performer_id": null,
    "performer_slug": null,
    "query": null,
    "range_miles": 25,
    "sort": "datetime_utc.asc",
    "start_date": null,
    "taxonomy": "concert",
    "venue_id": null
  },
  "geolocation": {
    "city": "New York",
    "country": "US",
    "display_name": "New York, NY",
    "latitude": 40.7143,
    "longitude": -74.006,
    "range": "25mi",
    "state": "NY"
  },
  "next_page": 2,
  "observed_at_ms": 1790018839970,
  "page": 1,
  "per_page": 3,
  "returned": 3,
  "source_url": "https://api.seatgeek.com/2/events?client_id=MTY2MnwxMzgzMzIwMTU4&lat=40.7128&lon=-74.006&range=25mi&taxonomies.name=concert&sort=datetime_utc.asc&per_page=3&page=1",
  "total": 1946
}
```

### Search performers

- Capability: `events/search_performers`
- Description: Search SeatGeek performers (teams, artists, shows; api.seatgeek.com /2/performers?q=) by free text, paged. Returns ids and slugs for search_events and performer, upcoming event counts and taxonomies.
- Instructions: Resolve a team, artist or show name to a SeatGeek performer id/slug before listing its events.
- Cost: 5 credits per call
- Capability file: [Search performers](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/search_performers)

Accepted options:
- `page` (number): 1-based page; use next_page from the previous call. Example: `1`
- `per_page` (number): Results per page; the API caps at 100. Example: `20`
- `query` (string, required): Free-text performer name. Example: `<query>`

Response schema example:
```json
{
  "next_page": null,
  "observed_at_ms": 1790018848059,
  "page": 1,
  "per_page": 3,
  "performers": [
    {
      "divisions": [
        {
          "display_name": "American League",
          "display_type": "League",
          "short_name": "AL East",
          "slug": "american-league-east",
          "taxonomy_id": 1010100
        },
        {
          "display_name": "American League East",
          "display_type": "Division",
          "short_name": "AL East",
          "slug": "american-league-east",
          "taxonomy_id": 1010100
        }
      ],
      "has_upcoming_events": true,
      "home_venue_id": 8,
      "id": 8,
      "image": "https://seatgeekimages.com/performers-landscape/new-york-yankees-c669dc/8/huge.jpg",
      "name": "New York Yankees",
      "num_upcoming_events": 214,
      "short_name": "Yankees",
      "slug": "new-york-yankees",
      "taxonomies": [
        {
          "id": 1000000,
          "name": "sports",
          "parent_id": null
        },
        {
          "id": 1010000,
          "name": "baseball",
          "parent_id": 1000000
        },
        {
          "id": 1010100,
          "name": "mlb",
          "parent_id": 1010000
        }
      ],
      "type": "mlb",
      "url": "https://seatgeek.com/new-york-yankees-tickets"
    }
  ],
  "query": "new york yankees",
  "returned": 1,
  "source_url": "https://api.seatgeek.com/2/performers?client_id=MTY2MnwxMzgzMzIwMTU4&q=new+york+yankees&per_page=3&page=1",
  "total": 1
}
```

### Search venues

- Capability: `events/search_venues`
- Description: Search SeatGeek venues (api.seatgeek.com /2/venues) by free text and/or city and state, paged. Returns venue ids for search_events.venue_id and venue, with address, timezone, capacity and upcoming event counts.
- Instructions: Find a venue id by name or list venues in a city before listing events at a venue.
- Cost: 5 credits per call
- Capability file: [Search venues](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/search_venues)

Accepted options:
- `city` (string): City name, e.g. chicago. Example: `<city>`
- `page` (number): 1-based page; use next_page from the previous call. Example: `1`
- `per_page` (number): Results per page; the API caps at 100. Example: `20`
- `query` (string): Free-text venue name. Example: `<query>`
- `state` (string): Two-letter state/province code, e.g. IL; only meaningful with city. Pattern: ^[A-Za-z]{2}$. Example: `<state>`

Response schema example:
```json
{
  "filters": {
    "city": null,
    "query": "wrigley field",
    "state": null
  },
  "next_page": null,
  "observed_at_ms": 1790018893118,
  "page": 1,
  "per_page": 3,
  "returned": 2,
  "source_url": "https://api.seatgeek.com/2/venues?client_id=MTY2MnwxMzgzMzIwMTU4&q=wrigley+field&per_page=3&page=1",
  "total": 2,
  "venues": [
    {
      "address": "1060 West Addison Street",
      "capacity": 41363,
      "city": "Chicago",
      "country": "US",
      "display_location": "Chicago, IL",
      "extended_address": "Chicago, IL 60613",
      "has_upcoming_events": true,
      "id": 11,
      "latitude": 41.9475,
      "longitude": -87.6562,
      "name": "Wrigley Field",
      "num_upcoming_events": 98,
      "postal_code": "60613",
      "slug": "wrigley-field",
      "state": "IL",
      "timezone": "America/Chicago",
      "url": "https://seatgeek.com/venues/wrigley-field/tickets"
    },
    {
      "address": "6527 East State Boulevard",
      "capacity": 0,
      "city": "Fort Wayne",
      "country": "US",
      "display_location": "Fort Wayne, IN",
      "extended_address": "Fort Wayne, IN 46815",
      "has_upcoming_events": false,
      "id": 79023,
      "latitude": 41.1028,
      "longitude": -85.0578,
      "name": "Wrigley Field Bar & Grill",
      "num_upcoming_events": 0,
      "postal_code": "46815",
      "slug": "wrigley-field-bar-grill",
      "state": "IN",
      "timezone": "America/New_York",
      "url": "https://seatgeek.com/venues/wrigley-field-bar-grill/tickets"
    }
  ]
}
```

### Suggest

- Capability: `events/suggest`
- Description: SeatGeek search-box suggestions (api.seatgeek.com /2/autosuggest) for a partial query: mixed top results plus separate event, performer and venue lists with ids for event, performer and venue. Rate limited upstream to 25 requests per 10 seconds.
- Instructions: Quickly resolve a partial name to SeatGeek ids across events, performers and venues in one call.
- Cost: 5 credits per call
- Capability file: [Suggest](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/suggest)

Accepted options:
- `limit` (number): Maximum suggestions per type. Example: `5`
- `query` (string, required): Partial or full name. Example: `<query>`

Response schema example:
```json
{
  "events": [
    {
      "datetime_local": "2026-09-26T19:15:00",
      "datetime_utc": "2026-09-26T23:15:00",
      "id": 17691599,
      "title": "Baltimore Orioles at New York Yankees",
      "type": "mlb",
      "url": "https://seatgeek.com/new-york-yankees-tickets/9-26-2026-bronx-new-york-yankee-stadium/mlb/17691599",
      "venue_location": "Bronx, NY",
      "venue_name": "Yankee Stadium"
    },
    {
      "datetime_local": "2026-09-25T19:05:00",
      "datetime_utc": "2026-09-25T23:05:00",
      "id": 17691598,
      "title": "Baltimore Orioles at New York Yankees",
      "type": "mlb",
      "url": "https://seatgeek.com/new-york-yankees-tickets/9-25-2026-bronx-new-york-yankee-stadium/mlb/17691598",
      "venue_location": "Bronx, NY",
      "venue_name": "Yankee Stadium"
    },
    {
      "datetime_local": "2026-09-27T15:20:00",
      "datetime_utc": "2026-09-27T19:20:00",
      "id": 17691600,
      "title": "Baltimore Orioles at New York Yankees",
      "type": "mlb",
      "url": "https://seatgeek.com/new-york-yankees-tickets/9-27-2026-bronx-new-york-yankee-stadium/mlb/17691600",
      "venue_location": "Bronx, NY",
      "venue_name": "Yankee Stadium"
    }
  ],
  "observed_at_ms": 1790018921011,
  "performers": [
    {
      "id": 8,
      "name": "New York Yankees",
      "type": "mlb",
      "url": "https://seatgeek.com/new-york-yankees-tickets"
    }
  ],
  "query": "yankees",
  "source_url": "https://api.seatgeek.com/2/autosuggest?client_id=MTY2MnwxMzgzMzIwMTU4&q=yankees&limit=3&types=event&types=performer&types=venue",
  "top_results": [
    {
      "id": 8,
      "name": "New York Yankees",
      "type": "performer",
      "url": "https://seatgeek.com/new-york-yankees-tickets"
    },
    {
      "id": 17691599,
      "name": "Baltimore Orioles at New York Yankees",
      "type": "event",
      "url": "https://seatgeek.com/new-york-yankees-tickets/9-26-2026-bronx-new-york-yankee-stadium/mlb/17691599"
    },
    {
      "id": 17691598,
      "name": "Baltimore Orioles at New York Yankees",
      "type": "event",
      "url": "https://seatgeek.com/new-york-yankees-tickets/9-25-2026-bronx-new-york-yankee-stadium/mlb/17691598"
    }
  ],
  "venues": []
}
```

### Venue

- Capability: `events/venue`
- Description: One SeatGeek venue by numeric id (api.seatgeek.com /2/venues/{id}): address, timezone, coordinates, capacity and upcoming event count. Unknown ids fail with not_found.
- Instructions: Detail for a venue id from search_venues, search_events or suggest.
- Cost: 5 credits per call
- Capability file: [Venue](https://firecrawl.dev/alexandria/agents/providers/seatgeek-com/events/venue)

Accepted options:
- `venue_id` (number, required): Numeric SeatGeek venue id. Example: `10`

Response schema example:
```json
{
  "address": "1060 West Addison Street",
  "capacity": 41363,
  "city": "Chicago",
  "country": "US",
  "display_location": "Chicago, IL",
  "extended_address": "Chicago, IL 60613",
  "has_upcoming_events": true,
  "id": 11,
  "latitude": 41.9475,
  "longitude": -87.6562,
  "name": "Wrigley Field",
  "num_upcoming_events": 98,
  "observed_at_ms": 1790018911411,
  "postal_code": "60613",
  "slug": "wrigley-field",
  "source_url": "https://api.seatgeek.com/2/venues/11?client_id=MTY2MnwxMzgzMzIwMTU4",
  "state": "IL",
  "timezone": "America/Chicago",
  "url": "https://seatgeek.com/venues/wrigley-field/tickets"
}
```
