# Vivid Seats Event Search API Documentation

<p><strong>Vivid Seats Event Search API Documentation</strong> Browse Vivid Seats events by the filters the public page honours: category, upstream page and page size. Each event has its id, name, ISO date, venue with city and coordinates, performers, minimum, maximum, average and median price with currency, listing count and ticket count. total_results is the upstream total; total_pages is computed for the requested page size; page_size is the real count of returned events. A page past the last returns an empty list with has_more false. Keyword, city and date filters are not accepted because the public browse page cannot apply them to the full result set. Costs 1 credit per request. A response without data and every error cost nothing.</p>

- **Documentation:** [https://scrappa.co/docs/vividseats-api/vividseats_events_search](https://scrappa.co/docs/vividseats-api/vividseats_events_search)
- **API group:** Vivid Seats API
- **Endpoint:** `GET https://scrappa.co/api/vividseats/events/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | No | One of concerts, sports, theatre, comedy. Defaults to concerts. |
| `page` | string | No | Upstream page number; page 1 is the first and 1000 is the maximum. A page past the last one returns an empty list with has_more false and is not billed. Defaults to 1. |
| `page_size` | string | No | One of 1, 2, 4, 5, 10 or 20. Pages map exactly onto the upstream 20-item list with no skipped events. Defaults to 20. Other values return 422. |

## Example response

```json
{
    "data": {
        "results": [
            {
                "id": "7320473",
                "url": "https://www.vividseats.com/example-tickets/production/7320473",
                "name": "Example Live Event",
                "start": "2026-12-01T20:00:00+00:00",
                "venue": {
                    "id": "1284",
                    "city": "Las Vegas",
                    "name": "Example Hall",
                    "state": "NV",
                    "latitude": 36.1,
                    "longitude": -115.1
                },
                "prices": {
                    "max": {
                        "amount": 250,
                        "currency": "USD"
                    },
                    "min": {
                        "amount": 39.5,
                        "currency": "USD"
                    },
                    "median": {
                        "amount": 80,
                        "currency": "USD"
                    },
                    "average": {
                        "amount": 95,
                        "currency": "USD"
                    },
                    "currency": "USD"
                },
                "local_date": "2026-12-01T20:00:00-05:00",
                "performers": [
                    {
                        "id": "3269",
                        "name": "Example Performer",
                        "primary": true
                    }
                ],
                "ticket_count": 536,
                "listing_count": 203
            }
        ],
        "pagination": {
            "page": 1,
            "has_more": true,
            "page_size": 20,
            "total_pages": 50,
            "result_count": 2,
            "total_results": 1000
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "events_search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Validation failed. page_size must be one of 1, 2, 4, 5, 10, 20. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
