Skip to content
Scrappa Get API key
Vivid Seats API 1 credit / request

Vivid Seats Event Search API Documentation

GET https://scrappa.co/api/vividseats/events/search

Vivid Seats Event Search API Documentation 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.

Vivid Seats Event Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/vividseats/events/search
Auth header
x-api-key
Cost
1 credit / request
Response preview
200 OK
{
    "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,
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

3 optional filters available.

category string Optional

One of concerts, sports, theatre, comedy. Defaults to concerts.

Example value example
page string Optional

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.

Example value 1
page_size string Optional

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 value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

422

HTTP 422

Validation failed. page_size must be one of 1, 2, 4, 5, 10, 20.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.