StubHub Event Search API Documentation Find StubHub events around a city or coordinates with a start and end date and a category (theatre, sports, concerts), or by keyword (first page of 20 only). Each event has the id, name, page URL, start (local time), venue, city and image. A keyword search also returns venues (distinct venues of the results) and performers (StubHub matches, often empty). StubHub shows prices and listings only behind a bot wall, so this endpoint returns no ticket prices. Only events that start on a requested day are returned, so a page can hold fewer events than shown in total. A place search has pages; a keyword search has page 1 only and answers 422 for a higher page. A page without events is a 200 response. Costs 1 credit per request. A response without data and every error cost nothing.
Run this endpoint
Endpoint
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.
8 optional filters available.
string
Optional
Keyword such as an artist or team. First page only. Not together with city, lat/lng or category.
coffee shops
string
Optional
City from the supported list, e.g. Chicago, London, Toronto, Berlin, Sydney. Not together with lat/lng or q.
example
number
Optional
Latitude of the search center. Needs lng.
10
number
Optional
Longitude of the search center. Needs lat.
10
string
Optional
First day, YYYY-MM-DD. Defaults to today.
2026-06-15
string
Optional
Last day, YYYY-MM-DD. Defaults to no end.
2026-06-15
string
Optional
One of theatre, sports, concerts. Place search only.
example
integer
Optional
Page number, from 1. Defaults to 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"results": [
{
"id": "161795729",
"url": "https://www.stubhub.com/common-people-chicago-tickets-11-8-2026/event/161795729/",
"name": "Common People",
"image": "https://media.stubhubstatic.com/stubhub-v2-catalog/d_defaultLogo.jpg/q_auto:low,f_auto,c_fill,g_auto,w_280,h_170,dpr_2.0/categories/1023/SHFestival-Fallback1",
"start": "2026-11-08T18:00:00",
"venue": {
"id": "30978",
"city": "Chicago",
"name": "Cobra Lounge",
"state": null,
"location": "Chicago, IL, USA",
"country_code": null
},
"is_tbd": false,
"category": "concerts",
"start_utc": null,
"start_date": "2026-11-08",
"start_time": "18:00",
"is_date_confirmed": true,
"is_time_confirmed": true
},
{
"id": "161873770",
"url": "https://www.stubhub.com/suzy-sheer-chicago-tickets-11-8-2026/event/161873770/",
"name": "Suzy Sheer",
"image": "https://media.stubhubstatic.com/stubhub-v2-catalog/d_defaultLogo.jpg/q_auto:low,f_auto,c_fill,g_auto,w_280,h_170,dpr_2.0/categories/259817/48855",
"start": "2026-11-08T18:30:00",
"venue": {
"id": "150069596",
"city": "Chicago",
"name": "Outset",
"state": null,
"location": "Chicago, IL, USA",
"country_code": null
},
"is_tbd": false,
"category": "concerts",
"start_utc": null,
"start_date": "2026-11-08",
"start_time": "18:30",
"is_date_confirmed": true,
"is_time_confirmed": true
}
],
"pagination": {
"page": 1,
"has_more": true,
"page_size": 20,
"total_results": 1272
}
},
"meta": {
"billable": true,
"endpoint_family": "events_search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing, invalid, not supported by this endpoint or cannot be combined with another one. This response is not billable.
{
"errors": {
"q": [
"Send q, city, or lat and lng."
]
},
"message": "The request validation failed"
}Not Found
StubHub has no such record, or it has ended. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "events_search"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested StubHub resource was not found."
},
"success": false
}Upstream Unavailable
StubHub did not answer after several attempts. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "events_search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The StubHub API is temporarily unavailable. Please retry."
},
"success": false
}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.