Unified consumer search across movies, cinemas, cities and users.
Search across movies, cinemas, cities and users
Returns a single mixed, relevance-ranked list of movies, custom content, cinemas, cities and (for authenticated end users) users. An absent or empty query returns Popular Searches. Results are geo-aware when latitude/longitude are supplied.
query Parameters
queryFree-text query (1-100 chars). Absent or empty switches to Popular Searches mode.
typesRestrict result kinds (types[]=movies&types[]=cinemas or types=movies). Defaults to all. "movies" covers both films and custom content.
countriesFilter cinemas and cities by ISO-3166-1 alpha-2 country code(s) (countries[]=DE&countries[]=AT or countries=DE).
genresRestrict movie results to TMDB genre id(s) (genres[]=28&genres[]=12 or genres=28). Applies to the movie kind only; custom content is excluded when set.
cinemaSubscriptionProgramsRestrict cinema results to cinemas participating in the given subscription program(s). Applies to the cinema kind only.
accessibilityRestrict movie results to films whose GRETA accessibility data provides ALL of the given features (AND semantics). Country-scoped by countries[] when supplied. Applies to the movie kind only; custom content is excluded when set.
cinemaAccessibilityRestrict cinema results to venues providing ALL of the given accessibility features (AND semantics), each satisfied by at least one non-deleted room. Applies to the cinema kind only. Distinct from accessibility[], which describes the film.
latitudeSearcher latitude for proximity ranking and distance output.
longitudeSearcher longitude for proximity ranking and distance output.
pageperPageHeaders
Accept-LanguageLocale for movie titles and posters, resolved with the same fallback chain as /v2/movies (exact language+country, language only, fallback country, then the original title/artwork). Defaults to en. Other result kinds carry no translations and are unaffected.
Search across movies, cinemas, cities and users › Responses
A mixed, relevance-ranked list of search results. In query mode the payload also carries _kind_counts — matches per scope for the whole query (all, movies, cinemas, cities, users), independent of types[], so a scope selector can show a count per scope from one request. Absent in Popular Searches mode.
kindentityIdtitleslugreleaseYearcastNamesgenreNamesTMDB genre names in the Accept-Language language, resolved from the genre ids (tmdbdata stores only the import language). Populated for the movie kind only.
cityregioncountrystreetStreet and house number; populated for the cinema kind only.
zipCodePostal code; populated for the cinema kind only.
latitudelongitudedistanceMetersDistance in meters from the searcher location; null when the location is unknown.
imageRefimageUrl