Search Event
get
Search Event
Resource URL
https://api.stubcloudprod.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
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 CodeError CodeDescription
-
404404
Incorrect event ID, or event is invalid / expired
-
401401
Not authorized to access the listing
-
403403
Forbidden
-
400400
Bad request
Resource Summary |
|
Security |
|
Content Type |
application/json |
Category |
Search Events |
Working...