District

Lifestyleby Zomato Media Pvt. Ltd

Launched Feb 24, 2026 on ChatGPT

District by Zomato offers discovery and booking across restaurants, movies, events, sports facilities, activities and stores. The platform focuses on enabling users to experience their city effortlessly, across every touchpoint, online and offline

8ChatGPT Tools

Zomato Media Pvt. LtdDeveloper

LifestyleCategory

Available Tools

Get Dining Restaurants Details

get_dining_restaurants_details

Full Description

Get enriched restaurant data in bulk for multiple restaurants.

This tool retrieves comprehensive enrichment information including photos, ratings, timings, and other enrichment data. This is the PREFERRED tool for getting restaurant details as it includes thumbnail_url for images.

Use this tool when:

User explicitly asks for more details about specific restaurant(s)
User asks follow-up questions requiring detailed info (reviews, timings, address)
User wants to compare specific restaurants in detail
User clicks "View Details" on a search result

Widget Rendering:

Widget will ONLY render when exactly 1 restaurant is requested (single res_id)
For multiple restaurants, present data in text format for comparison
For zero restaurants, no widget is shown

Parameters (2 required)

Required

res_idsarray

List of restaurant IDs (as strings) to fetch enriched details for

user_location

User's location (latitude, longitude) for enriched restaurant data

Get Dynamic Filters

get_dynamic_filters

Full Description

[PREREQUISITE STEP] Get dynamic filters available for dining search based on user's location.

⚠️ IMPORTANT: This tool MUST be called BEFORE using search_dining_restaurants to understand available filter options and their valid values.

This API returns all available filter definitions that can be used for dining restaurant discovery, including:

Filter names and descriptions
Valid values for each filter
Importance levels
Whether filters are exhaustive and whether they have avoid counterparts

⚠️ FILTER BEHAVIOR IN search_dining_restaurants:

When you pass multiple filters to search_dining_restaurants, they are combined with AND logic
For OR logic between filter values, make separate search_dining_restaurants requests and combine the results
Example: To find "Italian OR Chinese" restaurants, call search_dining_restaurants twice (once for Italian, once for Chinese) and merge the results

Without calling this tool first, you may use invalid filter values or miss important filtering options.

Parameters (1 required)

Required

user_location

User's location for the filters (REQUIRED). For accurate filter options, obtain a reasonably specific location from the user. If the user has not provided a location, ask them. Acceptable specificity: - A locality or neighborhood (e.g., 'Koramangala, Bangalore', 'Indiranagar, Bangalore', 'Hauz Khas, Delhi') - A landmark or well-known place (e.g., 'near MG Road Metro Station', 'near India Gate') - A street or area (e.g., 'MG Road, Bangalore', 'Bandra West, Mumbai') Location handling: - ALWAYS ask the user for a place name, street, or landmark - NEVER ask for latitude/longitude - Once you have the place name, use web search to find the coordinates - If web search fails or is not supported, use your trained data to provide approximate coordinates - Convert the place name to latitude/longitude coordinates before calling this tool ⚠️ DO NOT accept bare city names (e.g., just 'Bangalore' or 'Delhi') without a locality. Locality/neighborhood level is sufficient — block-level or street-level precision is NOT required.

Get Dynamic Filters Movie

get_dynamic_filters_movie

Full Description

Fetches available movie filter options based on user's location.

WHEN TO USE: Call this BEFORE using *search_movies*, *search_theatres* or *search_shows* to get the current valid filter values for the user's area.

WHAT IT RETURNS:

Available filter names (e.g., genre, language, format)
Valid values for each filter (e.g., "Action", "Hindi", "IMAX")
Filter importance levels (which filters are most useful)

IMPORTANT: Filter values change by location and time, so always call this first to ensure you're using current, valid options.

Parameters (1 required)

Required

user_location

User's location for finding nearby movies and theaters (REQUIRED). For accurate filter options, obtain a reasonably specific location from the user. If the user has not provided a location, ask them. Acceptable specificity: - A locality or neighborhood (e.g., 'Koramangala, Bangalore', 'DLF Phase 3, Gurugram', 'Hauz Khas, Delhi') - A landmark or well-known place (e.g., 'near Cyber Hub', 'near Phoenix Mall') - A street or area (e.g., 'MG Road, Bangalore', 'Bandra West, Mumbai') Location handling: - ALWAYS ask the user for a place name, street, or landmark - NEVER ask for latitude/longitude - Once you have the place name, use web search to find the coordinates - If web search fails or is not supported, use your trained data to provide approximate coordinates - Convert the place name to latitude/longitude coordinates before calling this tool ⚠️ DO NOT accept bare city names (e.g., just 'Bangalore' or 'Delhi') without a locality. Locality/neighborhood level is sufficient — block-level or street-level precision is NOT required.

Get Movie Critique Reviews

get_movie_critique_reviews

Full Description

Get critique reviews and ratings for a specific movie from professional critics.

WHEN TO USE: When you have a specific movie and want to judge more about it — e.g., to understand critical reception, read professional reviews, or see critic ratings. This helps better understand the movie's quality from a critical perspective.

RETURNS:

List of critic reviews with reviewer name, review text, and source
List of critic ratings with rating value, rater name, and source
A movie may have no critique reviews — that's normal for newer or lesser-known films

IMPORTANT:

Requires a valid movie_id from search_movies results

Parameters (1 required)

Required

movie_idinteger

The movie ID to fetch critique reviews for. This is the movie_id obtained from search_movies results.

Search Dining Restaurants

search_dining_restaurants

Full Description

Search for dining restaurants using semantic search. This API is specifically designed for dining/dine-in restaurant discovery. Use this when users are looking for restaurants to visit for dining experiences.

⚠️ REQUIRED WORKFLOW: Step 1: Call get_dynamic_filters to fetch all supported filters and valid values Step 2: Use this tool (search_dining_restaurants) with appropriate filters from step 1

⚠️ FILTER BEHAVIOR:

Multiple filters in a single request are applied with AND logic
For OR logic, make separate requests with different filter values and combine results
Example: To find "Italian OR Chinese" restaurants, make 2 requests and merge results

Calling this tool without first calling get_dynamic_filters may result in using invalid filter values. CRITICAL: Ask the user to visit the booking_url to unlock more offers if they would like to make a booking at this restaurant.

Parameters (1 required, 3 optional)

Required

user_location

User's location (REQUIRED - latitude, longitude). For accurate restaurant results, obtain a reasonably specific location from the user. If the user has not provided a location, ask them. Acceptable specificity: - A locality or neighborhood (e.g., 'Koramangala, Bangalore', 'Indiranagar, Bangalore', 'Hauz Khas, Delhi') - A landmark or well-known place (e.g., 'near MG Road Metro Station', 'near India Gate') - A street or area (e.g., 'MG Road, Bangalore', 'Bandra West, Mumbai') Location format requirements: - If providing coordinates directly: latitude and longitude as floats (e.g., 12.9352, 77.6245) - If providing place name: you should use web search to find the coordinates of the location ⚠️ DO NOT accept bare city names (e.g., just 'Bangalore' or 'Delhi') without a locality. Locality/neighborhood level is sufficient — block-level or street-level precision is NOT required.

Optional

countinteger

Number of restaurants to retrieve, default to 10

Default: 10

filtersarray

Array of DiningSearchFilter objects. Each filter MUST be of the form: { "name": "<string>", "values": ["<string>", "..."] } - name must match a filter name returned by get_dynamic_filters - values must be chosen ONLY from valid_values for that filter if the filter is exhaustive ⚠️ FILTER LOGIC: - Multiple filters in the SAME request are combined with AND logic - For OR logic between filters, make SEPARATE requests and collate results Example: - AND: [{"name": "cuisine_type", "values": ["Italian"]}, {"name": "dish_beverage", "values": ["Pizza"]}] Returns restaurants that are BOTH Italian AND serves pizza - OR: Make 2 requests: Request 1: [{"name": "cuisine_type", "values": ["Italian"]}] Request 2: [{"name": "cuisine_type", "values": ["Chinese"]}] Then combine the results to get restaurants that are Italian OR Chinese

Default: null

should_show_moreboolean

Set to true when user asks for more restaurants from the previous search results. This helps retrieve additional results beyond the initial set.

Default: False

Search Movies

search_movies

Full Description

Searches for movies playing in theaters near the user's location or upcoming releases.

WHEN TO USE: When user wants to find movies by title, genre, cast, language, or other criteria. This tool covers both movies currently in cinema and those launching in the future.

RETURNS: List of movies with details including movie_id, title, cast, duration, rating, and movie detail page URL.

WORKFLOW: 1. FIRST call get_dynamic_filters_movie to get valid categorical filter values. 2. If the user's requested movie title / actor name / director name is not found in results of get_dynamic_filters_movie (allow for some spelling mistake), assume those are upcoming movies. And decide filter values according to user input. 3. THEN call this function with appropriate filters

SUPPORTED FILTERS: Categorical (get valid values from get_dynamic_filters_movie):

genre: e.g., "Action", "Comedy", "Drama"
language: e.g., "Hindi", "English", "Tamil"
cbfc_certification: e.g., "U", "U/A", "A"
director: Director name
actor: Actor name
movie_name: Full or partial movie title
screen_format : e.g., "2D", "3D"

Numeric/Date ranges (use your judgment based on user request):

duration_minutes_lower_limit: Minimum movie length in minutes
duration_minutes_upper_limit: Maximum movie length in minutes
release_date_lower_limit: Earliest release date (format: YYYY-MM-DD)
release_date_upper_limit: Latest release date (format: YYYY-MM-DD)

Parameters (1 required, 1 optional)

Required

location

User's location for the search (REQUIRED). For accurate movie results, obtain a reasonably specific location from the user. If the user has not provided a location, ask them. Acceptable specificity: - A locality or neighborhood (e.g., 'Koramangala, Bangalore', 'DLF Phase 3, Gurugram', 'Hauz Khas, Delhi') - A landmark or well-known place (e.g., 'near Cyber Hub', 'near Phoenix Mall') - A street or area (e.g., 'MG Road, Bangalore', 'Bandra West, Mumbai') Location handling: - ALWAYS ask the user for a place name, street, or landmark - NEVER ask for latitude/longitude - Once you have the place name, use web search to find the coordinates - If web search fails or is not supported, use your trained data to provide approximate coordinates - Convert the place name to latitude/longitude coordinates before calling this tool ⚠️ DO NOT accept bare city names (e.g., just 'Bangalore' or 'Delhi') without a locality. Locality/neighborhood level is sufficient — block-level or street-level precision is NOT required.

Optional

filtersarray

Optional array of filters to narrow search results.

Default: null

Search Shows

search_shows

Full Description

Searches for specific movie showtimes at theaters.

WHEN TO USE: When user wants to know showtime or available seats. Use this to find WHEN and WHERE a movie is playing, not to discover movies or theaters.

STEP 1: Get valid filter values >> get_required_movie_filters(user_location)

STEP 2: Resolve IDs (at least one required) >> search_movies(filters) → Get movie_id(s) >> search_theatres(filters) → Get theatre_id(s)

STEP 3: Search shows with IDs >> search_shows([movie_ids, theatre_ids, other_filters])

RETURNS:

Available showtimes with exact start times
Seat availability and pricing by category
Screen type and language for each show
Booking links or show_id for reservations

REQUIRED FILTERS (at least one):

movie_id: Single movie ID OR list of movie IDs from search_movies
theatre_id: Single theatre ID OR list of theatre IDs from search_theatres

CATEGORICAL FILTERS (get values from get_required_movie_filters):

language: e.g., "Hindi", "English", "Tamil"
screen_type: e.g., "IMAX", "3D", "4DX", "Dolby Atmos"

TIME/DATE FILTERS (use your judgment):

show_date: Specific date for showtimes (format: YYYY-MM-DD)
start_time_lower_limit: Earliest showtime (format: HH:MM, 24-hour)
start_time_upper_limit: Latest showtime (format: HH:MM, 24-hour)

PRICE FILTERS (use your judgment):

seat_price_lower_limit: Minimum ticket price in INR
seat_price_upper_limit: Maximum ticket price in INR

IMPORTANT NOTES:

Must include at least one: movie_id OR theatre_id (can be single or multiple)
Use arrays when searching across multiple movies/theaters simultaneously
Omitting movie_id returns shows for ALL movies at specified theaters
Omitting theatre_id returns shows for specified movies at ALL nearby theaters
Dates must be YYYY-MM-DD format
Times must be HH:MM in 24-hour format
Prices are in Indian Rupees (INR)

Parameters (2 required)

Required

filtersarray

Filters to find specific showtimes. Must include movie_id and/or theatre_id from previous search results, plus optional constraints like date, time, language.

location

User's location for the search (REQUIRED). For accurate showtime results, obtain a reasonably specific location from the user. If the user has not provided a location, ask them. Acceptable specificity: - A locality or neighborhood (e.g., 'Koramangala, Bangalore', 'DLF Phase 3, Gurugram', 'Hauz Khas, Delhi') - A landmark or well-known place (e.g., 'near Cyber Hub', 'near Phoenix Mall') - A street or area (e.g., 'MG Road, Bangalore', 'Bandra West, Mumbai') Location handling: - ALWAYS ask the user for a place name, street, or landmark - NEVER ask for latitude/longitude - Once you have the place name, use web search to find the coordinates - If web search fails or is not supported, use your trained data to provide approximate coordinates - Convert the place name to latitude/longitude coordinates before calling this tool ⚠️ DO NOT accept bare city names (e.g., just 'Bangalore' or 'Delhi') without a locality. Locality/neighborhood level is sufficient — block-level or street-level precision is NOT required.

Search Theatres

search_theatres

Full Description

Searches for movie theaters near the user's location.

WHEN TO USE: When user wants to find theaters by name, location, amenities, or screen type. Use this when focusing on WHERE to watch rather than WHAT to watch.

RETURNS: List of theaters with details including name,distance, available amenities, screen/seat types, and theatres detail page URL

WORKFLOW: 1. FIRST call get_dynamic_filters_movie to get valid categorical filter values 2. THEN call this function with appropriate filters

SUPPORTED FILTERS: Categorical (get valid values from get_dynamic_filters_movie):

theatre_name: Full or partial theater name (e.g., "PVR", "INOX")
screen_type: e.g., "IMAX", "4DX", "Dolby Atmos"
amenities: e.g., "Parking", "Food Court", "Wheelchair Access"

Distance ranges (use your judgment based on user request):

distance_lower_limit: Minimum distance from user in kilometers
distance_upper_limit: Maximum distance from user in kilometers

Parameters (1 required, 1 optional)

Required

location

User's location for the search (REQUIRED). For accurate theater results, obtain a reasonably specific location from the user. If the user has not provided a location, ask them. Acceptable specificity: - A locality or neighborhood (e.g., 'Koramangala, Bangalore', 'DLF Phase 3, Gurugram', 'Hauz Khas, Delhi') - A landmark or well-known place (e.g., 'near Cyber Hub', 'near Phoenix Mall') - A street or area (e.g., 'MG Road, Bangalore', 'Bandra West, Mumbai') Location handling: - ALWAYS ask the user for a place name, street, or landmark - NEVER ask for latitude/longitude - Once you have the place name, use web search to find the coordinates - If web search fails or is not supported, use your trained data to provide approximate coordinates - Convert the place name to latitude/longitude coordinates before calling this tool ⚠️ DO NOT accept bare city names (e.g., just 'Bangalore' or 'Delhi') without a locality. Locality/neighborhood level is sufficient — block-level or street-level precision is NOT required.

Optional

filtersarray

Optional array of filters to narrow theater search results.

Default: null

Links

Website Privacy Policy Terms of Service