Search Event

Search Event

get

Search Event

The Search Catalog Events API v3 retrieves information about the events that are defined in the StubHub catalog. An event is a concert, sporting match, festival, or other occasion for which tickets can be sold and purchased through StubHub.

Resource URL

https://api.stubhub.com/sellers /search/events/v3

Query Parameters


Name Values Description
q

A query parameter string describing the event for a fuzzy logic search. Example: q=ufc

id

The event id to search on.

name

Search by name of the event

date

Search by date of the event. This is string describing the event date in UTC timezone. For now this just supports a date or date range string in the formats: - Single Date: `yyyy-MM-dd'T'HH:mm` or `yyyy-MM-dd`. This will return events whose event date (in UTC) is later than the one provided in this parameter - Date Range: `yyyy-MM-dd'T'HH:mm TO yyyy-MM-dd'T'HH:mm` or `yyyy-MM-dd TO yyyy-MM-dd`. This will return events whose event date (in UTC) is in the date range. Range limits are inclusive. There is currently no support for open-ended ranges.

dateLocal

Search by date of the event. This is string describing the event date in Local timezone. For now this just supports a date or date range string in the formats: - Single Date: `yyyy-MM-dd'T'HH:mm` or `yyyy-MM-dd`. This will return events whose event date (in local timezone) is later than the one provided in this parameter - Date Range: `yyyy-MM-dd'T'HH:mm TO yyyy-MM-dd'T'HH:mm` or `yyyy-MM-dd TO yyyy-MM-dd`. This will return events whose event date (in local timezone) is in the date range. Range limits are inclusive. There is currently no support for open-ended ranges. - Weekday: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday. This will return events whose event date falls on that weekday.

venue

The name of the venue at which the event occurs.

venueId

StubHub venue ID to search on. This query parameter supports OR (|) and NOT (-) operators. For example, `venueId=82 |102112269` returns events for Oracle Park (venueId=82) and Chase Center (venueId=102112269)

city

The name of the city in which the event occurs. For city names with multiple words, dont need to use quotes. For example, `city=Santa Clara`

state

The name of the state in which the event occurs.

country

The code of the country in which the event occurs.

categoryName

The name of the category to which the event belongs

performerName

The name of the performer

performerId

StubHub performer ID to search on. This query parameter supports OR (|) and NOT (-) operators. For example, `performerId=199 |136` will return events for San Francisco 49ers (performerId=199) and Golden State Warriors (performerId=136)

parking

Whether to include parking events in the response. true means include parking events.

minAvailableTickets

The minimum number of tickets available for sale for the specified event.Default is 0

start

Returns results starting from the specified index. Default is 0

rows

The number of results to return, max=500. For example, rows=20. Default is 10.

sort

Parameter to support sorting. For ascending use 'asc' and for descending use 'desc'. Comma can be used as a separator to sort by multiple fields. Following are the fields on which we can use for sorting - title, distance, minPrice, eventDateLocal (e.g `title asc,eventDateLocal desc,distance asc`)


Header Parameters


Name Values Description
Authorization
(required)

To generate an access token, use the [generateToken API](https://developer.stubhub.com/oauth/apis/post/accesstoken). Note that you will need to add a 'Bearer ' prefix to your access token. Otherwise, you'll get an 'Invalid Access Token' error

Accept
(required)

application/json

Request Body

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 404
    404

    Incorrect event ID, or event is invalid / expired

  • 401
    401

    Not authorized to access the listing

  • 403
    403

    Forbidden

  • 400
    400

    Bad request

Resource Summary

Security

Content Type

application/json

Category

Search Events

Working...