### Example GET request to /match endpoint

Source: https://ticketsdata.com/docs

Use this URL to call the /match endpoint with your credentials and an event URL. Replace YOUR_EMAIL and YOUR_PASSWORD with your account credentials. The event_url must be a full URL from a supported marketplace.

```http
GET https://ticketsdata.com/match?username=YOUR_EMAIL&password=YOUR_PASSWORD&event_url=https://seatgeek.com/cardi-b-tickets/atlanta-georgia-state-farm-arena-1-2026-04-18-7-30-pm/concert/17762666
```

--------------------------------

### curl example for GET /events

Source: https://ticketsdata.com/docs

Example curl command to call the /events endpoint with required parameters: username, password, platform, and performer_url. This example uses platform=dice and a Dice.fm artist URL.

```bash
curl -G "https://ticketsdata.com/events" \
  --data-urlencode "username=YOUR_EMAIL" \
  --data-urlencode "password=YOUR_PASSWORD" \
  --data-urlencode "platform=dice" \
  --data-urlencode "performer_url=https://dice.fm/artist/las-petunias-v8krl"
```

--------------------------------

### Install ticketsdata-client via pip

Source: https://ticketsdata.com/docs

Installation command for the official Python SDK. Use this to install the ticketsdata-client package before using the SDK.

```bash
pip install ticketsdata-client
```

--------------------------------

### Python SDK - Install

Source: https://ticketsdata.com/docs

Installation command for the official TicketsData Python SDK.

```APIDOC
## Python SDK - Install

### Description
Install the official TicketsData Python SDK using pip.

### Installation
```bash
pip install ticketsdata-client
```
```

--------------------------------

### Quickstart cURL request to /fetch

Source: https://ticketsdata.com/docs

Make your first API call with cURL, replacing YOUR_EMAIL and YOUR_PASSWORD with your TicketsData credentials. The response is JSON with status, body, response_s, and quota_remaining fields.

```bash
curl -G "https://ticketsdata.com/fetch" \
  --data-urlencode "username=YOUR_EMAIL" \
  --data-urlencode "password=YOUR_PASSWORD" \
  --data-urlencode "platform=ticketmaster" \
  --data-urlencode "event_url=https://www.ticketmaster.com/event/160062583FD9756B"
```

--------------------------------

### Batch fetch events from 9 platforms with Python SDK

Source: https://ticketsdata.com/docs

Example of using the TicketsDataClient to fetch events from 9 platforms simultaneously. Configure concurrency and timeout, then call fetch_many with a list of jobs. The example prints each platform and its status, then closes the client. Requires valid credentials.

```python
from ticketsdata_client import TicketsDataClient
import asyncio

async def main():
    client = TicketsDataClient(
        username="YOUR_EMAIL",
        password="YOUR_PASSWORD",
        concurrency=10,
        timeout=30,
    )

    jobs = [
        {"platform": "ticketmaster", "event_url": "https://www.ticketmaster.com/event/160062583FD9756B"},
        {"platform": "stubhub",      "event_url": "https://www.stubhub.com/event/157413810/"},
        {"platform": "seatgeek",     "event_url": "https://seatgeek.com/concert/17735171"},
        {"platform": "vividseats",   "event_url": "https://www.vividseats.com/production/5599667"},
        {"platform": "tickpick",     "event_url": "https://www.tickpick.com/buy-7364698/"},
        {"platform": "gametime",     "event_url": "6908d769dfe85fe8ad73cd62", "mode": "all"},
        {"platform": "viagogo",      "event_url": "https://www.viagogo.com/event/E-159359741"},
        {"platform": "dice",         "event_url": "https://dice.fm/event/eoe37y-tide-lines-14th-apr"},
        {"platform": "eventbrite",   "event_url": "https://www.eventbrite.com/e/cardi-b-tickets-1986188272590"},
    ]

    results = await client.fetch_many(jobs)
    for r in results:
        print(r["platform"], r.get("status"))

    await client.close()

asyncio.run(main())
```

--------------------------------

### GET /fetch

Source: https://ticketsdata.com/docs

Fetches event data from a supported platform. Authentication is via query parameters username and password. The response is JSON with status, body, response_s, and quota_remaining.

```APIDOC
## GET /fetch

### Description
Fetches event data from a supported platform. Authentication is via query parameters username and password. The response is JSON with status, body, response_s, and quota_remaining.

### Method
GET

### Endpoint
https://ticketsdata.com/fetch

### Parameters
#### Query Parameters
- **username** (string) - Required - Your TicketsData account email.
- **password** (string) - Required - Your TicketsData account password.
- **platform** (string) - Required - The platform identifier (e.g., ticketmaster, stubhub).
- **event_url** (string) - Required - The event URL or ID for the platform.

### Request Example
```
curl -G "https://ticketsdata.com/fetch" \
  --data-urlencode "username=YOUR_EMAIL" \
  --data-urlencode "password=YOUR_PASSWORD" \
  --data-urlencode "platform=ticketmaster" \
  --data-urlencode "event_url=https://www.ticketmaster.com/event/160062583FD9756B"
```

### Response
#### Success Response (200)
- **status** (string) - Status of the request.
- **body** (object) - The response body containing event data.
- **response_s** (string) - Response status or message.
- **quota_remaining** (integer) - Remaining API quota.

#### Response Example
```json
{
  "status": "success",
  "body": {},
  "response_s": "OK",
  "quota_remaining": 100
}
```
```

--------------------------------

### Python SDK - Batch Fetch

Source: https://ticketsdata.com/docs

Example of using the TicketsData Python SDK to fetch data from multiple platforms concurrently. The client handles authentication, concurrency, retries, and result handling.

```APIDOC
## Python SDK - Batch Fetch

### Description
Use the TicketsDataClient to fetch ticket data from multiple platforms simultaneously. The client supports automatic concurrency and retries.

### Usage
```python
from ticketsdata_client import TicketsDataClient
import asyncio

async def main():
    client = TicketsDataClient(
        username="YOUR_EMAIL",
        password="YOUR_PASSWORD",
        concurrency=10,
        timeout=30,
    )

    jobs = [
        {"platform": "ticketmaster", "event_url": "https://www.ticketmaster.com/event/160062583FD9756B"},
        {"platform": "stubhub",      "event_url": "https://www.stubhub.com/event/157413810/"},
        {"platform": "seatgeek",     "event_url": "https://seatgeek.com/concert/17735171"},
        {"platform": "vividseats",   "event_url": "https://www.vividseats.com/production/5599667"},
        {"platform": "tickpick",     "event_url": "https://www.tickpick.com/buy-7364698/"},
        {"platform": "gametime",     "event_url": "6908d769dfe85fe8ad73cd62", "mode": "all"},
        {"platform": "viagogo",      "event_url": "https://www.viagogo.com/event/E-159359741"},
        {"platform": "dice",         "event_url": "https://dice.fm/event/eoe37y-tide-lines-14th-apr"},
        {"platform": "eventbrite",   "event_url": "https://www.eventbrite.com/e/cardi-b-tickets-1986188272590"},
    ]

    results = await client.fetch_many(jobs)
    for r in results:
        print(r["platform"], r.get("status"))

    await client.close()

asyncio.run(main())
```
```

--------------------------------

### GET /fetch

Source: https://ticketsdata.com/docs

Fetches live ticket inventory for a given event on a specified marketplace. Returns normalized JSON with section, row, quantity, price, and fees.

```APIDOC
## GET /fetch

### Description
Fetches live ticket inventory for a given event on a specified marketplace. Returns normalized JSON with section, row, quantity, price, and fees.

### Method
GET

### Endpoint
https://ticketsdata.com/fetch

### Parameters
#### Query Parameters
- **username** (string) - Required - Your TicketsData username.
- **password** (string) - Required - Your TicketsData password.
- **platform** (string) - Required - The marketplace platform name (e.g., ticketmaster, stubhub, seatgeek, vividseats, gametime, tickpick, viagogo, dice, eventbrite, axs).
- **event_url** (string) - Required - The URL of the event on the specified platform.

### Request Example
```
curl -G "https://ticketsdata.com/fetch" \
  --data-urlencode "username=YOU" \
  --data-urlencode "password=PASS" \
  --data-urlencode "platform=ticketmaster" \
  --data-urlencode "event_url=https://..."
```

### Response
#### Success Response (200)
- **status** (string) - Status of the response.
- **body** (object) - The normalized ticket inventory data.
- **response_s** (number) - Response time in seconds.

#### Response Example
```
{
  "status": "success",
  "body": {},
  "response_s": 0.5
}
```
```

--------------------------------

### GET /fetch - curl request

Source: https://ticketsdata.com/docs

Use this curl command to fetch live ticket inventory from a specified marketplace. Replace username, password, platform, and event_url with your credentials and target event. The response is a 200 OK with a JSON object containing status, body, and response_s.

```bash
curl -G "https://ticketsdata.com/fetch" \
  --data-urlencode "username=YOU" \
  --data-urlencode "password=PASS" \
  --data-urlencode "platform=ticketmaster" \
  --data-urlencode "event_url=https://..."
```

--------------------------------

### GET /fetch

Source: https://ticketsdata.com/docs

Returns full real-time ticket inventory for a single event URL. This is the primary endpoint — pass a platform and event URL, receive all available listings with section, row, quantity, and pricing.

```APIDOC
## GET /fetch

### Description
Returns full real-time ticket inventory for a single event URL. This is the primary endpoint — pass a platform and event URL, receive all available listings with section, row, quantity, and pricing.

### Method
GET

### Endpoint
https://ticketsdata.com/fetch

### Parameters
#### Query Parameters
- **username** (string) - Required - Your TicketsData account email
- **password** (string) - Required - Your TicketsData account password
- **platform** (string) - Required - One of: `ticketmaster, stubhub, seatgeek, vividseats, gametime, tickpick, viagogo, dice, eventbrite, axs`
- **event_url** (string) - Required - Full event URL from the marketplace, or event ID for platforms that support it (Gametime, Dice.fm)
- **mode** (string) - Optional - Platform-specific mode parameter. See the mode matrix below.

### Mode Parameter Matrix
| Platform | mode value | Effect |
|----------|------------|--------|
| `gametime` | `all` | Returns listings for quantities 1, 2, 3 … up to 10 — expands per-quantity pricing. Without this, only the default quantity is returned. |
| `gametime` | `qty=N` | Returns listings for a specific quantity only (e.g. qty=2). Can be combined with other filters. |
| `ticketmaster` | (omit) | Default view — returns all available offers with standard inventory. |
| `ticketmaster` | `availability` | Returns offers filtered to in-stock items only, sorted by quantity available. |
| `ticketmaster` | `pricing` | Returns offers sorted by total all-in price ascending. |
| `ticketmaster` | `quickpicks` | Returns the platform's curated quick-pick recommendations — typically best-value seats per section. |

### Response
All responses follow the same envelope. The `body` structure varies by platform but always contains ticket listings. Check `status` for success/failure.

#### Response Example
```json
{
  "status": 200,
  "platform": "ticketmaster",
  "body": {
    "_embedded": {
      "offer": [
        {
          "offerId": "GN6DCMJVGU4DOOBYGAZHYMJXMY3TOZLFMI4TK",
          "section": "605",
          "row": "-",
          "listPrice": "380.00",
          "totalPrice": 459.80,
          "inventoryType": "resale",
          "sellableQuantities": [1, 2, 3, 4]
        }
      ]
    }
  },
  "response_s": 2.14,
  "quota_remaining": 117382
}
```

### Request Example
```bash
curl -G "https://ticketsdata.com/fetch" \
  --data-urlencode "username=YOUR_EMAIL" \
  --data-urlencode "password=YOUR_PASSWORD" \
  --data-urlencode "platform=ticketmaster" \
  --data-urlencode "event_url=https://www.ticketmaster.com/event/160062583FD9756B"
```
```

--------------------------------

### GET /events

Source: https://ticketsdata.com/docs

Returns all upcoming events for a given performer, artist, venue, promoter, or organizer page URL. Use this to discover event IDs and URLs before fetching full inventory with /fetch.

```APIDOC
## GET /events

### Description
Returns all upcoming events for a given performer, artist, venue, promoter, or organizer page URL. Use this to discover event IDs and URLs before fetching full inventory with /fetch.

### Method
GET

### Endpoint
https://ticketsdata.com/events

### Parameters
#### Query Parameters
- **username** (string) - Required - Your TicketsData account email
- **password** (string) - Required - Your TicketsData account password
- **platform** (string) - Required - Platform to search — see table below for per-platform support
- **performer_url** (string) - Optional - Artist/performer/organizer page URL. Required for most platforms. For Dice.fm venue and promoter pages use `venue_url` instead
- **venue_url** (string) - Optional - Dice.fm only — for `dice.fm/venue/…` and `dice.fm/promoters/…` URLs

### Platform Support Matrix
| Platform | Parameter | URL example |
|----------|-----------|-------------|
| `stubhub` | `performer_url` | Artist/performer page URL |
| `seatgeek` | `performer_url` | Artist/performer page URL |
| `tickpick` | `performer_url` | Artist/performer page URL |
| `ticketmaster` | `performer_url` | Artist/performer page URL |
| `gametime` | `performer_url` | Performer page URL |
| `vividseats` | `performer_url` | Performer page URL |
| `dice` | `performer_url` | dice.fm/artist/… URL |
| `dice` | `venue_url` | dice.fm/venue/… or /promoters/… URL |
| `eventbrite` | `performer_url` | eventbrite.com/o/{organizer_id} URL |

### Request Example
```bash
curl -G "https://ticketsdata.com/events" \
  --data-urlencode "username=YOUR_EMAIL" \
  --data-urlencode "password=YOUR_PASSWORD" \
  --data-urlencode "platform=dice" \
  --data-urlencode "performer_url=https://dice.fm/artist/las-petunias-v8krl"
```
```

--------------------------------

### Response Example - Ticketmaster

Source: https://ticketsdata.com/docs

Shows the response structure for a Ticketmaster request. The outer envelope (status, platform, body, response_s, quota_remaining) is consistent across platforms, while the body contains platform-specific nested structures.

```APIDOC
## Response Example - Ticketmaster

### Description
Example response from the Ticketmaster platform. The outer envelope is consistent across all platforms, while the body contains platform-specific nested structures.

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code
- **platform** (string) - Platform identifier (e.g., "ticketmaster")
- **body** (object) - Platform-specific response body
  - **_embedded** (object) - Embedded data
    - **offer** (array) - List of offers
      - **offerId** (string) - Offer identifier
      - **section** (string) - Section name
      - **row** (string) - Row identifier
      - **listPrice** (string) - List price as string
      - **totalPrice** (number) - Total price
      - **inventoryType** (string) - Inventory type (e.g., "resale")
      - **sellableQuantities** (array) - List of sellable quantities
- **response_s** (number) - Response time in seconds
- **quota_remaining** (integer) - Remaining quota

#### Response Example
```json
{
  "status": 200,
  "platform": "ticketmaster",
  "body": {
    "_embedded": {
      "offer": [
        {
          "offerId": "GN6DCMJVGU4DOOBYGAZHYMJXMY3TOZLFMI4TK",
          "section": "605",
          "row": "-",
          "listPrice": "380.00",
          "totalPrice": 459.80,
          "inventoryType": "resale",
          "sellableQuantities": [1, 2, 3, 4]
        }
      ]
    }
  },
  "response_s": 2.14,
  "quota_remaining": 117382
}
```
```

--------------------------------

### Connect Claude Code to TicketsData MCP server

Source: https://ticketsdata.com/docs

Run this command once in a terminal to add the TicketsData MCP server to Claude Code. Replace YOUR_MCP_API_KEY with your actual key, which starts with tdmcp_. The server uses Streamable HTTP and provides read-only tools.

```bash
claude mcp add --transport http ticketsdata https://mcp.ticketsdata.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_API_KEY"
```

--------------------------------

### GET /match

Source: https://ticketsdata.com/docs

The match endpoint is TicketsData's flagship intelligence feature. Pass a single event URL from any supported marketplace to receive a full cross-market intelligence report including per-section arbitrage spreads, fee burdens, cheapest entry points, and recommendations.

```APIDOC
## GET /match

### Description
The match endpoint is TicketsData's flagship intelligence feature. Pass a single event URL from any supported marketplace — the engine identifies the same event across all other platforms, fetches live inventory from each simultaneously, normalizes the data into a unified schema, and returns a full cross-market intelligence report including per-section arbitrage spreads, fee burdens, cheapest entry points, and recommendations.

### Method
GET

### Endpoint
https://ticketsdata.com/match

### Parameters
#### Query Parameters
- **username** (string) - Required - Your TicketsData account email
- **password** (string) - Required - Your TicketsData account password
- **event_url** (string) - Required - Full event URL from any supported marketplace (SeatGeek, StubHub, VividSeats, Gametime, TickPick, Ticketmaster, Viagogo). The engine auto-detects the source platform and finds matching URLs on all others.

### Request Example
GET https://ticketsdata.com/match?username=YOUR_EMAIL&password=YOUR_PASSWORD&event_url=https://seatgeek.com/cardi-b-tickets/atlanta-georgia-state-farm-arena-1-2026-04-18-7-30-pm/concert/17762666

### Response
#### Success Response (200)
- **status** (string) - success or error
- **match_type** (string) - probable or exact — confidence of cross-platform match
- **match_confidence** (number) - 0–100 confidence score for the cross-platform match
- **match_reason** (array) - List of signals used to confirm the match (same date, venue key, entity ID, etc.)
- **event_details** (object) - Resolved event: date, venue name, candidate ID
- **matches** (object) - Map of platform → matched event URL for each marketplace
- **fetch_results.normalized** (object) - Unified listing schema per platform: section_norm, zone, price_prefee, price_total, fees_total, fee_ratio, deal_score, flags
- **fetch_results.intelligence.market_summaries** (object) - Per-platform: listing count, cheapest entry (pre-fee and total), price stats (min/median/max), fee stats, zone distribution, top sections
- **fetch_results.intelligence.cross_market_snapshot** (object) - Best entry price and deepest market across all platforms simultaneously
- **fetch_results.intelligence.section_arbitrage** (array) - Per section: best vs worst marketplace, spread in $ and %, zone tag
- **fetch_results.intelligence.recommendations** (object) - Cheapest entry marketplaces, highest fee burden, deepest markets, primary vs resale split
- **response_s** (number) - Total elapsed seconds for all parallel fetches
- **reports_remaining** (number) - Remaining Market Intelligence reports this billing cycle

#### Response Example
(No explicit response example provided in the source.)
```

--------------------------------

### list_marketplaces

Source: https://ticketsdata.com/docs

Lists supported marketplaces, the URL or ID format each one expects, and valid mode values. This tool is free and does not count toward the daily cap.

```APIDOC
## list_marketplaces

### Description
Lists supported marketplaces, the URL or ID format each one expects, and valid mode values. This tool is free and does not count toward the daily cap.

### Method
MCP Tool Call

### Endpoint
list_marketplaces

### Parameters
None

### Response
Returns a list of marketplaces with their expected URL or ID formats and valid mode values.

### Response Example
(No example provided in source)
```

--------------------------------

### compare_marketplaces

Source: https://ticketsdata.com/docs

Matches one event and prices it across every marketplace, with per-section spreads. This tool costs 1 report plus up to 12 credits and is available on Pro plan and above.

```APIDOC
## compare_marketplaces

### Description
Matches one event and prices it across every marketplace, with per-section spreads. This tool costs 1 report plus up to 12 credits and is available on Pro plan and above.

### Method
MCP Tool Call

### Endpoint
compare_marketplaces

### Parameters
- **event URL** (string) - Required - The URL of the event to compare.

### Response
Returns the complete API response from `/match`, including per-section price spreads across marketplaces.

### Response Example
(No example provided in source)
```

--------------------------------

### Limits & Concurrency

Source: https://ticketsdata.com/docs

Explains how quota and concurrency limits work across shared and dedicated plans.

```APIDOC
## Limits & Concurrency

### Description
This section explains how quota and concurrency limits work across different plans.

### Quota
Each API call consumes one credit from your plan quota. Quota resets monthly on your billing cycle date.

### Concurrency Limits
Concurrency limits vary by plan — shared plans apply fair-use controls while dedicated plans run on isolated infrastructure with no shared throttling.

#### Shared Plans
Keep concurrency moderate (5–15 simultaneous requests). Avoid sudden spikes. Multiple targets on the same event and interval count as a single monitoring request.

#### Dedicated Plans
Dedicated instances remove shared throttles and support high sustained parallelism. Best for high-volume monitoring, bulk fetching, and production workloads.
```

--------------------------------

### Sample JSON response envelope from /fetch

Source: https://ticketsdata.com/docs

Shows the standard response structure for the /fetch endpoint. The body contains ticket listings under _embedded.offer, with fields like offerId, section, row, listPrice, totalPrice, inventoryType, and sellableQuantities. Check status for success or failure.

```json
{
  "status":    200,
  "platform":  "ticketmaster",
  "body": {
    "_embedded": {
      "offer": [
        {
          "offerId":   "GN6DCMJVGU4DOOBYGAZHYMJXMY3TOZLFMI4TK",
          "section":   "605",
          "row":       "-",
          "listPrice": "380.00",
          "totalPrice": 459.80,
          "inventoryType": "resale",
          "sellableQuantities": [1, 2, 3, 4]
        }
      ]
    }
  },
  "response_s":      2.14,
  "quota_remaining": 117382
}
```

--------------------------------

### get_event_listings

Source: https://ticketsdata.com/docs

Retrieves live listings for one event on one marketplace, including section, row, quantity, price, and fees. This tool costs 1 credit per call.

```APIDOC
## get_event_listings

### Description
Retrieves live listings for one event on one marketplace, including section, row, quantity, price, and fees. This tool costs 1 credit per call.

### Method
MCP Tool Call

### Endpoint
get_event_listings

### Parameters
- **event URL** (string) - Required - The URL of the event on the marketplace.
- **marketplace** (string) - Required - The marketplace identifier or URL.

### Response
Returns the complete API response from `/fetch`, including listings with fields such as `section`, `row`, `quantity`, `price`, `fees`, and `price_total`.

### Response Example
(No example provided in source)
```

--------------------------------

### analyze_listings

Source: https://ticketsdata.com/docs

Filters, sorts, and summarizes all listings of a result the assistant already fetched. This tool is free and does not count toward the daily cap.

```APIDOC
## analyze_listings

### Description
Filters, sorts, and summarizes all listings of a result the assistant already fetched. This tool is free and does not count toward the daily cap.

### Method
MCP Tool Call

### Endpoint
analyze_listings

### Parameters
- **listings** (array) - Required - The listings data previously fetched by the assistant.
- **filters** (object) - Optional - Filters to apply, such as section, row, quantity, price range.
- **sort** (string) - Optional - Sorting criteria, e.g., by all-in price.

### Response
Returns a summary of the listings, including cheapest per section, counts, medians, and other statistics.

### Response Example
(No example provided in source)
```

--------------------------------

### Authenticate with query parameters

Source: https://ticketsdata.com/docs

Pass your TicketsData account email and password as query parameters to authenticate API requests. Use HTTPS and store credentials in environment variables; never hardcode or log full request URLs.

```http
GET https://ticketsdata.com/fetch?username=YOUR_EMAIL&password=YOUR_PASSWORD&platform=…&event_url=…
```

--------------------------------

### Error Codes & Status Codes

Source: https://ticketsdata.com/docs

Lists all HTTP status codes and error codes returned by the API, with meanings and recommended actions.

```APIDOC
## Error Codes & Status Codes

### Description
This section lists all HTTP status codes and error codes that the API may return, along with their meanings and recommended actions.

### Status Codes

| HTTP Status | Error Code | Meaning & Recommended Action |
|-------------|------------|------------------------------|
| 200 | — | Success. Parse body for listings. |
| 400 | `invalid_url` | Malformed or unrecognized event URL. Check the URL format for the given platform. |
| 400 | `performer_not_found` | /events — performer page not found or URL not recognized. |
| 401 | — | Invalid credentials. Check username and password. |
| 402 | `quota_exceeded` | Your plan quota is exhausted. Upgrade or wait for renewal. |
| 404 | `event_not_found` | Event no longer exists or has been removed from the marketplace. |
| 429 | — | Rate limited. Back off and retry after a few seconds. |
| 500 | `config_error` | Server configuration error. Contact support. |
| 503 | `service_unavailable` | Marketplace temporarily unavailable. Retry with exponential backoff. |
| 504 | `timeout` | Request timed out. The marketplace may be slow — retry once. |

### Retry Strategy
Retry `service_unavailable` and `timeout` errors up to 2 times with increasing delays (1.5s, 3s). All other errors are deterministic — retrying won't help.
```

--------------------------------

### find_events

Source: https://ticketsdata.com/docs

Finds upcoming events for a performer, team, organizer, or venue page. This tool costs 1 credit per call.

```APIDOC
## find_events

### Description
Finds upcoming events for a performer, team, organizer, or venue page. This tool costs 1 credit per call.

### Method
MCP Tool Call

### Endpoint
find_events

### Parameters
- **performer/team/organizer/venue URL** (string) - Required - The URL of the performer, team, organizer, or venue page.

### Response
Returns the complete API response from `/events`, including a list of upcoming events.

### Response Example
(No example provided in source)
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.