# StubHub Event ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/stubhub/event` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/stubhub-event | ## Description Read one StubHub event from its URL or numeric id, including the lowest printed ticket price. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/stubhub/event' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Harlem Globetrotters, Marseille ```json { "id": "162387399", "url": "https://www.stubhub.com/harlem-globetrotters-marseille-tickets-3-31-2027/event/162387399/", "date": null, "name": "Harlem Globetrotters", "time": null, "year": null, "image": "https://img.vggcdn.net/img/cat/11035/3/1.jpg", "price": 68, "country": "France", "currency": "EUR", "start_at": "2027-03-31T19:00:00", "venue_city": "Marseille", "venue_name": "Palais des Sports de Marseille", "day_of_week": null, "description": "Acheter et vendre Billets Harlem Globetrotters pour mars 31 à Palais des Sports de Marseille à Marseille sur StubHub ! Les billets sont couverts à 100 % par la Garantie FanProtect", "country_code": null, "price_display": "68,00 €", "venue_location": "81 rue Raymond Teisseire, 13009, Marseille, France", "is_parking_event": null, "has_active_listings": true } ``` ## Documentation ## Overview Read one StubHub event and the lowest ticket price printed on the page. Send `results[].url` from search, or the numeric event id. The response is a flat object. `id` matches the search card. `price` is the lowest printed ticket and `price_display` is rebuilt from it with two decimals, such as `68` and `68,00 €`. Search cards leave the price null. The search card keeps `date`, `time`, `day_of_week`, `year`, `country_code`, and `is_parking_event`. This response leaves those null. It adds `start_at`, the street in `venue_location`, and `image` plus `description` when the page has them. ## Quickstart ``` GET https://api.piloterr.com/v2/stubhub/event?query=162387399 ``` ``` GET https://api.piloterr.com/v2/stubhub/event?query=https://www.stubhub.com/harlem-globetrotters-marseille-tickets-3-31-2027/event/162387399/ ``` `query` is required. It is an event URL (`/event/`) or a numeric id. A keyword returns 400. ## Parameters | Parameter | Required | Example | |---|---|---| | `query` | yes | `162387399` | ## Response fields | Field | Type | Meaning | |---|---|---| | `id` | string | Same id as the search card | | `url` | string | Event URL | | `name` | string | Event name | | `price` | number or null | Lowest printed ticket price | | `price_display` | string or null | That label, such as `68,00 €` | | `currency` | string or null | `EUR`, `USD`, or `GBP` from the label | | `venue_name` | string or null | Venue | | `venue_city` | string or null | City | | `venue_location` | string or null | Street, postcode, city, country | | `country` | string or null | Country | | `country_code` | string or null | Country code when present | | `start_at` | string or null | Start time, such as `2027-03-31T19:00:00` | | `date` | string or null | Date label when the page prints one | | `time` | string or null | Time label when the page prints one | | `day_of_week` | string or null | Weekday | | `year` | string or null | Year | | `image` | string or null | Event image | | `description` | string or null | Short page description | | `has_active_listings` | boolean or null | True when a printed price was found | | `is_parking_event` | boolean or null | Parking flag when present | There is no `results` wrapper. ## Use cases - Quote the lowest printed price for an event id you collected from search, and check that `name` matches. - Store `venue_location` and `start_at` on a calendar row. - Compare `price` with `price_display` before showing the figure to a client. ## Error codes | Code | Meaning | |---|---| | `400` | Missing id, a host other than stubhub.com, or a URL that is not an event | | `401` | Missing API key | | `404` | The page had no event name | | `500` | The fetch failed | ## Related endpoints [StubHub Search](https://www.piloterr.com/library/stubhub-search)