theatermania.com APItheatermania.com ↗
Access Broadway show listings, touring productions, theater news, and venue details from TheaterMania.com via a structured JSON API with 7 endpoints.
curl -X GET 'https://api.parse.bot/scraper/358e12ab-93aa-4ba9-aa12-869492e2e4d9/get_broadway_shows?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve a paginated list of Broadway shows. Returns an empty array when page exceeds available results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
{
"type": "object",
"fields": {
"count": "integer, number of shows returned on this page",
"paged": "integer, current page number",
"shows": "array of show objects with title, url, image, type, category, performance_dates, discount_info, and ticket_url"
},
"sample": {
"data": {
"count": 24,
"paged": 1,
"shows": [
{
"url": "https://www.theatermania.com/shows/new-york-city-theater/broadway/arthur-millers-death-of-a-salesman_1815340/",
"type": "show",
"image": "https://www.theatermania.com/wp-content/uploads/sites/4/2025/12/DOAS_TheaterMania_300x200_KeyArt_Option1.png?w=300",
"title": "Arthur Miller’s Death of a Salesman",
"category": null,
"ticket_url": "https://www.telecharge.com/arthur-millers-death-of-a-salesman-tickets?AID=AFF000009000",
"discount_info": null,
"performance_dates": "Final performance: August 9, 2026"
}
]
},
"status": "success"
}
}About the theatermania.com API
The TheaterMania API exposes 7 endpoints covering Broadway show listings, touring productions, city-specific theater schedules, and news articles from TheaterMania.com. The get_show_detail endpoint returns venue name, address, ticket URL, and a full description for any specific production. Listings include performance dates, discount info, and direct ticket links, making it straightforward to build theater discovery tools or content feeds.
Show Listings and Location Coverage
The get_broadway_shows endpoint returns a paginated list of Broadway productions, each with a title, url, image, type, category, performance_dates, discount_info, and ticket_url. For productions outside New York, get_shows_by_location accepts a location slug (such as chicago-theater or los-angeles-theater) and returns the same shape of show objects. To discover which slugs are valid, call get_all_cities first — it returns a flat array of supported city/market slugs that feed directly into the location parameter.
Show Detail and Search
When you need the full record for a specific production, get_show_detail accepts either a full URL or a relative path from TheaterMania and returns venue, venue_address, venue_url, ticket_url, description, and a metadata object with additional date and detail fields. The search_shows endpoint accepts a query string (for example, hamilton or wicked) and returns a result array with the same fields as the listing endpoints, covering shows, news, and articles in one call.
Tours and News
get_tours retrieves paginated touring productions with the same field set as Broadway listings — useful for tracking which shows are currently on the road. get_news_articles returns theater news with title, url, image, category, and type per article. All paginated endpoints accept an integer page parameter and return both count and paged in the response so you can iterate until the array comes back empty.
- Aggregating Broadway and regional theater listings with discount info and ticket links for an event discovery platform
- Building a tour-tracker that surfaces which productions are currently on the road via
get_tours - Populating a city-specific theater guide using
get_shows_by_locationwith slugs fromget_all_cities - Enriching a show record with venue address, description, and ticket URL via
get_show_detail - Running a theater news feed with article titles, images, and categories from
get_news_articles - Implementing a site-wide search across productions and editorial content using
search_shows
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TheaterMania have an official developer API?+
What does `get_show_detail` return beyond what the listing endpoints include?+
get_show_detail adds fields not present in paginated lists: venue, venue_address, venue_url, description, and a metadata object containing additional dates and show details. It accepts either a full TheaterMania URL or a relative path, so you can pass the url field from any listing result directly.How does pagination work across the listing endpoints?+
get_broadway_shows, get_shows_by_location, get_tours, get_news_articles) accept an integer page parameter and return count and paged in the response. When page exceeds the available results, the endpoint returns an empty array — so incrementing page until the array is empty is the intended iteration pattern.Does the API return user reviews or ratings for shows?+
Can I filter shows by genre, date range, or price within a single endpoint?+
get_broadway_shows, get_shows_by_location) support only page-based pagination; there are no query parameters for genre, date, or price filtering. The category and performance_dates fields are available in the response, so client-side filtering is possible after retrieval. You can fork this API on Parse and revise it to add server-side filter parameters if you need more targeted queries.