# Vivid Seats Event API Documentation

<p><strong>Vivid Seats Event API Documentation</strong> Get one Vivid Seats event by numeric id or public URL. The response has performers, venue with coordinates, ISO dates, minimum, maximum, average and median price with currency, listing and ticket counts, and a public section-level price summary with the top deals. Set include_listings to true to add public section-level ticket data when the source publishes it; many events publish none, so section rows stay empty and available is false while any public top deals are still returned. lowest_price is the real price or null. Costs 1 credit per request. Errors cost nothing.</p>

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

## 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 |
| --- | --- | --- | --- |
| `id` | string | No | Numeric production id from Vivid Seats search. Use instead of url. |
| `url` | string | No | Public Vivid Seats production URL or web path. Use instead of id. |
| `include_listings` | string | No | Set to true to add public section-level listings. Defaults to false. |

## Example response

```json
{
    "data": {
        "event": {
            "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"
            },
            "listings": {
                "groups": [],
                "summary": {
                    "top_deals": [
                        {
                            "row": "A",
                            "price": {
                                "amount": 39.5,
                                "currency": "USD"
                            },
                            "section": "Floor"
                        }
                    ]
                },
                "tickets": [],
                "sections": [],
                "available": false
            },
            "local_date": "2026-12-01T20:00:00-05:00",
            "performers": [
                {
                    "id": "3269",
                    "name": "Example Performer",
                    "primary": true
                }
            ],
            "ticket_count": 536,
            "listing_count": 203
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "event"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The requested Vivid Seats resource was not found. |  |

## 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)
