TicketOne APIticketone.it ↗
Search Italian events, browse by category, get event details, and check real-time ticket availability from TicketOne.it via a single REST API.
What is the TicketOne API?
The TicketOne.it API provides 5 endpoints covering Italy's primary event ticketing platform, returning event listings, category facets, pricing, and per-event ticket availability. Starting with get_homepage_featured_events for curated picks or search_events for keyword-driven queries, you can retrieve productId, status, location, price, currency, and a direct purchase link — all in one call.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/2796dc8a-03b2-45c8-9569-d1228e6e6ac7/get_homepage_featured_events' \ -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 ticketone-it-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.
"""TicketOne.it — discover events, check availability, browse by category."""
from parse_apis.ticketone_italy_events_api import TicketOne, Category, EventNotFound
client = TicketOne()
# Browse featured event groups on the homepage
for group in client.eventgroups.featured(limit=3):
print(group.name, group.status, group.price)
# Search for a specific artist and take the first result
event = client.events.search(query="Vasco Rossi", limit=1).first()
if event:
print(event.name, event.productId, event.status)
# Get full event details by ID
if event:
try:
detail = client.events.get(event_id=event.productId)
print(detail.name, detail.type, detail.status)
except EventNotFound as exc:
print(f"Event gone: {exc.event_id}")
# Check ticket availability for that event
if event:
report = client.availabilityreports.check(event_ids=event.productId)
print(report.totalQueried, "events checked")
# List concerts in Milano filtered by category enum
for group in client.eventgroups.list(category=Category.CONCERTI, city="Milano", limit=3):
print(group.name, group.startDate, group.productCount)
print("exercised: eventgroups.featured / events.search / events.get / availabilityreports.check / eventgroups.list")
Get featured and recommended events from the TicketOne homepage. Returns top 20 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. No input parameters required.
No input parameters required.
{
"type": "object",
"fields": {
"page": "integer current page number",
"facets": "array of facet groups (categories, recommendations) with counts",
"results": "integer number of results returned in this response",
"totalPages": "integer total number of 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
Event Discovery and Search
The get_homepage_featured_events endpoint returns up to 20 featured event groups sorted by recommendation priority, including productGroups with names, dates, pricing, categories, and availability status. For category-scoped browsing, list_events_by_category accepts category values such as Concerti, Teatro, Sport, and Mostre e Musei, with optional city filtering (e.g. Milano, Roma) and limit/offset pagination. Both endpoints return facets arrays that expose city, venue, and category counts useful for building filter UIs.
Search and Detail Retrieval
search_events accepts a free-text query (artist name, venue, or event title) and returns individual products with productId, type, status, location, and categories. Those IDs feed directly into get_event_details, which accepts either an event_id for a single product object or a product_group_id for the full list of events in that group — useful when one artist has multiple tour dates or when a venue hosts a run of shows.
Ticket Availability
get_event_ticket_availability accepts a comma-separated list of event_ids and returns an events object keyed by each queried ID. Each entry includes inStock boolean, price, currency, status, tags, and a link pointing directly to the purchase page. The totalQueried field confirms how many IDs were evaluated, making batch availability checks straightforward.
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?+
- Build an event discovery app filtered by Italian city and category using
list_events_by_categoryfacets - Monitor ticket availability for sold-out shows by polling
get_event_ticket_availabilitywith multiple event IDs - Aggregate upcoming concert dates for a specific artist using
search_eventswith the artist name as the query - Display homepage-level featured events for an Italian lifestyle or travel app via
get_homepage_featured_events - Retrieve all tour dates for a product group using
get_event_detailswithproduct_group_idto list every scheduled performance - Track price changes across a batch of events by comparing
priceandcurrencyfields over time from the availability endpoint
| 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.
Does TicketOne.it have an official public developer API?+
What does `get_event_ticket_availability` return, and can I check multiple events at once?+
event_ids parameter. The response is an events object keyed by each ID, with fields including inStock, price, currency, status, tags, and a link to the purchase page. The totalQueried field tells you how many IDs were evaluated in the batch.What categories can I use with `list_events_by_category`?+
Concerti, Teatro, Sport, Mostre e Musei, and Altre manifestazioni. The endpoint also returns facets in each response that include current category counts, which can help identify additional valid values dynamically.Does the API return seating maps or individual seat selection data?+
Are events outside Italy covered, or is coverage limited to Italian events?+
Milano, Roma, and Bari confirm the Italian scope. Events listed on regional or international partner sites are not currently included. You can fork the API on Parse and revise it to point at a different regional TicketOne domain if one exists for your target market.