BookMyShow APIin.bookmyshow.com ↗
Access BookMyShow India movie listings, showtimes, event data, cast/crew details, and venue info across Indian cities via 9 structured endpoints.
What is the BookMyShow API?
The BookMyShow India API covers 9 endpoints that return movie listings, event catalogs, showtimes, and venue data across Indian cities. Starting with get_cities to resolve city slugs, you can pull now-showing and upcoming films, retrieve full cast and crew via get_movie_details, browse concerts and comedy shows through get_events_list, and query per-theater showtimes including seat categories and pricing with get_movie_showtimes.
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
Movie Data
The get_now_showing_movies and get_upcoming_movies endpoints accept a city slug (obtained from get_cities) and return paginated arrays of movie objects. Each item carries title, event_code, genre, language, certification, poster_url, cta_url, and event_date. The get_recommended_movies endpoint surfaces the homepage top-movies widget for a given city and accepts an optional limit parameter; passing 0 returns all available results. event_code values follow the pattern ET00XXXXXX and serve as the key identifier across endpoints.
Movie Details and Showtimes
get_movie_details takes an event_code and optional city and returns a flattened structure with cast and crew arrays (each member has name, role, and image_url), plus description, duration, event_genre, event_censor, and release_date. For ticket planning, get_movie_showtimes accepts event_code, city, an optional date in YYYYMMDD format, and an optional venue_code to narrow results to a single theater. It returns a venues array with venue_name, address, coordinates, is_multiplex, has_food_sales, and nested showtime objects with seat categories and pricing. It also returns available_dates so you can enumerate all bookable dates for a film.
Events and Venues
get_events_list covers non-film events such as concerts, comedy shows, and sports. get_kids_events returns children's workshops, classes, and activities. Both follow the same paginated response shape as the movie listing endpoints. get_venue_events takes a venue_code (sourced from a prior get_movie_showtimes call) and an optional date, returning all ongoing and upcoming events at that location along with a status field and an available_dates array for multi-day browsing.
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?+
- Build a city-specific movie guide that lists now-showing films with certification and language filters from
get_now_showing_movies. - Aggregate upcoming release calendars for multiple Indian cities using
get_upcoming_moviesevent_datefields. - Display full cast and crew cards for a film detail page using
get_movie_detailscastandcrewarrays. - Show real-time theater availability and seat category pricing for a movie using
get_movie_showtimes. - List concerts and comedy shows in a city by date using
get_events_listwith city slug filtering. - Build a venue profile page showing all scheduled movies and events at a specific cinema via
get_venue_events. - Surface children's activity recommendations by city using
get_kids_eventsgenre and event_date fields.
| 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 find the correct city identifier to pass to most endpoints?+
get_cities returns a list of city objects. Use the RegionSlug field as the city parameter in all other endpoints. The response also includes RegionCode, coordinates, StateCode, and SubRegions for each supported city.Does `get_movie_showtimes` return actual seat availability counts?+
available_dates for a film. Individual seat-count or occupancy data is not included in the current response shape. You can fork this API on Parse and revise it to add an endpoint targeting per-show seat availability if that data is accessible at the source.Does the API cover ticket booking or payment flows?+
cta_url links that point to the BookMyShow booking page, but it does not initiate or process ticket purchases. You can fork it on Parse and revise to add any adjacent booking-status endpoints you need.What is the pagination behavior for listing endpoints like `get_events_list` or `get_now_showing_movies`?+
total field reflects the count of items returned. If a city has more than 5 pages of results at the source, items beyond that range will not appear in the response.