BookMyShow APIin.bookmyshow.com ↗
Access BookMyShow India movie listings, showtimes, event details, and venue data across Indian cities via a structured REST API with 13 endpoints.
What is the BookMyShow API?
This API exposes 13 endpoints covering BookMyShow India's movie and live-event catalog, including city listings, showtimes, cast and crew details, and venue data. Use get_movie_showtimes to retrieve theater schedules filtered by city, date, and venue, or call get_event_details to pull structured data on concerts, comedy shows, and workshops. All responses return structured JSON ready for direct consumption.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/c9d4d699-5bca-49af-a878-144ad05b0f5f/get_cities' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve all supported cities and regions with their codes, slugs, coordinates, and sub-regions. Returns both top cities and other cities combined into a single list. Each city includes a RegionCode (used internally) and a RegionSlug (used as the city identifier in other endpoints).
No input parameters required.
{
"type": "object",
"fields": {
"cities": "array of city/region objects with RegionCode, RegionName, RegionSlug, Lat, Long, StateCode, StateName, SubRegions, CountryCode"
},
"sample": {
"data": {
"cities": [
{
"Lat": "19.076",
"Long": "72.8777",
"StateCode": "MH",
"StateName": "Maharashtra",
"RegionCode": "MUMBAI",
"RegionName": "Mumbai",
"RegionSlug": "mumbai",
"SubRegions": [
{
"SubRegionCode": "MWEST",
"SubRegionName": "Mumbai: Western",
"SubRegionSlug": "mumbai-western"
}
],
"CountryCode": "IN"
},
{
"Lat": "12.971599",
"Long": "77.594563",
"StateCode": "KT",
"StateName": "Karnataka",
"RegionCode": "BANG",
"RegionName": "Bengaluru",
"RegionSlug": "bengaluru",
"SubRegions": [],
"CountryCode": "IN"
}
]
},
"status": "success"
}
}About the BookMyShow API
Movies and Showtimes
The get_now_showing_movies and get_upcoming_movies endpoints return paginated movie listings for any city identified by a RegionSlug from get_cities. Each result includes title, event_code, genre, language, certification, poster_url, and event_date. For deeper metadata on a specific title, get_movie_details accepts an event_code (e.g. ET00439772) and returns cast, crew, description, event_genre, event_censor, release_date, and duration drawn from multiple data sources in one flat response.
Showtime Lookups
get_movie_showtimes accepts a city slug, an optional date in YYYYMMDD format, and a movie identified by event_code, movie_name, or movie_slug. It returns a venues array where each entry carries venue_code, venue_name, address, latitude, longitude, is_multiplex, has_food_sales, and ticket_cancellation flags, plus an available_dates array. To search showtimes nationwide without picking a city, search_showtimes_india covers all regions in paginated batches of 10, or accepts a cities parameter of up to 10 comma-separated slugs. Karnataka-specific coverage is available via get_showtimes_KT, which processes 35 Karnataka regions per page.
Live Events
get_events_list returns concerts, theatre, sports, workshops, and other live events for a given city, with fields including category, venue, price, and event_date. get_kids_events covers child-oriented activities under the same structure. get_event_details provides the full record for a single event: tags, format (offline/online), venues with per-venue date_time, address, and coordinates, plus age_limit, duration, and price text.
City and Venue Discovery
get_cities returns every supported region with RegionCode, RegionSlug, Lat, Long, StateCode, and SubRegions. The RegionSlug value is the city parameter accepted by all other endpoints. get_venue_events takes a venue_code and optional date to list all events — movies and live shows — scheduled at that specific venue, returning each event's status (ongoing/upcoming) and available_dates.
The BookMyShow API is a managed, monitored endpoint for in.bookmyshow.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when in.bookmyshow.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 in.bookmyshow.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?+
- Aggregate now-showing and upcoming movie listings across multiple Indian cities for a content app.
- Build a theater-finder tool using venue coordinates, multiplex flags, and food-sales data from get_movie_showtimes.
- Power a concert and comedy-show discovery feed using get_events_list with category, venue, and price fields.
- Look up full cast and crew for a Bollywood or regional film using get_movie_details with an event_code.
- Track Karnataka-wide showtimes for a regional-language film release using get_showtimes_KT across paginated region batches.
- Monitor what is playing at a specific cinema on a given date using get_venue_events with a venue_code and date.
- Build a nationwide release-day showtime map using search_showtimes_india with the cities parameter for targeted regions.
| 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 BookMyShow have an official public developer API?+
How do I identify the correct movie across endpoints?+
event_code — an alphanumeric ID starting with 'ET' (e.g. ET00439772) — returned by get_recommended_movies, get_now_showing_movies, get_upcoming_movies, and search_movies. Pass that code to get_movie_details, get_movie_showtimes, or search_showtimes_india. When you don't have the code, get_movie_showtimes and the India-wide endpoints also accept a movie_name (partial title text) or movie_slug (the hyphenated URL segment for the movie's page).Are ticket-booking or seat-selection details returned by any endpoint?+
cta_url links that point to the booking page, but does not return seat maps, available seat counts, or booking transaction data. You can fork this API on Parse and revise it to add an endpoint covering those details if the source exposes them on a publicly accessible page.How does pagination work for showtimes across India?+
search_showtimes_india covers all BookMyShow regions in pages of 10. Set the page parameter to step through batches; the has_more field in each response tells you whether additional pages exist. The regions_covered array lists every region queried in that call with its venue count, and regions_failed lists any regions that returned errors. Alternatively, pass up to 10 specific city slugs in the cities parameter to skip pagination entirely.Does the API return user reviews or audience ratings for movies?+
get_recommended_movies endpoint includes an optional rating field where the source exposes it. get_movie_details returns structured metadata including event_censor certification. Full user-review text or aggregated audience-score breakdowns are not currently returned by any endpoint. You can fork this API on Parse and revise it to add an endpoint targeting review data if it appears on a publicly accessible movie page.