StubHub API endpoint
Discovers events near a location within a date range, optionally bounded by ticket price and by category. A zero count with an empty events list is a valid no-results response.
/stubhub/exploreQuery parameters:
lat: required. Latitude, -90 to 90.lon: required. Longitude, -180 to 180.from: optional. Start of the date range -- RFC3339 (2026-09-15T00:00:00Z) or a bare date (2026-09-15). Defaults to now.to: optional. End of the date range, same accepted formats as from. Defaults to 14 days after from. Must be after from, and the range must not exceed 365 days.price_min: optional. Minimum ticket price filter, whole units of StubHub's local display currency for the request's region.price_max: optional. Maximum ticket price filter.top_level_category_id: optional. Filter to one top-level vertical. Defaults to 0.category_id: optional. Filter to one category/subcategory id. stubhub_categories discovers ids with a currently-listed event near the given location/date, but its own list is a small "trending near you" subset, not the full taxonomy -- a handful of known-good ids across every top-level vertical: NBA 6453, MLB 6456, NFL 5084, NHL 4871, MLS 5062, Tennis 1012, Golf 1009, College Sports 263024 (Sports); Pop/Rock 260542, Alternative Music 1059, Classical 1014, R&B 1027, Rap and Hip-Hop Music 1026, Dance and Electronic Music 1022, Country and Folk Music 1205 (Concerts); Comedy 1015, Musicals 1017, Plays 358959, Dance / Ballet 1013, Family 2294 (Theater); Festival Tickets 1023 (works as category_id alone, with no top_level_category_id needed).top_level_category_id accepts one of:
0 (all categories)1 (Theater)2 (Sports)3 (Concerts)Returns events StubHub's own "explore" feed surfaces near the given location within the date range: name, canonical URL, image, venue and formatted location, day/date/time, and whether the event currently has active ticket listings. A zero count with an empty events list is a valid no-results response.
Notable response behavior:
stubhub_categories for category-level minimum prices.has_active_listings reflects StubHub's own flag for whether any tickets are currently for sale; some events (e.g. a just-announced show) may appear with it false.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| event_id | 20 | |
| name | 20 | “Dog Man: The Musical” and 19 other values |
| url | 20 | stubhub.com |
| image_url | 20 | media.stubhubstatic.com |
| category_id | 20 | |
| venue_name | 20 | “Kirk Douglas Theatre” and 18 other values |
| location | 20 | Los Angeles, CA, USA (13), Anaheim, CA, USA (2), Culver City, CA, USA (1) and 4 more |
| day_of_week | 20 | Tue in all 20 |
| date | 20 | Oct 13 in all 20 |
| time | 20 | “11:00 AM” and 8 other values |
| is_date_confirmed | 20 | true in 20 of 20 |
| is_time_confirmed | 20 | true in 20 of 20 |
| has_active_listings | 20 | true in 0 of 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| lat | number | Yes | Latitude, -90 to 90 | 34.0549076 | |
| lon | number | Yes | Longitude, -180 to 180 | -118.242643 | |
| from | string | No | now | Start of the date range: RFC3339 or a bare date (e.g. 2026-09-15). Defaults to now. | 2026-09-15 |
| to | string | No | 14 days after from | End of the date range, same accepted formats as from. Defaults to 14 days after from. | 2026-09-29 |
| price_min | integer | No | Minimum ticket price filter | ||
| price_max | integer | No | Maximum ticket price filter | ||
| top_level_category_id | integer | No | Filter to one top-level vertical Allowed values: 0, 1, 2, 3. | ||
| category_id | integer | No | Filter to one category/subcategory id. stubhub-categories discovers ids with a currently-listed event nearby, but only a small subset -- known-good ids: NBA 6453, MLB 6456, NFL 5084, NHL 4871, MLS 5062, Tennis 1012, Golf 1009 (Sports); Pop/Rock 260542, Alternative Music 1059, Classical 1014, R&B 1027, Rap and Hip-Hop Music 1026 (Concerts); Comedy 1015, Musicals 1017, Plays 358959, Family 2294 (Theater); Festival Tickets 1023 (works alone, no top_level_category_id needed) | 6453 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/stubhub/explore?lat=34.0549076&lon=-118.242643&top_level_category_id=0" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"lat": 34.0549076,
"lon": -118.242643,
"from": "2026-09-15T00:00:00Z",
"to": "2026-09-29T00:00:00Z",
"count": 1,
"source_url": "https://www.stubhub.com/explore?method=getExploreEvents&from=1789430400000&lat=MzQuMDU0OTA3Ng==&lon=LTExOC4yNDI2NDM=&to=1790640000000",
"fetched_at": "2026-09-15T04:00:00Z",
"events": [
{
"event_id": 161341819,
"name": "SoFi Stadium Tours",
"url": "https://www.stubhub.com/sofi-stadium-tour-inglewood-tickets-9-15-2026/event/161341819/",
"image_url": "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/1/SHTheater-Fallback1",
"category_id": 150041313,
"venue_name": "SoFi Stadium",
"location": "Inglewood, CA, USA",
"day_of_week": "Tue",
"date": "Sep 15",
"time": "10:00 AM",
"is_date_confirmed": true,
"is_time_confirmed": true,
"has_active_listings": false
}
]
}
}Request schema
No body schema
Response schema
#/definitions/stubhub.exploreResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | stubhub.ExploreResponse | No | ||||
| data.count | integer | No | 20 | |||
| data.events | array | No | ||||
| data.events[].category_id | integer | No | 5084 | |||
| data.events[].date | string | No | Sep 15 | |||
| data.events[].day_of_week | string | No | Tue | |||
| data.events[].event_id | integer | No | 161341819 | |||
| data.events[].has_active_listings | boolean | No | ||||
| data.events[].image_url | string | No | ||||
| data.events[].is_date_confirmed | boolean | No | ||||
| data.events[].is_time_confirmed | boolean | No | ||||
| data.events[].location | string | No | Inglewood, CA, USA | |||
| data.events[].name | string | No | Taylor Swift | |||
| data.events[].time | string | No | 10:00 AM | |||
| data.events[].url | string | No | ||||
| data.events[].venue_name | string | No | SoFi Stadium | |||
| data.fetched_at | string | No | ||||
| data.from | string | No | ||||
| data.lat | number | No | ||||
| data.lon | number | No | ||||
| data.source_url | string | No | ||||
| data.to | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/stubhub/explore?lat=34.0549076&lon=-118.242643&top_level_category_id=0" \
-H "x-api-key: $CRAWLORA_API_KEY"