# Playbill — 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.

> Playbill provides 3 callable API endpoints through the Parse marketplace.

**Category:** Entertainment | **Website:** [playbill.com/](https://playbill.com/) | **Docs:** [parse.bot/marketplace/9130e1d3-32e8-48fd-b62d-a52685b759b8/playbill-com-api](https://parse.bot/marketplace/9130e1d3-32e8-48fd-b62d-a52685b759b8/playbill-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-playbill-com-api-9130e1d3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_grosses

Get the current Broadway grosses, which includes average and top ticket prices for all currently running Broadway shows. Returns a map of lowercased show names to pricing objects.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-playbill-com-api-9130e1d3/get_grosses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_play_details

Get detailed information for a specific play by its slug. Includes full description, theater details (name and address), performance schedule, and ticket pricing. The slug is obtained from search_plays results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The production slug from search_plays results (e.g. 'hamilton-broadway-richard-rodgers-theatre-2015') |

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

### search_plays

Search for currently running Broadway shows with an optional title filter. Returns a list of shows with titles, slugs, URLs, and current ticket pricing (average and top ticket prices). Single-page response containing all matching results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Show category. Only 'broadway' is currently supported. |
| `query` | string | No | Search keyword to filter by play title (case-insensitive substring match) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-playbill-com-api-9130e1d3/search_plays \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","query":"<string>"}'
```