Movies Expert
Movies Expert · GPT-Aktionen
Movies information database
Retrieves detailed movie infromation
GET /3/search/movieSearchMovieSearch for movies by their original, translated and alternative titles.
GET /3/movie/{movie_id}DetailsGet the top level details of a movie by ID. Returns: list of generes, IMDB ID, overview, poster path, release date, runtime, title, vote average, vote count, credits and videos
GET /3/search/personPersonSearch for people by their name and also known as names. You can query for directors and actors as well as their aliases.
GET /3/movie/{movie_id}/imagesImagesGet the images that belong to a movie.
GET /3/movie/{movie_id}/alternative_titlesAlternative TitlesGet the alternative titles for a movie.
GET /3/movie/{movie_id}/recommendationsRecommendationsGet a list of movies that are recommended for a given movie. Returns a list of recommended movies with title, poster path, release date, vote average, vote count, overview, genre ids, original language, original title, popularity, media type, ID
GET /3/movie/{movie_id}/similarSimilarGet the similar movies based on genres and keywords. This method only looks for other items based on genres and plot keywords
GET /3/movie/{movie_id}/videosVideosGet a list of videos related to the movie like trailers or featurettes
GET /3/movie/popularPopularGet a list of movies ordered by popularity.
GET /3/movie/top_ratedTop RatedGet a list of movies ordered by rating.
GET /3/movie/upcomingUpcomingGet a list of movies that are being released soon.
GET /3/movie/now_playingNow PlayingGet a list of movies that are currently in theatres.
GET /3/movie/latestLates movies listGet the newest movies list. Returns: list of generes, IMDB ID, overview, poster path, release date, runtime, title, vote average, vote count
Ursprüngliches API-Schema
{
"openapi": "3.1.0",
"info": {
"title": "Movies information database",
"description": "Retrieves detailed movie infromation",
"version": "v1.0.0"
},
"servers": [
{
"url": "https://api.themoviedb.org"
}
],
"components": {
"schemas": {}
},
"paths": {
"/3/search/movie": {
"get": {
"description": "Search for movies by their original, translated and alternative titles.",
"operationId": "SearchMovie",
"parameters": [
{
"name": "query",
"in": "query",
"required": true,
"description": "Movie title or a part of it",
"schema": {
"type": "string"
}
},
{
"name": "include_adult",
"in": "query",
"description": "Include adult movies",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "language",
"in": "query",
"description": "Language version of the response, for e.g.: en-US",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "primary_release_year",
"in": "query",
"schema": {
"type": "string"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "region",
"in": "query",
"schema": {
"type": "string"
}
},
{
"name": "year",
"in": "query",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/{movie_id}": {
"get": {
"summary": "Details",
"description": "Get the top level details of a movie by ID. Returns: list of generes, IMDB ID, overview, poster path, release date, runtime, title, vote average, vote count, credits and videos",
"operationId": "movieDetails",
"parameters": [
{
"name": "movie_id",
"in": "path",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "append_to_response",
"in": "query",
"description": "comma separated list of endpoints within this namespace, 20 items max",
"schema": {
"type": "string",
"default": "credits,videos"
}
},
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
}
],
"deprecated": false
}
},
"/3/search/person": {
"get": {
"summary": "Person",
"description": "Search for people by their name and also known as names. You can query for directors and actors as well as their aliases.",
"operationId": "searchPerson",
"parameters": [
{
"name": "query",
"in": "query",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "include_adult",
"in": "query",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
}
],
"deprecated": false
}
},
"/3/movie/{movie_id}/images": {
"get": {
"summary": "Images",
"description": "Get the images that belong to a movie.",
"operationId": "movieImages",
"parameters": [
{
"name": "movie_id",
"in": "path",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "include_image_language",
"in": "query",
"description": "specify a comma separated list of ISO-639-1 values to query, for example: `en,null`",
"schema": {
"type": "string"
}
},
{
"name": "language",
"in": "query",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/{movie_id}/alternative_titles": {
"get": {
"summary": "Alternative Titles",
"description": "Get the alternative titles for a movie.",
"operationId": "movieAlternativeTitles",
"parameters": [
{
"name": "movie_id",
"in": "path",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "country",
"in": "query",
"description": "specify a ISO-3166-1 value to filter the results",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/{movie_id}/recommendations": {
"get": {
"summary": "Recommendations",
"description": "Get a list of movies that are recommended for a given movie. Returns a list of recommended movies with title, poster path, release date, vote average, vote count, overview, genre ids, original language, original title, popularity, media type, ID",
"operationId": "movieRecommendations",
"parameters": [
{
"name": "movie_id",
"in": "path",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
}
],
"deprecated": false
}
},
"/3/movie/{movie_id}/similar": {
"get": {
"summary": "Similar",
"description": "Get the similar movies based on genres and keywords. This method only looks for other items based on genres and plot keywords",
"operationId": "movieSimilar",
"parameters": [
{
"name": "movie_id",
"in": "path",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
}
],
"deprecated": false
}
},
"/3/movie/{movie_id}/videos": {
"get": {
"summary": "Videos",
"description": "Get a list of videos related to the movie like trailers or featurettes",
"operationId": "movieVideos",
"parameters": [
{
"name": "movie_id",
"in": "path",
"schema": {
"type": "integer",
"format": "int32"
},
"required": true
},
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
}
],
"deprecated": false
}
},
"/3/movie/popular": {
"get": {
"summary": "Popular",
"description": "Get a list of movies ordered by popularity.",
"operationId": "moviePopularList",
"parameters": [
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "region",
"in": "query",
"description": "ISO-3166-1 code",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/top_rated": {
"get": {
"summary": "Top Rated",
"description": "Get a list of movies ordered by rating.",
"operationId": "movieTopRatedList",
"parameters": [
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "region",
"in": "query",
"description": "ISO-3166-1 code",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/upcoming": {
"get": {
"summary": "Upcoming",
"description": "Get a list of movies that are being released soon.",
"operationId": "movieUpcomingList",
"parameters": [
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "region",
"in": "query",
"description": "ISO-3166-1 code",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/now_playing": {
"get": {
"summary": "Now Playing",
"description": "Get a list of movies that are currently in theatres.",
"operationId": "movieNowPlayingList",
"parameters": [
{
"name": "language",
"in": "query",
"schema": {
"type": "string",
"default": "en-US"
}
},
{
"name": "page",
"in": "query",
"schema": {
"type": "integer",
"format": "int32",
"default": 1
}
},
{
"name": "region",
"in": "query",
"description": "ISO-3166-1 code",
"schema": {
"type": "string"
}
}
],
"deprecated": false
}
},
"/3/movie/latest": {
"get": {
"summary": "Lates movies list",
"description": "Get the newest movies list. Returns: list of generes, IMDB ID, overview, poster path, release date, runtime, title, vote average, vote count",
"operationId": "movieLatestId",
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"adult": {
"type": "boolean",
"example": false,
"default": true
},
"backdrop_path": {},
"belongs_to_collection": {},
"budget": {
"type": "integer",
"example": 0,
"default": 0
},
"genres": {
"type": "array"
},
"homepage": {
"type": "string",
"example": ""
},
"id": {
"type": "integer",
"example": 1119232,
"default": 0
},
"imdb_id": {},
"original_language": {
"type": "string",
"example": "fr"
},
"original_title": {
"type": "string",
"example": "König Charles III"
},
"overview": {
"type": "string",
"example": ""
},
"popularity": {
"type": "integer",
"example": 0,
"default": 0
},
"poster_path": {},
"production_companies": {
"type": "array"
},
"production_countries": {
"type": "array"
},
"release_date": {
"type": "string",
"example": ""
},
"revenue": {
"type": "integer",
"example": 0,
"default": 0
},
"runtime": {
"type": "integer",
"example": 0,
"default": 0
},
"spoken_languages": {
"type": "array"
},
"status": {
"type": "string",
"example": "Released"
},
"tagline": {
"type": "string",
"example": ""
},
"title": {
"type": "string",
"example": "König Charles III"
},
"video": {
"type": "boolean",
"example": false,
"default": true
},
"vote_average": {
"type": "integer",
"example": 0,
"default": 0
},
"vote_count": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
}
}
}
},
"deprecated": false
}
}
}
}