# Boletia — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```