shop.ticketera.com APIshop.ticketera.com ↗
Search Ticketera events, retrieve ticket prices and seating categories, and check real-time seat availability with 3 endpoints covering Puerto Rico and Latin America.
curl -X GET 'https://api.parse.bot/scraper/c9047e7d-d98b-4ce1-a2c5-5afa9be87ee9/search_events?query=concierto' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for events on Ticketera by keyword. Returns event names, venues, dates, ticket URLs, and event slugs that can be used with other endpoints.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'basketball', 'concierto'). Use empty string for all events. |
{
"type": "object",
"fields": {
"query": "string — the search term used",
"total": "integer — number of results returned",
"results": "array of event objects with id, name, date_html, venue, category, image, detail_url, ticket_url, event_slug, type"
},
"sample": {
"data": {
"query": "basketball",
"total": 1,
"results": [
{
"id": "2010",
"name": "Criollos de Caguas BSN 2026 - Temporada Regular",
"type": "events",
"image": "https://www.ticketera.com/assets/img/New-Project-48304be501.jpg",
"venue": "Coliseo Roger Mendoza",
"category": "Deportes",
"date_html": "<span class=\"m\">Mar</span> <span class=\"d\">31</span> - <span class=\"m\">May</span> <span class=\"d\">30</span><span class=\"y\">, 2026</span>",
"detail_url": "https://www.ticketera.com/events/detail/criollos-de-caguas-bsn-2026-temporada-regular",
"event_slug": "",
"ticket_url": "https://www.ticketera.com/events/detail/criollos-de-caguas-bsn-2026-temporada-regular"
}
]
},
"status": "success"
}
}About the shop.ticketera.com API
The Ticketera API provides 3 endpoints to query events, pricing, and seat availability on shop.ticketera.com, a vivenu-powered ticketing platform. Use search_events to find events by keyword and retrieve slugs, then pass those slugs to get_event_details for ticket types with prices, venue coordinates, and seating configuration, or to get_empty_seats for a live seat-by-seat availability map.
Event Search and Discovery
The search_events endpoint accepts a keyword query string — Spanish or English terms both work, e.g. 'concierto' or 'basketball' — and returns an array of event objects with fields including id, name, date_html, venue, category, image, detail_url, ticket_url, and event_slug. The event_slug is the key input required by the other two endpoints. Passing an empty string for query returns all available events.
Event Details and Ticket Pricing
get_event_details takes an event_slug and an optional shop_domain (defaults are auto-detected, but Ticketera hosts multiple subdomains such as choli.ticketera.com and cmh.ticketera.com). The response includes start and end as ISO datetimes, a location object with name, address, city, latitude, and longitude, a tickets array where each entry carries name, price, active, and category_ref, and a categories array with name, ref, seating_reference, and total_seats. The seating object indicates whether the event uses assigned seating via the active boolean.
Real-Time Seat Availability
get_empty_seats is only relevant when seating.active is true in the event details response. It returns an empty_seats array where each object includes seat_id, section, row, seat, and category, plus a section_summary map that groups available seat counts by section name. The response also surfaces empty_seats_count, booked_seats_count, and total_seats_in_map so you can compute fill rates. If no seats remain, sold_out is returned as true.
- Display upcoming concerts and shows in Puerto Rico filtered by category using
search_events. - Build a ticket price comparison view by pulling the
ticketsarray fromget_event_detailsacross multiple events. - Show a section-level seat availability heatmap using
section_summaryfromget_empty_seats. - Alert users when seats become available in a specific section by polling
get_empty_seatsfor lowempty_seats_count. - Enrich event listings with venue geocoordinates (
latitude,longitude) fromget_event_detailsfor a map view. - Track sold-out events by monitoring the
sold_outboolean across multiple event slugs.
| 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 | 250 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 Ticketera have an official public developer API?+
What does `get_empty_seats` return for a general-admission event?+
seating.active is false in get_event_details are not supported by get_empty_seats. The endpoint is designed for assigned-seating events and returns per-seat detail including section, row, and seat identifiers. For GA events, ticket availability is indicated by the active field on each entry in the tickets array from get_event_details.Does the API cover events on Ticketera subdomains other than shop.ticketera.com?+
get_event_details and get_empty_seats accept an optional shop_domain parameter. Known subdomains include choli.ticketera.com and cmh.ticketera.com. If shop_domain is omitted, the API attempts to auto-detect the correct domain from the event slug.Can I retrieve order history or user purchase data through this API?+
Does `search_events` support pagination for large result sets?+
total count alongside the results array, but there are no page or offset parameters currently exposed. If you need to paginate across a large event catalog, you can fork this API on Parse and revise it to add pagination support.