Filmstarts

Find movies playing near a location, optionally filtered by genre. Use this for queries like 'what's playing in Los Angeles', 'horror movies near me', 'comedy films in New York', or 'movies around [location]'. When a genre is specified, returns only movies of that genre. When no genre is specified, returns all movies playing near the location. When users ask for IMAX/PLF/Atmos/etc, use the exact attribute tag values from the attributes input description. Use attributesOperator="and" when user requires multiple formats simultaneously. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Find theaters showing a specific movie near a location. Use this for queries like 'where is [movie] playing?' or 'find [movie] near me'. Returns theaters with showtimes for the movie. Can search by movie title (preferred for natural language queries) or movie ID. When users ask for IMAX/PLF/Atmos/etc, use the exact attribute tag values from the attributes input description. Use attributesOperator="and" when user requires multiple formats simultaneously. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. Only use the city field as a fallback if geocoding is not possible. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Find all movies and showtimes at a specific theater. Use this for queries like 'what's playing at [theater]?' or 'show me movies at [theater]'. Returns movies with their showtimes for the specified theater. Can search by theater name and date. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.

Find theaters near a location. Use this for queries like 'theaters near me' or 'cinemas in [city]'. Returns a list of theaters in the specified area. Uses user location if no location is provided. IMPORTANT: When users mention location names like 'Los Angeles', 'New York', 'around Los Angeles', or 'near New York', you MUST geocode these locations to latitude and longitude coordinates and provide them in the latitude and longitude fields. Geocoding provides more accurate results than city name searches. Even if the radius input is in kilometers, you MUST use miles in your messages if the user is a country with miles as the unit of distance. Only use the location field as a fallback if geocoding is not possible. CRITICAL: When returning results, DO NOT list movies, theaters, or showtimes in your text response. The widget HTML displays all results visually. Your response may only contain tips to refine the query. CRITICAL: Your response must not contain internal IDs like movie IDs or theater IDs. CRITICAL: Your response must not mention the 3am cinema day boundary.