in.bookmyshow.com APIin.bookmyshow.com ↗
Access BookMyShow India movie listings, event data, cast details, and city coverage via 6 endpoints. Get now-showing, upcoming, and recommended movies.
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'
Get list of all supported cities/regions with their codes and slugs. Returns both top cities and other cities combined.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of city/region objects with RegionCode, RegionName, RegionSlug, Lat, Long, SubRegions, and other metadata"
},
"sample": {
"data": [
{
"Lat": "12.971599",
"Seq": "3",
"Long": "77.594563",
"Alias": [
"bengaluru"
],
"StateCode": "KT",
"StateName": "Karnataka",
"AllowSales": "Y",
"RegionCode": "BANG",
"RegionName": "Bengaluru",
"RegionSlug": "bengaluru",
"SubRegions": [],
"CountryCode": "IN"
}
],
"status": "success"
}
}About the in.bookmyshow.com API
The BookMyShow India API provides 6 endpoints covering movies and live events across Indian cities. Starting with get_cities, which returns region codes, slugs, and geographic coordinates for every supported city, you can then query get_now_showing_movies, get_upcoming_movies, or get_recommended_movies by city slug, and drill into full cast, crew, synopsis, ratings, and ticket offers with get_movie_details.
City and Regional Coverage
The get_cities endpoint returns a flat list of all supported BookMyShow regions, each with RegionCode, RegionName, RegionSlug, Lat, Long, and SubRegions. The RegionSlug value is the parameter accepted by every other endpoint's city input, so this is normally the first call in any integration. Both top cities and secondary cities are combined into a single response array.
Movie Listings
get_recommended_movies pulls the homepage TOP_MOVIES_WEB widget for a given city and accepts an optional limit integer; passing 0 returns the full available set. get_now_showing_movies and get_upcoming_movies both return paginated results up to 5 pages deep, each yielding an items array of movie objects alongside a total count. These two endpoints share the same response shape, making it straightforward to handle them uniformly in client code.
Movie Details
get_movie_details requires an event_code — an alphanumeric identifier in the format ET00XXXXXX obtainable from the listing endpoints — and accepts an optional city slug. The response includes widgets (cast, crew, offers, similar recommendations), meta fields (event info, audience and critic ratings, release date), bannerWidget image data, and seo metadata. This is the only endpoint that exposes cast and crew attribution alongside ticket offer details.
Events
get_events_list covers non-film events such as concerts, comedy shows, and other live experiences. Like the movie listing endpoints, it accepts a city slug and returns up to 5 pages of paginated results with an items array and a total count. There is no separate event-detail endpoint in the current API.
- Build a city-aware movie discovery app using
get_now_showing_moviesfiltered byRegionSlug - Track upcoming Indian theatrical releases across multiple cities with
get_upcoming_movies - Display cast and crew cards for a film using the
widgetsobject fromget_movie_details - Aggregate live event listings (concerts, comedy) across Indian cities via
get_events_list - Seed a recommendation engine using the
recommendationswidget returned inget_movie_details - Map BookMyShow city coverage using
LatandLongcoordinates fromget_cities - Monitor which movies appear in the homepage TOP_MOVIES_WEB widget per city using
get_recommended_movies
| 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 | 250 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 BookMyShow have an official developer API?+
How do I get an `event_code` to use with `get_movie_details`?+
ET00XXXXXX and appear in the response objects returned by get_recommended_movies, get_now_showing_movies, and get_upcoming_movies. Call any of those listing endpoints first, extract the event code from a movie object, then pass it as the event_code parameter to get_movie_details.Does the API return venue or showtime data for movies?+
How deep is the pagination for listing endpoints?+
get_now_showing_movies, get_upcoming_movies, and get_events_list each fetch up to 5 pages of results and return a total count alongside the items array. If a city has more listings than 5 pages cover, the remaining entries will not appear in the response.Is event detail data available, such as venue, lineup, or performer info for concerts?+
get_events_list returns summary-level event objects with a total count but there is no dedicated event-detail endpoint equivalent to get_movie_details. You can fork the API on Parse and revise it to add an event-detail endpoint using event codes from the list response.