TicketOne APIticketone.it ↗
Search Italian events, browse by category, retrieve event details, and check real-time ticket availability via the TicketOne.it API. 6 endpoints.
What is the TicketOne API?
The TicketOne.it API provides access to Italy's leading event ticketing platform across 6 endpoints, covering everything from homepage featured events to per-performance ticket availability. Use search_events to find concerts, shows, and festivals by keyword, or get_event_ticket_availability to check stock status, pricing, and purchase links for one or more event IDs in a single call.
curl -X GET 'https://api.parse.bot/scraper/2796dc8a-03b2-45c8-9569-d1228e6e6ac7/get_homepage_featured_events?limit=50&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Get featured and recommended events from the TicketOne homepage. Returns event groups sorted by recommendation priority along with category facets. Each group represents a series of related performances (e.g. a tour) with shared metadata. Paginates with limit (1-50) and offset; offset 0 costs one request, a larger offset walks the upstream 20-item pages that cover the window (up to three requests for limit 50). totalPages counts upstream 20-item pages, not pages of your limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of product groups to return per call; values above 50 are clamped to 50. |
| offset | integer | Number of product groups to skip for pagination. |
{
"type": "object",
"fields": {
"page": "integer upstream 20-item page the window starts on",
"facets": "array of facet groups (categories, recommendations) with counts",
"results": "integer number of results returned in this response",
"totalPages": "integer total upstream 20-item pages available",
"totalResults": "integer total number of results available",
"productGroups": "array of featured event groups with name, dates, pricing, categories, and status"
},
"sample": {
"data": {
"page": 1,
"facets": [
{
"name": "categories",
"facetHierarchicalItems": [
{
"count": 1025,
"value": "Concerti"
}
]
},
{
"name": "recommendations",
"facetItems": [
{
"count": 26,
"value": "true"
}
]
}
],
"results": 20,
"totalPages": 22,
"totalResults": 1942,
"productGroups": [
{
"link": "https://www.ticketone.it/artist/ensemble-symphony-orchestra/alla-scoperta-di-morricone-ensemble-symphony-orchestra-3152591/",
"name": "Alla scoperta di Morricone - Ensemble Symphony Orchestra",
"tags": [
"TICKETDIRECT",
"MOBILE_TICKET",
"FANSALE"
],
"price": 20.7,
"rating": {
"count": 113,
"average": 4.55
},
"status": "Available",
"endDate": "2027-04-01T21:00:00+02:00",
"currency": "EUR",
"imageUrl": "https://www.ticketone.it/obj/media/IT-eventim/teaser/222x222/2026/scoperta-morricone-biglietti-3.jpg",
"startDate": "2026-08-01T21:30:00+02:00",
"categories": [
{
"name": "Concerti"
},
{
"name": "Pop & Rock",
"parentCategory": {
"name": "Concerti"
}
}
],
"description": "Tributo unico alle musiche del grande compositore italiano.",
"productCount": 22,
"productGroupId": "3152591",
"hasRecommendation": true
}
]
},
"status": "success"
}
}About the TicketOne API
What the API Covers
The TicketOne.it API exposes event and ticketing data across Italy. get_homepage_featured_events returns curated event groups sorted by recommendation priority, including facets for categories and recommendation buckets, plus fields like name, dates, pricing, and status. list_events_by_category lets you filter by category, subcategory, city, and a date_from/date_to window, returning product groups with nested performance previews and attraction metadata. list_event_performances goes one level deeper — each row is a single dated show at a specific venue, making it the right endpoint when you need every date and city a tour visits.
Search and Event Details
search_events accepts a free-text query (artist name, venue, event title) and returns individual product listings with productId, name, type, status, location, and categories, along with facets for cities, productTypes, venues, priceRange, and more. Pagination across all list and search endpoints uses limit (clamped to 50) and offset. get_event_details accepts either an event_id for a single product or a product_group_id to retrieve all performances in a group — the two parameters are mutually exclusive.
Ticket Availability
get_event_ticket_availability accepts a comma-separated list of event product IDs (sourced from search_events or get_event_details) and returns a keyed object mapping each ID to its inStock boolean, price, currency, link, and tags. The totalQueried field confirms how many IDs were evaluated. This endpoint is suitable for batch availability checks across multiple events in a single request.
Facets and Filtering
All listing and search endpoints return facets arrays that expose filterable dimensions — cities, venues, categories, price ranges, and recommendation buckets — along with item counts. These counts reflect the full result set, not just the current page window, and can be used to build dynamic filter UIs without additional round-trips.
The TicketOne API is a managed, monitored endpoint for ticketone.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ticketone.it 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 ticketone.it 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?+
- Aggregate all concert dates and venues in a specific Italian city using list_event_performances filtered by city and category
- Build a ticket price tracker by polling get_event_ticket_availability for a watchlist of event IDs and recording price and inStock changes over time
- Power an event discovery app by combining get_homepage_featured_events for curated picks with list_events_by_category for genre-specific browsing
- Check whether multiple events in a user's shortlist still have tickets available in a single get_event_ticket_availability batch call
- Retrieve every individual performance in a touring production by querying get_event_details with a product_group_id
- Surface all upcoming festivals in a date range by calling list_events_by_category with subcategory set to a festival value and a date_from/date_to window
- Populate venue and city facet counts from search_events to build a drill-down filter UI without additional API calls
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.