# Boletia — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and search events on Boletia.com to discover concerts, shows, and performances across different venues and organizers, then view detailed event information and available ticket options. Filter events by category, venue, organizer, or explore trending music events in Mexico City.

**Category:** Entertainment | **Website:** [boletia.com/](https://boletia.com/) | **Docs:** [parse.bot/marketplace/464491b2-30c6-43a4-8da3-3fd106355beb/boletia-com-api](https://parse.bot/marketplace/464491b2-30c6-43a4-8da3-3fd106355beb/boletia-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cdmx_music_events

Get live music events (concerts) in Mexico City (Ciudad de México). Returns up to 20 events filtered by city and category. Useful for discovering music events specifically in the CDMX metropolitan area.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_cdmx_music_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_event_details

Get full details for a specific event by its slug. Returns comprehensive event information including description, location, contact, preferences, sponsors, and event type classification. The slug is the subdomain portion of the event URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug identifier (the subdomain portion of the event URL, e.g. 'nombre-del-evento' from nombre-del-evento.boletia.com). Obtainable from search_events or get_homepage_events results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_event_ticket_options

Get ticket type information for a specific event by its slug. Returns the event name and available ticket types with pricing details. Some events may have no ticket types listed if tickets are not yet available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Event slug identifier (the subdomain portion of the event URL, e.g. 'nombre-del-evento'). Obtainable from search_events or get_homepage_events results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_event_ticket_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_events_by_category

Get events filtered by category. Returns paginated results sorted by relevance and start date. Categories are matched against event subcategory field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Event category name (e.g. 'Conciertos', 'Teatro', 'Trail', 'Conceptual', 'Stand up', 'Artes Escénicas'). |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_events_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","offset":"<integer>"}'
```

### get_homepage_events

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 parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_homepage_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_organizer_events

Get events listed under a specific organizer using their billboard slug. Returns billboard metadata and a list of upcoming events grouped by date. Uses the same billboard API as get_venue_events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Organizer billboard slug identifier (e.g. 'palcco'). Found in event details or on the Boletia billboards page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_organizer_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_venue_events

Get upcoming events at a specific venue or billboard using its slug. Returns billboard metadata and a list of upcoming events grouped by date, including event details with pricing ranges.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Billboard/venue slug identifier (e.g. 'palcco'). Found in event search results or on the Boletia billboards page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/get_venue_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### search_events

Search for events by keyword query. Returns paginated results sorted by relevance and start date. Supports full-text search across event names, subdomains, venues, and keywords.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | Yes | Search keyword to find events (e.g. 'concierto', 'teatro', 'musica'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boletia-com-api-464491b2/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```