Viagogo APIviagogo.com ↗
Access Viagogo event listings, ticket prices, performer schedules, and category data via 4 structured API endpoints. Get real-time pricing and availability.
What is the Viagogo API?
The Viagogo API covers 4 endpoints for searching live events, retrieving performer schedules, fetching ticket listings with per-listing pricing and deal scores, and browsing category hierarchies. The get_event_ticket_listings endpoint returns structured fields including section, row, price, quantity, ticket_class, and deal_score for every available listing on a given event page, giving developers direct access to Viagogo's secondary ticket market data.
curl -X GET 'https://api.parse.bot/scraper/f1e29361-6672-4dc7-8cb8-b6004b8e9c09/search_events?query=concerts' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace viagogo-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.viagogo_ticket_marketplace_api import Viagogo, Performer, Event, Ticket, Category
viagogo = Viagogo()
# Search for performers
for performer in viagogo.performers.search(query="Hamilton"):
print(performer.title, performer.url, performer.type)
# Get upcoming events for the first performer found
for event in performer.events.list():
print(event.name, event.date, event.time, event.venue, event.city, event.country)
# Get ticket listings for events with active listings
if event.has_active_listings:
for ticket in event.tickets.list(limit=5):
print(ticket.section, ticket.row, ticket.price, ticket.raw_price, ticket.quantity, ticket.deal_score)
break
break
# Browse categories
for category in viagogo.categories.list(url="/Sports-Tickets/C/2"):
print(category.id, category.title)
Full-text search across performers and events on Viagogo. Returns a list of matching performers with their page URLs for further drill-down. Results may reflect trending/featured items rather than exact query matches for broad queries. Each result includes a URL that can be passed to get_performer_events after stripping the base URL prefix.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'Hamilton', 'Yankees', 'Taylor Swift'). |
{
"type": "object",
"fields": {
"items": "array of search result objects containing id, title, url, type, and image_url",
"query": "string, the original search query echoed back"
},
"sample": {
"data": {
"items": [
{
"id": 177764,
"url": "https://www.viagogo.com/Theater-Tickets/Comedy/Matt-Rife-Tickets",
"type": "performer",
"title": "Matt Rife",
"image_url": "https://media.stubhubstatic.com/stubhub-v2-catalog/d_vgg-defaultLogo.jpg/q_auto:low,f_auto,c_thumb,g_auto,w_108,h_108/categories/177764/6582698"
}
],
"query": "Taylor Swift"
},
"status": "success"
}
}About the Viagogo API
Search and Discovery
The search_events endpoint accepts a query string — an artist name, team, show title, or general keyword — and returns an array of matching items, each with an id, title, url, type, and image_url. Results reflect Viagogo's ranking logic and may surface trending or featured items alongside exact matches. The url field from each result is the input you'll pass into downstream endpoints.
Performer Schedules
get_performer_events takes a performer URL path (e.g., /Concert-Tickets/Pop/Taylor-Swift-Tickets) and returns a paginated list of upcoming events. Each event object includes name, date, time, day_of_week, venue, city, state, country, location, url, min_price, and a has_ac flag. The total field at the top level gives the count of all upcoming events for that performer, which is useful for pagination planning.
Ticket Listings
get_event_ticket_listings takes an event URL path and returns the full listing inventory for that event. Each listing exposes section, row, price, raw_price, quantity, ticket_class, ticket_type, and deal_score. The response also surfaces min_price, max_price, and total_listings at the top level. Note that event IDs expire over time — the endpoint documentation recommends sourcing event URLs from get_performer_events rather than constructing them manually.
Category Navigation
get_category_listings accepts a category URL path such as /Sports-Tickets/C/2 and returns the category_id, category_name, an array of subcategories (each with id and title), and the full list of all_top_level_categories on the site. This makes it straightforward to build a category browser or discover available subcategories without prior knowledge of Viagogo's taxonomy.
The Viagogo API is a managed, monitored endpoint for viagogo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when viagogo.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official viagogo.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track minimum ticket prices for upcoming concerts by polling get_performer_events across multiple artists
- Build a ticket price alert system using min_price and max_price from get_event_ticket_listings
- Aggregate performer schedules by city using the city and country fields from get_performer_events
- Compare deal_score across listings for a single event to surface the best-value tickets
- Enumerate Viagogo's full event taxonomy using get_category_listings to map top-level and subcategories
- Monitor total_listings count over time to gauge demand or supply changes for a specific event
- Power a venue-based event finder by filtering get_performer_events results on the venue and location fields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.