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

> Search and discover Broadway shows, theater productions, and tours across different cities while staying updated with the latest theater news and show details. Find performances by location, browse upcoming tours, and get comprehensive information about specific shows all in one place.

**Category:** Entertainment | **Website:** [theatermania.com/](https://theatermania.com/) | **Docs:** [parse.bot/marketplace/6efa45da-6cd5-4916-a285-dcc0b7c13a24/theatermania-com-api](https://parse.bot/marketplace/6efa45da-6cd5-4916-a285-dcc0b7c13a24/theatermania-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-theatermania-com-api-6efa45da/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_cities

Retrieve the list of city/market slugs supported by TheaterMania. These slugs can be used as the location parameter in get_shows_by_location.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/get_all_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_broadway_shows

Retrieve a paginated list of Broadway shows. Each page returns up to ~24 shows with title, URL, image, category, performance dates, discount info, and ticket URL. Returns an empty array when page exceeds available results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/get_broadway_shows \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_news_articles

Retrieve latest theater news articles from TheaterMania. Returns paginated results with title, URL, image, and category for each article.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/get_news_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_show_detail

Retrieve full details for a specific show by its URL. Accepts a full URL or a relative path from TheaterMania. Show URLs are available from get_broadway_shows, get_shows_by_location, search_shows, and get_tours results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full or relative URL of the show page (e.g. 'https://www.theatermania.com/shows/new-york-city-theater/broadway/titanique_1816527/' or '/shows/new-york-city-theater/broadway/titanique_1816527/'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/get_show_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_shows_by_location

Retrieve show listings for a specific location/city. Returns an empty array if no shows are found for the given location. Use the get_all_cities endpoint to discover available location slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City or market slug from get_all_cities (e.g. 'broadway', 'chicago-theater', 'los-angeles-theater'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/get_shows_by_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>"}'
```

### get_tours

Retrieve a list of touring theater productions. Returns shows currently on national tours with title, URL, image, category, and ticket links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/get_tours \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_shows

Search across the TheaterMania site for shows, news, and articles matching a keyword query. Returns mixed results including both show listings and news articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'hamilton', 'wicked'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theatermania-com-api-6efa45da/search_shows \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```