boletia.com APIboletia.com ↗
Access Boletia.com event listings, ticket types, venue schedules, and organizer info via 7 structured endpoints covering Mexico's event ticketing platform.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/59184974-f081-4784-8476-384826e64ac3/get_homepage_events' \ -H 'X-API-Key: $PARSE_API_KEY'
Get upcoming events currently listed on Boletia, sorted by relevance and start date. Returns up to 20 events with basic information including name, location, tickets, and dates.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total number of matching events",
"events": "array of event objects with id, name, slug, about, banner, category, start_date, end_date, locations, tickets, and url"
},
"sample": {
"data": {
"total": 1115,
"events": [
{
"id": "267652",
"url": "https://trail-series-rutas-magicas-2026.boletia.com/",
"name": "Trail Series Rutas Magicas 2026",
"slug": "trail-series-rutas-magicas-2026",
"about": "TRAIL RUN MÉXICO PRESENTA...",
"banner": "IMG6517.jpeg",
"tickets": [
{
"name": "BOLETO A",
"price": "999.00",
"currency": "MXN"
}
],
"category": "Trail",
"end_date": "2026-09-20T07:00:00.000Z",
"locations": [
{
"city": "Estado de México",
"venue": "Estado de México",
"address": "Estado de México, México"
}
],
"start_date": "2026-04-19T07:00:00.000Z"
}
]
},
"status": "success"
}
}About the boletia.com API
The Boletia API provides 7 endpoints for querying events, ticket options, venue schedules, and organizer listings from Boletia.com, Mexico's event ticketing platform. get_event_details returns full event metadata including location coordinates, organizer contact info, sponsors, and capacity, while search_events supports paginated keyword queries across all event categories. Each event object consistently exposes fields like start_date, end_date, banner, slug, and tickets.
Event Discovery and Search
The get_homepage_events endpoint returns up to 20 current events sorted by relevance and start date, including each event's id, name, slug, about, banner, category, start_date, end_date, locations, tickets, and url. For targeted discovery, search_events accepts a required query string (e.g. 'concierto', 'teatro') along with optional limit and offset parameters for pagination, returning the same event object shape plus a total count. get_events_by_category filters by category name such as 'Conciertos', 'Stand up', or 'Artes Escénicas', also supporting limit and offset.
Event Details and Tickets
get_event_details takes an event slug and returns a richer payload than the listing endpoints: a full event object with status, capacity, and event_type; a contact object covering email, phone, facebook, instagram, and tiktok; a location object with venue, address, city, state, latitude, and longitude; an array of sponsors with logo and website; and an event_type_subtype classification. get_event_ticket_options returns the event_name, event_slug, and an array of ticket_types with pricing and availability details for the same slug.
Venue and Organizer Listings
get_venue_events accepts a billboard slug (e.g. 'palcco') and returns total_events, billboard_name, billboard_banner, billboard_description, and an events_information array of event groups organized by date. get_organizer_events uses the same input shape and response structure but is scoped to organizer billboards, letting you list all upcoming events under a specific event producer. Slugs for both endpoints are obtainable from search results or event detail responses.
- Aggregate upcoming concert and theater listings in Mexico for a city events app using
search_eventswith category filters. - Display venue schedules grouped by date for a specific location using
get_venue_eventswith a billboard slug. - Pull organizer event catalogs to build promoter profile pages using
get_organizer_events. - Show ticket type availability and pricing on a third-party discovery site using
get_event_ticket_options. - Enrich event cards with GPS coordinates, social contact links, and sponsor logos from
get_event_details. - Monitor new event listings by comparing
get_homepage_eventsresponses over time. - Build category-filtered event feeds (e.g. 'Stand up', 'Trail') using
get_events_by_categorywith pagination.
| 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 Boletia have an official developer API?+
What does `get_event_details` return beyond what listing endpoints include?+
get_event_details adds fields not present in listing responses: a contact object with email, phone, and social handles (Facebook, Instagram, TikTok); a location object with latitude and longitude; a sponsors array with logo URLs and websites; a preferences object covering currency and fee settings; and an event_type_subtype classification. Listing endpoints return a leaner event object with name, slug, banner, category, start_date, end_date, locations, tickets, and url.Does the API return past events or only upcoming ones?+
get_homepage_events, get_venue_events, and get_organizer_events explicitly return upcoming listings sorted by start date. Historical or past-event data is not currently exposed. You can fork the API on Parse and revise it to add an endpoint targeting past event data if that coverage exists on the source.Can I retrieve individual ticket purchase or transaction data?+
get_event_ticket_options). You can fork the API on Parse and revise it to add endpoints for any ticket purchase flows if that data becomes accessible.How does pagination work across the listing endpoints?+
search_events and get_events_by_category both accept optional limit and offset integer parameters to page through results. Each response includes a total integer indicating the full count of matching events, which you can use to calculate how many pages exist. get_homepage_events returns up to 20 results with no pagination parameters.