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: One Date: yyyy-MM-dd'T'HH:mm or yyyy-MM-dd (this is the utc event date), we will return events which UTC date is later than the date Range: yyyy-MM-dd'T'HH:mm TO yyyy-MM-dd'T'HH:mm or yyyy-MM-dd TO yyyy-MM-dd. There is currently no support for open-ended ranges. Range limits are inclusive. This is the event date in UTC timezone, we will return events which UTC date is in the date range

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: One Date: yyyy-MM-dd'T'HH:mm or yyyy-MM-dd (this is the local event date), we will return events which local date is later than the date Range: yyyy-MM-dd'T'HH:mm TO yyyy-MM-dd'T'HH:mm or yyyy-MM-dd TO yyyy-MM-dd. There is currently no support for open-ended ranges. Range limits are inclusive. This is the event date in Local timezone, we will return events which local date is in the date range Weekday: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday

venue

The name of the venue at which the event occurs.

city

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

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

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, radius, minPrice, date. (e.g title asc,date desc)


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...