Cadogan Hall APIcadoganhall.com ↗
Access upcoming events at Cadogan Hall in London. Get titles, dates, availability, genres, and URLs for all events up to 180 days ahead via a single endpoint.
What is the Cadogan Hall API?
The Cadogan Hall API provides one endpoint — list_events — that returns all upcoming performances at the Chelsea venue, covering up to 180 days of programming in a single response. Each event record includes 7 fields: title, subtitle, date, URL, image URL, excerpt, and availability status. An optional genre filter lets you narrow results to specific programming categories such as classical, comedy, or theatre.
curl -X GET 'https://api.parse.bot/scraper/859a1373-8259-4039-897e-c37eaf7874a1/list_events?genre=comedy' \ -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 cadoganhall-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.
"""Walkthrough: Cadogan Hall Events API — browse upcoming events by genre."""
from parse_apis.cadoganhall_com_api import CadoganHall, Genre, ParseError
client = CadoganHall()
# List all upcoming events, capped to 5 total items.
for event in client.events.list(limit=5):
print(event.title, "|", event.date)
# Filter by genre — comedy events only.
try:
comedy_event = client.events.list(genre=Genre.COMEDY, limit=1).first()
except ParseError as e:
print("Extraction failed:", e)
else:
if comedy_event is not None:
print(comedy_event.title)
print(comedy_event.subtitle)
print(comedy_event.url)
if comedy_event.availability is not None:
print("Availability:", comedy_event.availability)
print("exercised: events.list / events.list(genre=)")
List all upcoming events at Cadogan Hall from today to approximately 180 days in the future. Returns all events in a single response (no pagination). Optionally filter by genre. Events are ordered by date.
| Param | Type | Description |
|---|---|---|
| genre | string | Genre slug to filter events. When omitted, all genres are returned. |
{
"type": "object",
"fields": {
"total": "integer count of events returned",
"events": "array of event objects with title, subtitle, date, url, image_url, excerpt, and availability"
},
"sample": {
"data": {
"total": 2,
"events": [
{
"url": "https://cadoganhall.com/whats-on/comedy-at-cadogan-hall-with-david-odoherty/",
"date": "Friday 25 September 2026, 7.30pm",
"title": "Comedy at Cadogan Hall with David O'Doherty",
"excerpt": "Cadogan Hall’s unmissable regular comedy show returns...",
"subtitle": "Plus Ian Smith, Desiree Burch, Liam Withnail & Marjolein Robertson",
"image_url": "https://assets.cadoganhall.com/wp-content/uploads/2026/06/260925_comedy_david.jpg",
"availability": null
}
]
},
"status": "success"
}
}About the Cadogan Hall API
What the API Returns
The list_events endpoint returns a flat array of upcoming events at Cadogan Hall, ordered chronologically from today through approximately six months ahead. The response includes a total integer count alongside the events array, so you always know the full result size without additional requests. There is no pagination — all matching events are returned in one call.
Each event object carries the title and subtitle strings that describe the performance, a date field indicating when it takes place, a url linking to the event's detail page on cadoganhall.com, an image_url for the event artwork, an excerpt with a short prose summary, and an availability field reflecting current ticket status.
Filtering by Genre
The genre parameter accepts a slug string and, when provided, restricts results to events in that category. Omitting the parameter returns the full mixed programme across all genres. This makes it straightforward to build genre-specific views — for instance, fetching only classical music listings or only comedy nights — without any client-side filtering.
Coverage and Scope
All events returned are at Cadogan Hall's single London venue (Sloane Terrace, Chelsea). The look-ahead window is fixed at roughly 180 days from the current date. The API does not require authentication and returns results immediately without session setup.
The Cadogan Hall API is a managed, monitored endpoint for cadoganhall.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cadoganhall.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 cadoganhall.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?+
- Build a London classical music calendar that surfaces only upcoming orchestral and chamber concerts using the genre filter.
- Monitor seat availability changes by polling the
availabilityfield on known event URLs over time. - Aggregate multi-venue London event listings by combining Cadogan Hall data with other venue feeds.
- Power a nightly newsletter that lists the next 7 days of Cadogan Hall events using the
dateandtitlefields. - Generate a genre-breakdown dashboard showing how many comedy vs. classical vs. theatre events are scheduled in the next 90 days.
- Sync event imagery and descriptions into a CMS using the
image_urlandexcerptfields for each listing.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Cadogan Hall offer an official developer API?+
What does the `availability` field actually contain?+
availability field reflects the current ticket status shown on the event listing — typically a string indicating whether tickets are on sale, sold out, or otherwise unavailable. It is not a numeric seat count; it mirrors the status label displayed on the venue's site at the time of the request.Does the API return past events or events beyond 180 days?+
list_events only covers events from today forward, up to approximately 180 days out. Events that have already passed and anything scheduled beyond that window are not included. You can fork this API on Parse and revise it to extend the look-ahead window or add a historical endpoint if your use case requires it.Can I retrieve individual event details — like full programme notes, performer bios, or ticket pricing?+
What genre slugs are valid for the `genre` filter?+
list_events without a filter first, then inspect the genre structure of returned events before filtering.