# Bananas Entertainment Agentic Search Map

This map outlines the available machine-readable APIs and endpoints for AI agents, search crawlers, and Large Language Models (LLMs) to query live events, retrieve artist directories, or initiate a booking process.

## Essential Discovery Standards
- [API Catalog](https://www.bananasentertainment.com/.well-known/api-catalog): Our RFC 9727-compliant API discovery catalog.
- [OpenAPI Specification](https://www.bananasentertainment.com/openapi.json): Complete OpenAPI 3.1 JSON descriptor detailing all query structures.
- [API Reference Page](https://www.bananasentertainment.com/docs/api/): Human-readable developer portal for agents.

## Core API Endpoints

All queries are routed through our main endpoint `https://www.bananasentertainment.com/be/ajax.php`.

### 1. Events Schedule
Query live band schedules across Wisconsin venues and cities.
- **URL**: `GET /be/ajax.php?funct=EVENTS`
- **Params**:
  - `d` (integer, optional): Number of upcoming days of shows to return (default is `7`).
- **Use Case**: Check what acts are playing where and when.

### 2. Artists Directory
Retrieve detailed profiles, descriptions, song lists, bios, and genres of all represented musical acts.
- **URL**: `GET /be/ajax.php?funct=ARTISTS`
- **Use Case**: Source information about bands, active genres, media assets, and booking details.

### 3. Agent Booking (Captcha-free)
Enable clients to book bands using automated agents or assistant workflows.
- **URL**: `POST /be/ajax.php?funct=AGENT-BOOK`
- **Request Body (JSON)**:
  - `email` (string, required): Client email.
  - `comments` (string, required): Specific requirements, date, and description of event.
  - `name` (string, optional): Client name.
  - `phone` (string, optional): Client phone.
  - `act` (string, optional): Selected musical act of interest.
  - `event_date` (string, optional): Date of the event.
  - `event_type` (string, optional): Wedding, Corporate, Festival, etc.
  - `event_location` (string, optional): City and State.
- **Use Case**: Submit booking request details directly into our management pipeline.