District APIdistrict.in ↗
Access movies currently in theaters and showtime schedules across Indian cities via the District by Zomato API. Returns seat prices, formats, and theatre details.
What is the District API?
The District.in API exposes 2 endpoints covering movies currently in theaters and per-movie showtime schedules across major Indian cities. get_movies_in_theaters returns title, genres, duration, censor rating, languages, formats, and poster for every film showing in a given city. get_movie_showtimes drills into individual theatre listings with seat availability, category-level pricing, and auditorium format for a specific movie, city, and date.
curl -X GET 'https://api.parse.bot/scraper/9dbc34b2-b7c3-4e9b-9540-6d2bb2568c57/get_movies_in_theaters?city=Mumbai' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all movies currently showing in theaters for a given city. Each movie includes title, genres, duration, censor rating, release date, available languages and formats, description, and poster image. The city parameter matches against the site's city catalog which includes Indian cities, Abu Dhabi, and Dubai. When city is omitted, defaults to Mumbai.
| Param | Type | Description |
|---|---|---|
| city | string | City name to filter movies by (e.g. Mumbai, Bengaluru, Delhi NCR, Chennai, Hyderabad, Pune, Kolkata, Ahmedabad). Matched case-insensitively against the site's city catalog. |
{
"type": "object",
"fields": {
"city": "Resolved city name as stored in the site's catalog",
"movies": "Array of movie objects with details about each film showing in theaters",
"total_movies": "Total number of movies currently in theaters for this city"
},
"sample": {
"data": {
"city": "Mumbai",
"movies": [
{
"name": "Spider-Man: Brand New Day",
"image": "https://cdn.district.in/movies-assets/images/cinema/image-(29)-598ac6b0-6a24-11f1-8579-1756095b1930.jpg",
"genres": [
"Superhero",
"Action",
"Adventure"
],
"web_url": "https://www.district.in/movies/spider-man-brand-new-day-movie-tickets-MV194537",
"movie_id": "194537",
"variants": [
{
"format": "3D",
"language": "English"
},
{
"format": "3D",
"language": "Hindi"
},
{
"format": "2D",
"language": "English"
}
],
"languages": [
"English",
"Hindi",
"Tamil"
],
"description": "Four years after No Way Home, Peter lives alone, erased from the lives of those he loves. Fully devoted to protecting New York, mounting pressure triggers a physical evolution that threatens his existence as a powerful new threat emerges.",
"release_date": "1785369600",
"censor_rating": "UA13+",
"duration_minutes": 145
}
],
"total_movies": 32
},
"status": "success"
}
}About the District API
What the API Covers
The District.in API is built on data from District by Zomato, one of India's primary movie ticketing platforms. It covers two core capabilities: a city-wide catalog of currently running films, and detailed showtime schedules broken down by theatre, screen format, and seat category. Cities supported include Mumbai, Bengaluru, Delhi NCR, Chennai, Hyderabad, Pune, Kolkata, and Ahmedabad, among others.
get_movies_in_theaters
This endpoint accepts an optional city string and returns a movies array alongside a total_movies count and a resolved city name. Each movie object includes title, genres, duration, censor_rating, release_date, languages, formats (e.g. 2D, 3D, IMAX), a description, and a poster image URL. The movie_id field from this response is the required input to the showtime endpoint.
get_movie_showtimes
Pass a movie_id (from get_movies_in_theaters), an optional city, and an optional date in YYYY-MM-DD format. The response contains a theatres array where each entry carries the theatre name, address, location, and a list of individual showtimes. Each showtime includes the time, screen_format, auditorium_name, available_seats, total_seats, and a seat_category breakdown with per-category prices. The response also includes show_dates — an array of all available booking dates — and total_theatres for the query. Omitting date returns today's shows by default.
The District API is a managed, monitored endpoint for district.in — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when district.in 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 district.in 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 movie discovery app for Indian users that surfaces currently running films with genre and language filters.
- Compare ticket prices across seat categories and screen formats (2D, 3D, IMAX) for a given movie and city.
- Send seat availability alerts when a nearly sold-out show has remaining seats for a popular film.
- Aggregate showtime schedules across multiple cities to identify which theatres are running a specific release.
- Populate a travel itinerary tool with local cinema options and showtimes for an upcoming visit to an Indian city.
- Track release timing across cities by comparing release dates and available show dates from the
show_datesfield.
| 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 District by Zomato offer an official developer API?+
What does get_movie_showtimes return beyond basic show times?+
show_dates and the total number of theatres showing the film.Does the API cover booking functionality or user reviews?+
How current is the showtime data, and how far ahead can dates be queried?+
date parameter on get_movie_showtimes must fall within the booking window the platform exposes; dates beyond that window will return no results. Omitting date defaults to today's schedule.Can I get showtimes for cities not in the listed examples?+
city parameter resolves against District's own city catalog. Cities outside their catalog will not return results. The city field in each response confirms the resolved name. You can fork this API on Parse and revise it to map additional city aliases or handle catalog mismatches if needed.