Build on the Revel comedy dataset
Upcoming shows, lineups, venues and comedians in every city Revel covers, as a read-only JSON API. Free, with a key in under a minute.
Free, from the first request
One key, full limits, no waiting. Need more than that? Ask.
Free
Free
The moment you register.
100 / min · 15,000 / day
- Every endpoint and every field
- Key issued instantly, no waiting
- Enough to keep a full copy in sync
Need more?
Talk to us
Partners and high-volume products.
Custom / min · Custom / day
- Limits raised per account
- Tell us the volume and what it powers
- We reply within a day
How it works
- 1
Step 1
Register an application
Sign in, tell us what you’re building and how you’ll use the data. Takes a minute.
- 2
Step 2
Start building
Your key works immediately at 100 requests a minute and 15,000 a day.
- 3
Step 3
Need more?
Ask. Limits are raised per account for partners and high-volume products.
What’s in it
Events
Every upcoming comedy show: start time in the venue’s timezone, lineup, pricing, sold-out and cancellation state.
Venues
Comedy clubs, theatres and promoters with address, coordinates, capacity and house rules.
Comedians
Entity-resolved performers with bio, socials, follower counts and every show they’re booked on.
Cities
The metros Revel covers, each with its IANA timezone — the key for city-scoped queries.
One request
curl "https://api.revel.show/v1/events?city=la&limit=2" \
-H "Authorization: Bearer rvl_sk_live_…"Paste the secret from your app page and you’re reading the same data the Revel app serves. Every list endpoint takes updated_since, so you only pull what changed since your last request.
The deal
- Open to everyone, for commercial and non-commercial use.
- Link to the Revel event page for tickets — it’s the
urlon every event. - One key per application. Don’t share keys or resell access to the API.
- Subject to the Terms of Service.