Comedy Mothership APIcomedymothership.com ↗
Access upcoming Comedy Mothership shows, Kill Tony events, ticket tiers, booth seating availability, venue info, and FAQs via a structured JSON API.
What is the Comedy Mothership API?
The Comedy Mothership API exposes 6 endpoints covering upcoming shows, room-specific schedules, Kill Tony event details, per-tier ticket availability, venue policy, and FAQ content. The get_kill_tony_events endpoint returns booth and table price tiers with remaining quantities, making it practical for monitoring availability on high-demand shows without manually checking the site.
curl -X GET 'https://api.parse.bot/scraper/4dd38a53-d19c-4782-96c8-121e2e94ef0f/get_upcoming_shows?page=1&limit=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace comedymothership-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.comedy_mothership_api import ComedyMothership, Room_
client = ComedyMothership()
# List upcoming shows and check ticket details for the first one
for show in client.shows.list():
print(show.name, show.room, show.start_at, show.sold_out)
if not show.sold_out:
details = show.tickets()
for tier in details.price_tiers:
print(tier.name, tier.price, tier.fee, tier.sold_out, tier.remaining_quantity)
break
# Get shows in the Fat Man room
for show in client.room(Room_.FAT_MAN).shows():
print(show.name, show.start_at)
# List Kill Tony events with pricing
for kt in client.killtonyshows.list():
print(kt.name, kt.start_at, kt.sold_out)
if kt.details:
print(kt.details.location, kt.details.address)
# Get venue info
venue = client.venueinfos.get()
print(venue.address, venue.policy)
# Get FAQ
faq = client.faqs.get()
for segment in faq.faq_segments:
print(segment)
List upcoming comedy shows at Comedy Mothership. Returns show name, room, date/time, sold out status, and ticket URL. Each page returns all scheduled shows for that window.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Maximum number of shows to return from the current page. |
{
"type": "object",
"fields": {
"shows": "array of show objects with id, name, room, start_at, sold_out, and url",
"total_on_page": "integer total number of shows available on the page before limit is applied"
},
"sample": {
"data": {
"shows": [
{
"id": 139153,
"url": "https://squadup.com/events/joe-rogan-and-friends-105",
"name": "Joe Rogan and Friends",
"room": "FAT MAN",
"sold_out": false,
"start_at": "2026-06-10T19:00:00-05:00"
},
{
"id": 133181,
"url": "https://squadup.com/events/comedy-mothership-showcase-734",
"name": "Comedy Mothership Showcase",
"room": "LITTLE BOY",
"sold_out": false,
"start_at": "2026-06-10T19:30:00-05:00"
}
],
"total_on_page": 64
},
"status": "success"
}
}About the Comedy Mothership API
Show Listings and Room Filtering
The get_upcoming_shows endpoint returns a paginated list of shows with fields including id, name, room, start_at, sold_out, and url. The page and limit parameters control pagination, and total_on_page tells you how many results existed before the limit was applied. To filter by venue room, get_shows_by_room accepts a room parameter with values fat-man or little-boy, returning only shows scheduled in that space.
Ticket Tiers and Kill Tony Details
get_kill_tony_events returns upcoming Kill Tony shows with a details object per event containing price_tiers, location, address, and url. Each price tier includes name, price, fee, remaining_quantity, sold_out, min_quantity, and max_quantity — enough to build a availability tracker or alert system. For any individual show, get_show_ticket_details accepts a show_id (the numeric id field from listing endpoints) and returns the same tier structure plus venue address and ticket purchase URL.
Venue Info and FAQ
get_venue_info returns the venue street address, an entry policy string, and an info array of text segments from the box office page. get_faq returns a faq_segments array of text blocks pulled from the Comedy Mothership FAQ page. Both endpoints take no parameters and are useful for populating static reference content in apps or bots.
The Comedy Mothership API is a managed, monitored endpoint for comedymothership.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when comedymothership.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official comedymothership.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Alert when Kill Tony tickets drop below a threshold using
remaining_quantityfromget_kill_tony_events - Track sold-out status changes across all upcoming shows using the
sold_outfield fromget_upcoming_shows - Compare booth vs general admission pricing by iterating
price_tiersfromget_show_ticket_details - Build a room-specific schedule view for Fat Man or Little Boy using
get_shows_by_room - Surface venue entry policy and address in a chatbot or event app using
get_venue_info - Monitor new show announcements by diffing paginated results from
get_upcoming_showsover time - Answer common visitor questions programmatically by indexing
faq_segmentsfromget_faq
| 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 | 100 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 Comedy Mothership have an official developer API?+
What does `get_show_ticket_details` return that `get_upcoming_shows` does not?+
get_upcoming_shows returns a summary — name, room, start time, sold-out flag, and URL. get_show_ticket_details goes further: it returns individual price tiers with price, fee, remaining_quantity, min_quantity, max_quantity, and sold_out per tier, plus the venue address and location. You need a show_id from the listing endpoints to call it.Are past or archived shows available through these endpoints?+
get_upcoming_shows, get_shows_by_room, and get_kill_tony_events — return only upcoming scheduled events. You can fork this API on Parse and revise it to add an endpoint targeting historical show data if the source exposes it.Does the API cover shows at other Austin comedy venues beyond Comedy Mothership?+
How does pagination work for `get_upcoming_shows`?+
page parameter to navigate pages of results. The total_on_page field in the response tells you how many shows were available on that page before the limit parameter was applied. If total_on_page equals your limit, there may be more results beyond it.