{
"swagger": "2.0",
"info": {
"version": "3",
"title": "API",
"description": "## Welcome\n\nThis is a place to put general notes and extra information, for internal use.\n\nTo get started designing/documenting this API, select a version on the left. # Title\nNo Description"
},
"host": "api.themoviedb.org",
"basePath": "/3",
"schemes": [
"https",
"http"
],
"produces": [
"application/json"
],
"securityDefinitions": {
"api_key": {
"name": "api_key",
"type": "apiKey",
"in": "query"
}
},
"paths": {
"/account": {
"get": {
"operationId": "get-current-account-details",
"summary": "Get Details",
"tags": [
"Account"
],
"description": "Get your account details.",
"parameters": [
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/account-details"
},
"examples": {
"application/json": {
"avatar": {
"gravatar": {
"hash": "c9e9fc152ee756a900db85757c29815d"
}
},
"id": 548,
"iso_639_1": "en",
"iso_3166_1": "CA",
"name": "Travis Bell",
"include_adult": true,
"username": "travisbell"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/lists": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-current-account-lists-paginated",
"summary": "Get Created Lists",
"tags": [
"Account"
],
"description": "Get all of the lists created by an account. Will invlude private lists if you are the owner.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lists-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"description": "Name pretty much says it all, here's the top 50 grossing films of all time.",
"favorite_count": 0,
"id": 10,
"item_count": 0,
"iso_639_1": "en",
"list_type": "movie",
"name": "Top 50 Grossing Films of All Time (Worldwide)",
"poster_path": null
}
],
"total_pages": 4,
"total_results": 61
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/favorite/movies": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-account-favorite-movies-paginated",
"summary": "Get Favorite Movies",
"tags": [
"Account"
],
"description": "Get the list of your favorite movies.",
"parameters": [
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
16
],
"id": 9806,
"original_language": "en",
"original_title": "The Incredibles",
"overview": "Bob Parr has given up his superhero days to log in time as an insurance adjuster and raise his three children with his formerly heroic wife in suburbia. But when he receives a mysterious assignment, it's time to get back into costume.",
"release_date": "2004-11-04",
"poster_path": null,
"popularity": 0.167525,
"title": "The Incredibles",
"video": false,
"vote_average": 6.8,
"vote_count": 1584
}
],
"total_pages": 4,
"total_results": 77
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/favorite/tv": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-account-favorite-tv-paginated",
"summary": "Get Favorite TV Shows",
"tags": [
"Account"
],
"description": "Get the list of your favorite TV shows.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"backdrop_path": null,
"first_air_date": "2007-09-24",
"genre_ids": [
10759
],
"id": 1404,
"original_language": "en",
"original_name": "Chuck",
"overview": "Chuck is an American action-comedy/spy-drama television series created by Josh Schwartz and Chris Fedak. The series is about an \"average computer-whiz-next-door\" named Chuck, played by Zachary Levi, who receives an encoded e-mail from an old college friend now working for the Central Intelligence Agency; the message embeds the only remaining copy of a software program containing the United States' greatest spy secrets into Chuck's brain.",
"origin_country": [
"US"
],
"poster_path": null,
"popularity": 0.125125,
"name": "Chuck",
"vote_average": 8.2,
"vote_count": 37
}
],
"total_pages": 3,
"total_results": 52
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/favorite": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"post": {
"operationId": "post-account-favorite",
"summary": "Mark as Favorite",
"tags": [
"Account"
],
"description": "This method allows you to mark a movie or TV show as a favorite item.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:mediaFavoriteBody"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/rated/movies": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-account-rated-movies-paginated",
"summary": "Get Rated Movies",
"tags": [
"Account"
],
"description": "Get a list of all the movies you have rated.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
28
],
"id": 155,
"original_language": "en",
"original_title": "The Dark Knight",
"overview": "Batman raises the stakes in his war on crime. With the help of Lt. Jim Gordon and District Attorney Harvey Dent, Batman sets out to dismantle the remaining criminal organizations that plague the streets. The partnership proves to be effective, but they soon find themselves prey to a reign of chaos unleashed by a rising criminal mastermind known to the terrified citizens of Gotham as the Joker.",
"release_date": "2008-07-18",
"poster_path": null,
"popularity": 0.293783,
"title": "The Dark Knight",
"video": false,
"vote_average": 7.9,
"vote_count": 5504,
"rating": 9
}
],
"total_pages": 31,
"total_results": 605
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/rated/tv": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-account-rated-tv-paginated",
"summary": "Get Rated TV Shows",
"tags": [
"Account"
],
"description": "Get a list of all the TV shows you have rated.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"backdrop_path": null,
"first_air_date": "2008-09-09",
"genre_ids": [
18
],
"id": 1705,
"original_language": "en",
"original_name": "Fringe",
"overview": "Fringe is an American science fiction television series that follows Olivia Dunham, Peter Bishop, and Walter Bishop, members of a Federal Bureau of Investigation \"Fringe Division\" team based in Boston, Massachusetts under the supervision of Homeland Security. The team uses \"fringe\" science and FBI investigative techniques to investigate a series of unexplained, often ghastly occurrences, which are related to mysteries surrounding a parallel universe. The series has been described as a hybrid of The X-Files, Altered States, and The Twilight Zone.",
"origin_country": [
"US"
],
"poster_path": null,
"popularity": 0.372415,
"name": "Fringe",
"vote_average": 8.4,
"vote_count": 46,
"rating": 9
}
],
"total_pages": 7,
"total_results": 139
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/rated/tv/episodes": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-account-rated-tv-episodes-paginated",
"summary": "Get Rated TV Episodes",
"tags": [
"Account"
],
"description": "Get a list of all the TV episodes you have rated.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-episodes-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"_id": "5256cff619c2956ff60a2ce2",
"air_date": "2013-10-15",
"episode_number": 5,
"name": "The Workplace Proximity",
"id": 64782,
"season_number": 7,
"still_path": null,
"show_id": 1418,
"vote_average": 8.5,
"vote_count": 3,
"rating": 8
}
],
"total_pages": 2,
"total_results": 21
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/watchlist/movies": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-account-watchlist-movies-paginated",
"summary": "Get Movie Watchlist",
"tags": [
"Account"
],
"description": "Get a list of all the movies you have added to your watchlist.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
18
],
"id": 76726,
"original_language": "it",
"original_title": "Chronicle",
"overview": "Three high school students make an incredible discovery, leading to their developing uncanny powers beyond their understanding. As they learn to control their abilities and use them to their advantage, their lives start to spin out of control, and their darker sides begin to take over.",
"release_date": "2012-02-02",
"poster_path": null,
"popularity": 0.237951,
"title": "Chronicle",
"video": false,
"vote_average": 6.2,
"vote_count": 545
}
],
"total_pages": 14,
"total_results": 277
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/watchlist/tv": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-account-watchlist-tv-paginated",
"summary": "Get TV Show Watchlist",
"tags": [
"Account"
],
"description": "Get a list of all the TV shows you have added to your watchlist.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"backdrop_path": null,
"first_air_date": "2013-09-26",
"genre_ids": [
35
],
"id": 58932,
"original_language": "en",
"original_name": "The Crazy Ones",
"overview": "The Crazy Ones is an American situation comedy series created by David E. Kelley that stars Robin Williams and Sarah Michelle Gellar. The single-camera project premiered on CBS on September 26, 2013, as part of the 2013–14 American television season as a Thursday night 9 pm entry. Bill D'Elia, Dean Lorey, Jason Winer, John Montgomery and Mark Teitelbaum serve as executive producers for 20th Century Fox Television.",
"origin_country": [
"US"
],
"poster_path": null,
"popularity": 0.075407,
"name": "The Crazy Ones",
"vote_average": 5.3,
"vote_count": 4
}
],
"total_pages": 4,
"total_results": 64
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/account/{account_id}/watchlist": {
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"post": {
"operationId": "post-account-watchlist",
"summary": "Add to Watchlist",
"tags": [
"Account"
],
"description": "Add a movie or TV show to your watchlist.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:mediaWatchlistBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/authentication/guest_session/new": {
"get": {
"operationId": "get-new-authentication-guest-session",
"summary": "Create Guest Session",
"tags": [
"Authentication"
],
"description": "This method will let you create a new guest session. Guest sessions are a type of session that will let a user rate movies and TV shows but not require them to have a TMDb user account. More information about user authentication can be found [here](#docTextSection:NSZtgz7zptsiLYxXZ).\n\nPlease note, you should only generate a single guest session per user (or device) as you will be able to attach the ratings to a TMDb user account in the future. There is also IP limits in place so you should always make sure it's the end user doing the guest session actions.\n\nIf a guest session is not used for the first time within 24 hours, it will be automatically deleted.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/guest-session-response"
},
"examples": {
"application/json": {
"success": true,
"guest_session_id": "1ce82ec1223641636ad4a60b07de3581",
"expires_at": "2016-08-27 16:26:40 UTC"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/authentication/token/new": {
"get": {
"operationId": "get-new-authentication-token",
"summary": "Create Request Token",
"tags": [
"Authentication"
],
"description": "Create a temporary request token that can be used to validate a TMDb user login. More details about how this works can be found [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/token-response-with-expiration"
},
"examples": {
"application/json": {
"success": true,
"expires_at": "2016-08-26 17:04:39 UTC",
"request_token": "ff5c7eeb5a8870efe3cd7fc5c282cffd26800ecd"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/authentication/session": {
"delete": {
"operationId": "delete-authentication-session",
"summary": "Delete Session",
"tags": [
"Authentication"
],
"description": "If you would like to delete (or \"logout\") from a session, call this method with a valid session ID.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/success-response"
},
"examples": {
"application/json": {
"success": true
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/authentication/session/convert/4": {
"post": {
"operationId": "post-authentication-session-convert-4",
"summary": "Create Session (from v4 access token)",
"tags": [
"Authentication"
],
"description": "Use this method to create a v3 session ID if you already have a valid v4 access token. The v4 token needs to be authenticated by the user. Your standard \"read token\" will not validate to create a session ID.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:tokenBody"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/session-response"
},
"examples": {
"application/json": {
"success": true,
"session_id": "2629f70fb498edc263a0adb99118ac41f0053e8c"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/authentication/session/new": {
"get": {
"operationId": "get-new-authentication-session",
"summary": "Create Session",
"tags": [
"Authentication"
],
"description": "You can use this method to create a fully valid session ID once a user has validated the request token. More information about how this works can be found [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"parameters": [
{
"name": "request_token",
"in": "query",
"required": true,
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/session-response"
},
"examples": {
"application/json": {
"success": true,
"session_id": "79191836ddaa0da3df76a5ffef6f07ad6ab0c641"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/authentication/token/validate_with_login": {
"get": {
"operationId": "get-validate-authentication-token-with-login",
"summary": "Validate Request Token",
"tags": [
"Authentication"
],
"description": "This method allows an application to validate a request token by entering a username and password.\n\n#### Caution\nPlease note, using this method is **strongly discouraged**. The preferred method of validating a request token is to have a user authenticate the request via the TMDb website. You can read about that method [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"parameters": [
{
"name": "username",
"in": "query",
"required": true,
"type": "string"
},
{
"name": "password",
"in": "query",
"required": true,
"type": "string"
},
{
"name": "request_token",
"in": "query",
"required": true,
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/token-response"
},
"examples": {
"application/json": {
"success": true,
"request_token": "496584e52d7d11cc6f44a1302fa89598c0addc85"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/certification/movie/list": {
"get": {
"operationId": "get-movie-certifications-list",
"summary": "Get Movie Certifications",
"tags": [
"Certifications"
],
"description": "Get an up to date list of the officially supported movie certifications on TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/certifications"
},
"examples": {
"application/json": {
"certifications": {
"US": [
{
"certification": "G",
"meaning": "All ages admitted. There is no content that would be objectionable to most parents. This is one of only two ratings dating back to 1968 that still exists today.",
"order": 1
},
{
"certification": "PG-13",
"meaning": "Some material may be inappropriate for children under 13. Films given this rating may contain sexual content, brief or partial nudity, some strong language and innuendo, humor, mature themes, political themes, terror and/or intense action violence. However, bloodshed is rarely present. This is the minimum rating at which drug content is present.",
"order": 3
},
{
"certification": "R",
"meaning": "Under 17 requires accompanying parent or adult guardian 21 or older. The parent/guardian is required to stay with the child under 17 through the entire movie, even if the parent gives the child/teenager permission to see the film alone. These films may contain strong profanity, graphic sexuality, nudity, strong violence, horror, gore, and strong drug use. A movie rated R for profanity often has more severe or frequent language than the PG-13 rating would permit. An R-rated movie may have more blood, gore, drug use, nudity, or graphic sexuality than a PG-13 movie would admit.",
"order": 4
},
{
"certification": "NC-17",
"meaning": "These films contain excessive graphic violence, intense or explicit sex, depraved, abhorrent behavior, explicit drug abuse, strong language, explicit nudity, or any other elements which, at present, most parents would consider too strong and therefore off-limits for viewing by their children and teens. NC-17 does not necessarily mean obscene or pornographic in the oft-accepted or legal meaning of those words.",
"order": 5
},
{
"certification": "NR",
"meaning": "No rating information.",
"order": 0
},
{
"certification": "PG",
"meaning": "Some material may not be suitable for children under 10. These films may contain some mild language, crude/suggestive humor, scary moments and/or violence. No drug content is present. There are a few exceptions to this rule. A few racial insults may also be heard.",
"order": 2
}
],
"CA": [
{
"certification": "18A",
"meaning": "Persons under 18 years of age must be accompanied by an adult. In the Maritimes & Manitoba, children under the age of 14 are prohibited from viewing the film.",
"order": 4
},
{
"certification": "G",
"meaning": "All ages.",
"order": 1
},
{
"certification": "PG",
"meaning": "Parental guidance advised. There is no age restriction but some material may not be suitable for all children.",
"order": 2
},
{
"certification": "14A",
"meaning": "Persons under 14 years of age must be accompanied by an adult.",
"order": 3
},
{
"certification": "A",
"meaning": "Admittance restricted to people 18 years of age or older. Sole purpose of the film is the portrayal of sexually explicit activity and/or explicit violence.",
"order": 5
}
],
"FR": [
{
"certification": "U",
"meaning": "(Tous publics) valid for all audiences.",
"order": 1
},
{
"certification": "12",
"meaning": "(Interdit aux moins de 12 ans) unsuitable for children younger than 12 or forbidden in cinemas for under 12.",
"order": 3
},
{
"certification": "10",
"meaning": "(Déconseillé aux moins de 10 ans) unsuitable for children younger than 10 (this rating is only used for TV); equivalent in theatres : \"avertissement\" (warning), some scenes may be disturbing to young children and sensitive people; equivalent on video : \"accord parental\" (parental guidance).",
"order": 2
},
{
"certification": "16",
"meaning": "(Interdit aux moins de 16 ans) unsuitable for children younger than 16 or forbidden in cinemas for under 16.",
"order": 4
},
{
"certification": "18",
"meaning": "(Interdit aux mineurs) unsuitable for children younger than 18 or forbidden in cinemas for under 18.",
"order": 5
}
]
}
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/certification/tv/list": {
"get": {
"operationId": "get-tv-certifications-list",
"summary": "Get TV Certifications",
"tags": [
"Certifications"
],
"description": "Get an up to date list of the officially supported TV show certifications on TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/certifications"
},
"examples": {
"application/json": {
"certifications": {
"RU": [
{
"certification": "18+",
"meaning": "Restricted to People 18 or Older.",
"order": 5
},
{
"certification": "0+",
"meaning": "Can be watched by Any Age.",
"order": 1
},
{
"certification": "6+",
"meaning": "Only kids the age of 6 or older can watch.",
"order": 2
},
{
"certification": "12+",
"meaning": "Only kids the age of 12 or older can watch.",
"order": 3
},
{
"certification": "16+",
"meaning": "Only teens the age of 16 or older can watch.",
"order": 4
}
],
"US": [
{
"certification": "NR",
"meaning": "No rating information.",
"order": 0
},
{
"certification": "TV-Y",
"meaning": "This program is designed to be appropriate for all children.",
"order": 1
},
{
"certification": "TV-Y7",
"meaning": "This program is designed for children age 7 and above.",
"order": 2
},
{
"certification": "TV-G",
"meaning": "Most parents would find this program suitable for all ages.",
"order": 3
},
{
"certification": "TV-PG",
"meaning": "This program contains material that parents may find unsuitable for younger children.",
"order": 4
},
{
"certification": "TV-14",
"meaning": "This program contains some material that many parents would find unsuitable for children under 14 years of age.",
"order": 5
},
{
"certification": "TV-MA",
"meaning": "This program is specifically designed to be viewed by adults and therefore may be unsuitable for children under 17.",
"order": 6
}
],
"FR": [
{
"certification": "NR",
"meaning": "No rating information.",
"order": 0
},
{
"certification": "10",
"meaning": "Not recommended for children under 10. Not allowed in children's television series.",
"order": 1
},
{
"certification": "12",
"meaning": "Not recommended for children under 12. Not allowed air before 10:00 p.m. Some channels and programs are subject to exception.",
"order": 2
},
{
"certification": "16",
"meaning": "Not recommended for children under 16. Not allowed air before 10:30 p.m. Some channels and programs are subject to exception.",
"order": 3
},
{
"certification": "18",
"meaning": "Not recommended for persons under 18. Allowed between midnight and 5 a.m. and only in some channels, access to these programs is locked by a personal password.",
"order": 4
}
]
}
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/collection/{collection_id}": {
"parameters": [
{
"name": "collection_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-collection-details",
"summary": "Get Details",
"tags": [
"Collections"
],
"description": "Get collection details by id.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/collection-object"
},
"examples": {
"application/json": {
"id": 10,
"name": "Star Wars Collection",
"overview": "An epic space opera theatrical film series created by George Lucas.\r The first film in the franchise was originally released on May 25, 1977, by 20th Century Fox, and became a worldwide pop culture phenomenon, followed by two sequels, released at three-year intervals. Sixteen years after the release of the trilogy's final film, the first in a new prequel trilogy of films was released, again released at three-year intervals, with the final film released on May 19, 2005.",
"poster_path": null,
"backdrop_path": "/shDFE0i7josMt9IKXdYpnMFFgNV.jpg",
"parts": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
12
],
"id": 11,
"original_language": "en",
"original_title": "Star Wars: Episode IV - A New Hope",
"overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.",
"release_date": "1977-05-23",
"poster_path": "/AbJBXaVPrdXROwb8KmgWUPU2XJX.jpg",
"popularity": 1.411624,
"title": "Star Wars: Episode IV - A New Hope",
"video": false,
"vote_average": 7.7,
"vote_count": 2472
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/collection/{collection_id}/images": {
"parameters": [
{
"name": "collection_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-collection-images-list",
"summary": "Get Images",
"tags": [
"Collections"
],
"description": "Get the images for a collection by id.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 10,
"backdrops": [
{
"aspect_ratio": 1.77777777777778,
"file_path": "/shDFE0i7josMt9IKXdYpnMFFgNV.jpg",
"height": 1080,
"iso_639_1": null,
"vote_average": 5.3125,
"vote_count": 1,
"width": 1920
}
],
"posters": [
{
"aspect_ratio": 0.666666666666667,
"file_path": "/hznxm4di88tWJHiCGWYDXeKk1Ih.jpg",
"height": 1500,
"iso_639_1": "en",
"vote_average": 5.3125,
"vote_count": 1,
"width": 1000
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/collection/{collection_id}/translations": {
"parameters": [
{
"name": "collection_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-collection-translations-list",
"summary": "Get Translations",
"tags": [
"Collections"
],
"description": "Get the list translations for a collection by id.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/translations-list"
},
"examples": {
"application/json": {
"id": 645,
"translations": [
{
"iso_3166_1": "US",
"iso_639_1": "en",
"name": "English",
"english_name": "English",
"data": {
"title": "",
"overview": "The James Bond film series is a British series of spy films based on the fictional character of MI6 agent James Bond, codename \"007\". With all of the action, adventure, gadgetry & film scores that Bond is famous for. (We do not consider the 1954 release of Casino Royale for this series because it was actually a television episode and not a theatrical film.)",
"homepage": "http://www.007.com/"
}
},
{
"iso_3166_1": "MX",
"iso_639_1": "es",
"name": "Español",
"english_name": "Spanish",
"data": {
"title": "",
"overview": "",
"homepage": ""
}
},
{
"iso_3166_1": "FR",
"iso_639_1": "fr",
"name": "Français",
"english_name": "French",
"data": {
"title": "James Bond - Saga",
"overview": "James Bond, agent 007, autorisé à tuer, est le héros de la plus longue saga cinématographique de tous les temps, au succès sans égal. Armé de son Walther PPK, accompagné des plus jolies filles de la terre et opposé aux plus cyniques des méchants, il a poursuivi le mal aux quatre coins du monde, survécu à la guerre froide et à la Chute du mur de Berlin.",
"homepage": "http://www.007.com"
}
},
{
"iso_3166_1": "TW",
"iso_639_1": "zh",
"name": "普通话",
"english_name": "Mandarin",
"data": {
"title": "007詹姆士龐德 系列",
"overview": "",
"homepage": ""
}
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/company/{company_id}": {
"parameters": [
{
"name": "company_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-company-details",
"summary": "Get Details",
"tags": [
"Companies"
],
"description": "Get a companies details by id.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/company-details"
},
"examples": {
"application/json": {
"description": null,
"headquarters": "San Francisco, California",
"homepage": "http://www.lucasfilm.com",
"id": 1,
"logo_path": null,
"name": "Lucasfilm",
"parent_company": null
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/company/{company_id}/images": {
"parameters": [
{
"name": "company_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-company-images",
"summary": "Get Images",
"tags": [
"Companies"
],
"description": "Get company logos by id.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 670,
"logos": [
{
"aspect_ratio": 1.35,
"file_path": "/rRGi5UkwvdOPSfr5Xf42RZUsYgd.png",
"height": 240,
"id": "5aa58f900e0a26075d02b913",
"file_type": ".svg",
"vote_average": 0,
"vote_count": 0,
"width": 324
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/company/{company_id}/movies": {
"parameters": [
{
"name": "company_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-company-movies-paginated",
"summary": "Get Movies",
"tags": [
"Companies"
],
"description": "Get the movies of a company by id.\n\nWe highly recommend using [movie discover](#endpoint:p5NyoR7dM842S8G9j) instead of this method as it is much more flexible.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"id": 1,
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
28
],
"id": 140607,
"original_language": "en",
"original_title": "Star Wars: Episode VII - The Force Awakens",
"overview": "A continuation of the saga created by George Lucas, set thirty years after Star Wars: Episode VI – Return of the Jedi.",
"release_date": "2015-12-16",
"poster_path": "/2HkBLnp20hoKsMAUCmn5LTZ5aSB.jpg",
"popularity": 1.605747,
"title": "Star Wars: Episode VII - The Force Awakens",
"video": false,
"vote_average": 5.3,
"vote_count": 3
}
],
"total_pages": 3,
"total_results": 53
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/configuration": {
"get": {
"operationId": "get-configuration",
"summary": "Get API Configuration",
"tags": [
"Configuration"
],
"description": "Get the system wide configuration information. Some elements of the API require some knowledge of this configuration data. The purpose of this is to try and keep the actual API responses as light as possible. It is recommended you cache this data within your application and check for updates every few days.\n\nThis method currently holds the data relevant to building image URLs as well as the change key map.\n\nTo build an image URL, you will need 3 pieces of data. The `base_url`, `size` and `file_path`. Simply combine them all and you will have a fully qualified URL. Here’s an example URL:\n\n https://image.tmdb.org/t/p/w500/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg\n\nThe configuration method also contains the list of change keys which can be useful if you are building an app that consumes data from the change feed.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/configuration"
},
"examples": {
"application/json": {
"images": {
"base_url": "http://image.tmdb.org/t/p/",
"secure_base_url": "https://image.tmdb.org/t/p/",
"backdrop_sizes": [
"w300",
"w780",
"w1280",
"original"
],
"logo_sizes": [
"w45",
"w92",
"w154",
"w185",
"w300",
"w500",
"original"
],
"poster_sizes": [
"w92",
"w154",
"w185",
"w342",
"w500",
"w780",
"original"
],
"profile_sizes": [
"w45",
"w185",
"h632",
"original"
],
"still_sizes": [
"w92",
"w185",
"w300",
"original"
]
},
"change_keys": [
"adult",
"air_date",
"also_known_as",
"alternative_titles",
"biography",
"birthday",
"budget",
"cast",
"certifications",
"character_names",
"created_by",
"crew",
"deathday",
"episode",
"episode_number",
"episode_run_time",
"freebase_id",
"freebase_mid",
"general",
"genres",
"guest_stars",
"homepage",
"images",
"imdb_id",
"languages",
"name",
"network",
"origin_country",
"original_name",
"original_title",
"overview",
"parts",
"place_of_birth",
"plot_keywords",
"production_code",
"production_companies",
"production_countries",
"releases",
"revenue",
"runtime",
"season",
"season_number",
"season_regular",
"spoken_languages",
"status",
"tagline",
"title",
"translations",
"tvdb_id",
"tvrage_id",
"type",
"video",
"videos"
]
}
}
}
},
"security": [
{
"api_key": []
}
]
}
},
"/configuration/countries": {
"get": {
"operationId": "get-countries-list",
"summary": "Get Countries",
"tags": [
"Configuration"
],
"description": "Get the list of countries (ISO 3166-1 tags) used throughout TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/translation"
}
},
"examples": {
"application/json": [
{
"iso_3166_1": "FR",
"english_name": "France"
},
{
"iso_3166_1": "GA",
"english_name": "Gabon"
},
{
"iso_3166_1": "GB",
"english_name": "United Kingdom"
}
]
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/configuration/jobs": {
"get": {
"operationId": "get-jobs-list",
"summary": "Get Jobs",
"tags": [
"Configuration"
],
"description": "The the list of official jobs that are used on TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/jobs"
}
},
"examples": {
"application/json": [
{
"department": "Writing",
"jobs": [
"Screenplay"
]
}
]
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/configuration/languages": {
"get": {
"operationId": "get-languages-list",
"summary": "Get Languages",
"tags": [
"Configuration"
],
"description": "Get the list of languages (ISO 639-1 tags) used throughout TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/translation"
}
},
"examples": {
"application/json": [
{
"iso_639_1": "xx",
"english_name": "No Language",
"name": "No Language"
},
{
"iso_639_1": "fr",
"english_name": "French",
"name": "Français"
}
]
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/configuration/primary_translations": {
"get": {
"operationId": "get-primary-translations-list",
"summary": "Get primary translations",
"tags": [
"Configuration"
],
"description": "Get a list of the officially supported translations on TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"examples": {
"application/json": [
"fi-FI",
"fr-CA",
"fr-FR",
"gl-ES",
"he-IL"
]
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/configuration/timezones": {
"get": {
"operationId": "get-timezones-list",
"summary": "Get List",
"tags": [
"Configuration"
],
"description": "Get the list of supported timezones on TMDb.",
"responses": {
"200": {
"description": "",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/timezones"
}
},
"examples": {
"application/json": [
{
"iso_3166_1": "AD",
"zones": [
"Europe/Andorra"
]
},
{
"iso_3166_1": "AQ",
"zones": [
"Antarctica/McMurdo",
"Antarctica/Rothera",
"Antarctica/Palmer",
"Antarctica/Mawson",
"Antarctica/Davis",
"Antarctica/Casey",
"Antarctica/Vostok",
"Antarctica/DumontDUrville",
"Antarctica/Syowa",
"Antarctica/Troll"
]
},
{
"iso_3166_1": "AR",
"zones": [
"America/Argentina/Buenos_Aires",
"America/Argentina/Cordoba",
"America/Argentina/Salta",
"America/Argentina/Jujuy",
"America/Argentina/Tucuman",
"America/Argentina/Catamarca",
"America/Argentina/La_Rioja",
"America/Argentina/San_Juan",
"America/Argentina/Mendoza",
"America/Argentina/San_Luis",
"America/Argentina/Rio_Gallegos",
"America/Argentina/Ushuaia"
]
},
{
"iso_3166_1": "ES",
"zones": [
"Europe/Madrid",
"Africa/Ceuta",
"Atlantic/Canary"
]
},
{
"iso_3166_1": "FR",
"zones": [
"Europe/Paris"
]
},
{
"iso_3166_1": "ZW",
"zones": [
"Africa/Harare"
]
}
]
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/credit/{credit_id}": {
"parameters": [
{
"name": "credit_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-credit-details",
"summary": "Get Details",
"tags": [
"Credits"
],
"description": "Get a movie or TV credit details by id.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/credit"
},
"examples": {
"application/json": {
"credit_type": "cast",
"department": "Actors",
"job": "Actor",
"media": {
"id": 1396,
"name": "English Breaking Bad",
"original_name": "Breaking Bad",
"character": "Walter White",
"episodes": [],
"seasons": [
{
"air_date": "2012-07-15",
"poster_path": "/elHbM2Ke72euRDXofdewP9GY5Y8.jpg",
"season_number": 5
}
]
},
"media_type": "tv",
"id": "52542282760ee313280017f9",
"person": {
"name": "Bryan Cranston",
"id": 17419
}
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/discover/movie": {
"get": {
"operationId": "get-discover-movie-paginated",
"summary": "Movie Discover",
"tags": [
"Discover"
],
"description": "Discover movies by different types of data like average rating, number of votes, genres and certifications. You can get a valid list of certifications from the /certifications method.\n\nDiscover also supports a nice list of sort options. See below for all of the available options.\n\nPlease note, when using `certification` \\ `certification.lte` you must also specify `certification_country`. These two parameters work together in order to filter the results. You can only filter results with the countries we have added to our [certifications list](#endpoint:faFKjuKG2HnwexAWM).\n\nIf you specify the `region` parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a `with_release_type` is specified). It's important to note the order of the release types that are used. Specifying \"2|3\" would return the limited theatrical release date as opposed to \"3|2\" which would return the theatrical date.",
"parameters": [
{
"name": "sort_by",
"in": "query",
"description": "Choose from one of the many available sort options.",
"type": "string",
"enum": [
"",
"popularity.asc",
"popularity.desc",
"release_date.asc",
"release_date.desc",
"revenue.asc",
"revenue.desc",
"primary_release_date.asc",
"primary_release_date.desc",
"original_title.asc",
"original_title.desc",
"vote_average.asc",
"vote_average.desc",
"vote_count.asc",
"vote_count.desc"
],
"default": "popularity.desc"
},
{
"name": "certification_country",
"in": "query",
"description": "Used in conjunction with the certification filter, use this to specify a country with a valid certification.",
"type": "string"
},
{
"name": "certification",
"in": "query",
"description": "Filter results with a valid certification from the 'certification_country' field.",
"type": "string"
},
{
"name": "certification.lte",
"in": "query",
"description": "Filter and only include movies that have a certification that is less than or equal to the specified value.",
"type": "string"
},
{
"name": "include_adult",
"in": "query",
"description": "A filter and include or exclude adult movies.",
"type": "boolean",
"default": false
},
{
"name": "include_video",
"in": "query",
"description": "A filter to include or exclude videos.",
"type": "boolean",
"default": false
},
{
"name": "language",
"in": "query",
"description": "Specify a language to query translatable fields with.",
"type": "string",
"default": "en-US"
},
{
"name": "page",
"in": "query",
"description": "Specify the page of results to query.",
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 1
},
{
"name": "primary_release_year",
"in": "query",
"description": "A filter to limit the results to a specific primary release year.",
"type": "integer"
},
{
"name": "primary_release_date.gte",
"in": "query",
"description": "Filter and only include movies that have a primary release date that is greater or equal to the specified value.",
"type": "string",
"format": "date"
},
{
"name": "primary_release_date.lte",
"in": "query",
"description": "Filter and only include movies that have a primary release date that is less than or equal to the specified value.",
"type": "string",
"format": "date"
},
{
"name": "release_date.gte",
"in": "query",
"description": "Filter and only include movies that have a release date (looking at all release dates) that is greater or equal to the specified value.",
"type": "string",
"format": "date"
},
{
"name": "release_date.lte",
"in": "query",
"description": "Filter and only include movies that have a release date (looking at all release dates) that is less than or equal to the specified value.",
"type": "string",
"format": "date"
},
{
"name": "vote_count.gte",
"in": "query",
"description": "Filter and only include movies that have a vote count that is greater or equal to the specified value.",
"type": "integer",
"minimum": 0
},
{
"name": "vote_count.lte",
"in": "query",
"description": "Filter and only include movies that have a vote count that is less than or equal to the specified value.",
"type": "integer",
"minimum": 1
},
{
"name": "vote_average.gte",
"in": "query",
"description": "Filter and only include movies that have a rating that is greater or equal to the specified value.",
"type": "number",
"minimum": 0
},
{
"name": "vote_average.lte",
"in": "query",
"description": "Filter and only include movies that have a rating that is less than or equal to the specified value.",
"type": "number",
"minimum": 0
},
{
"name": "with_cast",
"in": "query",
"description": "A comma separated list of person ID's. Only include movies that have one of the ID's added as an actor.",
"type": "string"
},
{
"name": "with_crew",
"in": "query",
"description": "A comma separated list of person ID's. Only include movies that have one of the ID's added as a crew member.",
"type": "string"
},
{
"name": "with_companies",
"in": "query",
"description": "A comma separated list of production company ID's. Only include movies that have one of the ID's added as a production company.",
"type": "string"
},
{
"name": "with_genres",
"in": "query",
"description": "Comma separated value of genre ids that you want to include in the results.",
"type": "string"
},
{
"name": "with_keywords",
"in": "query",
"description": "A comma separated list of keyword ID's. Only include movies that have one of the ID's added as a keyword.",
"type": "string"
},
{
"name": "with_people",
"in": "query",
"description": "A comma separated list of person ID's. Only include movies that have one of the ID's added as a either a actor or a crew member.",
"type": "string"
},
{
"name": "year",
"in": "query",
"description": "A filter to limit the results to a specific year (looking at all release dates).",
"type": "integer"
},
{
"name": "without_genres",
"in": "query",
"description": "Comma separated value of genre ids that you want to exclude from the results.",
"type": "string"
},
{
"name": "with_runtime.gte",
"in": "query",
"description": "Filter and only inlcude movies that have a runtime that is greater or equal to a value.",
"type": "integer"
},
{
"name": "with_runtime.lte",
"in": "query",
"description": "Filter and only inlcude movies that have a runtime that is less than or equal to a value.",
"type": "integer"
},
{
"name": "with_release_type",
"in": "query",
"description": "Specify a comma (AND) or pipe (OR) separated value to filter release types by. These release types map to the same values found on the movie release date method.",
"type": "integer",
"minimum": 1,
"maximum": 6
},
{
"name": "with_original_language",
"in": "query",
"description": "Specify an ISO 639-1 string to filter results by their original language value.",
"type": "string"
},
{
"name": "without_keywords",
"in": "query",
"description": "Exclude items with certain keywords. You can comma and pipe seperate these values to create an 'AND' or 'OR' logic.",
"type": "string"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": null,
"adult": false,
"overview": "Go behind the scenes during One Directions sell out \"Take Me Home\" tour and experience life on the road.",
"release_date": "2013-08-30",
"genre_ids": [
99,
10402
],
"id": 164558,
"original_title": "One Direction: This Is Us",
"original_language": "en",
"title": "One Direction: This Is Us",
"backdrop_path": null,
"popularity": 1.166982,
"vote_count": 55,
"video": false,
"vote_average": 8.45
},
{
"poster_path": null,
"adult": false,
"overview": "",
"release_date": "1954-06-22",
"genre_ids": [
80,
18
],
"id": 654,
"original_title": "On the Waterfront",
"original_language": "en",
"title": "On the Waterfront",
"backdrop_path": null,
"popularity": 1.07031,
"vote_count": 51,
"video": false,
"vote_average": 8.19
},
{
"poster_path": null,
"adult": false,
"overview": "A team of allied saboteurs are assigned an impossible mission: infiltrate an impregnable Nazi-held island and destroy the two enormous long-range field guns that prevent the rescue of 2,000 trapped British soldiers.",
"release_date": "1961-04-27",
"genre_ids": [
28,
18,
12,
10752
],
"id": 10911,
"original_title": "The Guns of Navarone",
"original_language": "en",
"title": "The Guns of Navarone",
"backdrop_path": null,
"popularity": 1.075583,
"vote_count": 50,
"video": false,
"vote_average": 7.56
}
],
"total_results": 61,
"total_pages": 4
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/discover/tv": {
"get": {
"operationId": "get-discover-tv-paginated",
"summary": "TV Discover",
"tags": [
"Discover"
],
"description": "Discover TV shows by different types of data like average rating, number of votes, genres, the network they aired on and air dates.\n\nDiscover also supports a nice list of sort options. See below for all of the available options.",
"parameters": [
{
"name": "sort_by",
"in": "query",
"description": "Choose from one of the many available sort options.",
"type": "string",
"enum": [
"",
"vote_average.desc",
"vote_average.asc",
"first_air_date.desc",
"first_air_date.asc",
"popularity.desc",
"popularity.asc"
],
"default": "popularity.desc"
},
{
"name": "air_date.gte",
"in": "query",
"description": "Filter and only include TV shows that have a air date (by looking at all episodes) that is greater or equal to the specified value.",
"type": "string",
"format": "date"
},
{
"name": "air_date.lte",
"in": "query",
"description": "Filter and only include TV shows that have a air date (by looking at all episodes) that is less than or equal to the specified value.",
"type": "string",
"format": "date"
},
{
"name": "first_air_date.gte",
"in": "query",
"description": "Filter and only include TV shows that have a original air date that is greater or equal to the specified value. Can be used in conjunction with the \"include_null_first_air_dates\" filter if you want to include items with no air date.",
"type": "string",
"format": "date"
},
{
"name": "first_air_date.lte",
"in": "query",
"description": "Filter and only include TV shows that have a original air date that is less than or equal to the specified value. Can be used in conjunction with the \"include_null_first_air_dates\" filter if you want to include items with no air date.",
"type": "string",
"format": "date"
},
{
"name": "first_air_date_year",
"in": "query",
"description": "Filter and only include TV shows that have a original air date year that equal to the specified value. Can be used in conjunction with the \"include_null_first_air_dates\" filter if you want to include items with no air date.",
"type": "integer"
},
{
"name": "language",
"in": "query",
"description": "Specify a language to query translatable fields with.",
"type": "string",
"default": "en-US"
},
{
"name": "page",
"in": "query",
"description": "Specify the page of results to query.",
"type": "integer",
"default": 1
},
{
"name": "timezone",
"in": "query",
"description": "Used in conjunction with the air_date.gte/lte filter to calculate the proper UTC offset.",
"type": "string",
"default": "America/New_York"
},
{
"name": "vote_average.gte",
"in": "query",
"description": "Filter and only include movies that have a rating that is greater or equal to the specified value.",
"type": "number",
"minimum": 0
},
{
"name": "vote_count.gte",
"in": "query",
"description": "Filter and only include movies that have a rating that is less than or equal to the specified value.",
"type": "integer",
"minimum": 0
},
{
"name": "with_genres",
"in": "query",
"description": "Comma separated value of genre ids that you want to include in the results.",
"type": "string"
},
{
"name": "with_networks",
"in": "query",
"description": "Comma separated value of network ids that you want to include in the results.",
"type": "string"
},
{
"name": "without_genres",
"in": "query",
"description": "Comma separated value of genre ids that you want to exclude from the results.",
"type": "string"
},
{
"name": "with_runtime.gte",
"in": "query",
"description": "Filter and only inlcude movies that have a runtime that is greater or equal to a value.",
"type": "integer"
},
{
"name": "with_runtime.lte",
"in": "query",
"description": "Filter and only inlcude movies that have a runtime that is less than or equal to a value.",
"type": "integer"
},
{
"name": "include_null_first_air_dates",
"in": "query",
"description": "Use this filter to include TV shows that don't have an air date while using any of the \"first_air_date\" filters.",
"type": "boolean",
"default": false
},
{
"name": "with_original_language",
"in": "query",
"description": "Specify an ISO 639-1 string to filter results by their original language value.",
"type": "string"
},
{
"name": "without_keywords",
"in": "query",
"description": "Exclude items with certain keywords. You can comma and pipe seperate these values to create an 'AND' or 'OR' logic.",
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/dDfjzRicTeVaiysRTwx56aM8bC3.jpg",
"popularity": 5.4,
"id": 61889,
"backdrop_path": null,
"vote_average": 7.74,
"overview": "Lawyer-by-day Matt Murdock uses his heightened senses from being blinded as a young boy to fight crime at night on the streets of Hell’s Kitchen as Daredevil.......",
"first_air_date": "2015-04-10",
"origin_country": [
"US"
],
"genre_ids": [
28
],
"original_language": "en",
"vote_count": 19,
"name": "Marvel's Daredevil",
"original_name": "Marvel's Daredevil"
}
],
"total_results": 61470,
"total_pages": 3074
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/find/{external_id}": {
"parameters": [
{
"name": "external_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-find-external-id",
"summary": "Find by ID",
"tags": [
"Find"
],
"description": "The find method makes it easy to search for objects in our database by an external id. For instance, an IMDB ID.\n\nThis method will search all objects (movies, TV shows and people) and return the results in a single response.\n\nThe supported external sources for each object are as follows.\n\n| | Movies | TV Shows | TV Seasons | TV Episodes | People |\n| ------------ | ------ | -------- | ---------- | ----------- | ------ |\n| IMDB ID | ✓ | ✓ | ✗ | ✓ | ✓\n| Freebase MID | ✗ | ✓ | ✓ | ✓ | ✓\n| Freebase ID | ✗ | ✓ | ✓ | ✓ | ✓\n| TVDB ID | ✗ | ✓ | ✓ | ✓ | ✗\n| TVRage ID | ✗ | ✓ | ✓ | ✓ | ✓\n",
"parameters": [
{
"name": "external_source",
"in": "query",
"required": true,
"type": "string",
"enum": [
"imdb_id",
"freebase_mid",
"freebase_id",
"tvdb_id",
"tvrage_id"
]
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/find-by-external-id-results"
},
"examples": {
"application/json": {
"movie_results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
35
],
"id": 12,
"original_language": "en",
"original_title": "Finding Nemo",
"overview": "A tale which follows the comedic and eventful journeys of two fish, the fretful Marlin and his young son Nemo, who are separated from each other in the Great Barrier Reef when Nemo is unexpectedly taken from his home and thrust into a fish tank in a dentist's office overlooking Sydney Harbor. Buoyed by the companionship of a friendly but forgetful fish named Dory, the overly cautious Marlin embarks on a dangerous trek and finds himself the unlikely hero of an epic journey to rescue his son.",
"release_date": "2003-05-30",
"poster_path": null,
"popularity": 1.256412,
"title": "Finding Nemo",
"video": false,
"vote_average": 7.2,
"vote_count": 2317
}
],
"person_results": [],
"tv_results": [],
"tv_episode_results": [],
"tv_season_results": []
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/genre/{genre_id}/movies": {
"parameters": [
{
"name": "genre_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movies-by-genre-paginated",
"summary": "Get Movies",
"tags": [
"Genres"
],
"description": "Get a list of movies by genre id.\n\nWe highly recommend using [movie discover](#endpoint:p5NyoR7dM842S8G9j) instead of this method as it is much more flexible.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:includeAdultParam:include_adult"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"id": 18,
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
10752
],
"id": 228150,
"original_language": "en",
"original_title": "Fury",
"overview": "Last months of World War II in April 1945. As the Allies make their final push in the European Theater, a battle-hardened U.S. Army sergeant in the 2nd Armored Division named Wardaddy commands a Sherman tank called \"Fury\" and its five-man crew on a deadly mission behind enemy lines. Outnumbered and outgunned, Wardaddy and his men face overwhelming odds in their heroic attempts to strike at the heart of Nazi Germany.",
"release_date": "2014-10-17",
"poster_path": "/dLU3sVjZvb3OrwARIJZppQWdNqu.jpg",
"popularity": 7.417883,
"title": "Fury",
"video": false,
"vote_average": 7.5,
"vote_count": 913
}
],
"total_pages": 2379,
"total_results": 47572
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/genre/movie/list": {
"get": {
"operationId": "get-all-movie-genres-list",
"summary": "Get Movie List",
"tags": [
"Genres"
],
"description": "Get the list of official genres for movies.",
"parameters": [
{
"name": "language",
"in": "query",
"type": "string",
"minLength": 2,
"maxLength": 2
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/genres-list"
},
"examples": {
"application/json": {
"genres": [
{
"id": 28,
"name": "Action"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/genre/tv/list": {
"get": {
"operationId": "get-all-tv-genres-list",
"summary": "Get TV List",
"tags": [
"Genres"
],
"description": "Get the list of official genres for TV shows.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/genres-list"
},
"examples": {
"application/json": {
"genres": [
{
"id": 10759,
"name": "Action & Adventure"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/guest_session/{guest_session_id}/rated/movies": {
"parameters": [
{
"name": "guest_session_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-guest-session-rated-movies-paginated",
"summary": "Get Rated Movies",
"tags": [
"Guest Sessions"
],
"description": "Get the rated movies for a guest session.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/fCayJrkfRaCRCTh8GqN30f8oyQF.jpg",
"genre_ids": [
18
],
"id": 550,
"original_language": "en",
"original_title": "Fight Club",
"overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.",
"release_date": "1999-10-12",
"poster_path": null,
"popularity": 0.5,
"title": "Fight Club",
"video": false,
"vote_average": 7.8,
"vote_count": 3439,
"rating": 4.5
}
],
"total_pages": 1,
"total_results": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/guest_session/{guest_session_id}/rated/tv": {
"parameters": [
{
"name": "guest_session_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-guest-session-rated-tv-paginated",
"summary": "Get Rated TV Shows",
"tags": [
"Guest Sessions"
],
"description": "Get the rated TV shows for a guest session.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"backdrop_path": "/aKz3lXU71wqdslC1IYRC3yHD6yw.jpg",
"first_air_date": "2011-04-17",
"genre_ids": [
10765,
18
],
"id": 1399,
"original_language": null,
"original_name": "Game of Thrones",
"overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.\n\n",
"origin_country": [
"US"
],
"poster_path": "/jIhL6mlT7AblhbHJgEoiBIOUVl1.jpg",
"popularity": 35.072708,
"name": "Game of Thrones",
"vote_average": 9.1,
"vote_count": 274,
"rating": 9.5
}
],
"total_pages": 1,
"total_results": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/guest_session/{guest_session_id}/rated/tv/episodes": {
"parameters": [
{
"name": "guest_session_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-guest-session-rated-tv-episodes-paginated",
"summary": "Get Rated TV Episodes",
"tags": [
"Guest Sessions"
],
"description": "Get the rated TV episodes for a guest session.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:accountSortByParam:sort_by"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-episodes-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"air_date": "2008-01-19",
"episode_number": 1,
"name": "Pilot",
"id": 62085,
"season_number": 1,
"still_path": "/88Z0fMP8a88EpQWMCs1593G0ngu.jpg",
"show_id": 1396,
"vote_average": 7.83333333333333,
"vote_count": 18,
"rating": 8.5
}
],
"total_pages": 1,
"total_results": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/keyword/{keyword_id}": {
"parameters": [
{
"name": "keyword_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-keyword-details",
"summary": "Get Details",
"tags": [
"Keywords"
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/keyword"
},
"examples": {
"application/json": {
"id": 3417,
"name": "wormhole"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/keyword/{keyword_id}/movies": {
"parameters": [
{
"name": "keyword_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movies-by-keyword-paginated",
"summary": "Get Movies",
"tags": [
"Keywords"
],
"description": "Get the movies that belong to a keyword.\n\nWe highly recommend using [movie discover](#endpoint:p5NyoR7dM842S8G9j) instead of this method as it is much more flexible.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:includeAdultParam:include_adult"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"id": 3417,
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
18
],
"id": 157336,
"original_language": "en",
"original_title": "Interstellar",
"overview": "Interstellar chronicles the adventures of a group of explorers who make use of a newly discovered wormhole to surpass the limitations on human space travel and conquer the vast distances involved in an interstellar voyage. Or is it?",
"release_date": "2014-11-05",
"poster_path": "/qzjOE2ylfiHjbork6rupuDJg0YX.jpg",
"popularity": 5.531964,
"title": "Interstellar",
"video": false,
"vote_average": 8.4,
"vote_count": 2085
}
],
"total_pages": 1,
"total_results": 6
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/list": {
"post": {
"operationId": "post-list",
"summary": "Create List",
"tags": [
"Lists"
],
"description": "Create a list.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:listBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"201": {
"description": "",
"schema": {
"$ref": "#/definitions/list-status-response"
},
"examples": {
"application/json": {
"status_message": "The item/record was created successfully.",
"success": true,
"status_code": 1,
"list_id": 5861
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/list/{list_id}": {
"parameters": [
{
"name": "list_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-list-details",
"summary": "Get Details",
"tags": [
"Lists"
],
"description": "Get the details of a list.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/list-details"
},
"examples": {
"application/json": {
"created_by": "travisbell",
"description": "This is pretty wicked.",
"favorite_count": 0,
"id": "50941077760ee35e1500000c",
"items": [
{
"poster_path": "/fpemzjF623QVTe98pCVlwwtFC5N.jpg",
"adult": false,
"overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.",
"release_date": "1999-10-12",
"original_title": "Fight Club",
"genre_ids": [
18
],
"id": 550,
"media_type": "movie",
"original_language": "en",
"title": "Fight Club",
"backdrop_path": null,
"popularity": 1.5,
"vote_count": 3439,
"video": false,
"vote_average": 7.8
}
],
"item_count": 46,
"iso_639_1": "en",
"name": "The Marvel Universe",
"poster_path": "/6KhhINGLbwzylPdRGqu4JxtzAJ3.jpg"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
},
"delete": {
"operationId": "delete-list",
"summary": "Delete List",
"tags": [
"Lists"
],
"description": "Delete a list.",
"parameters": [
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/list/{list_id}/item_status": {
"parameters": [
{
"name": "list_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-list-item-status",
"summary": "Check Item Status",
"tags": [
"Lists"
],
"description": "You can use this method to check if a movie has already been added to the list.",
"parameters": [
{
"name": "movie_id",
"in": "query",
"required": true,
"type": "integer",
"minimum": 1
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/item-status"
},
"examples": {
"application/json": {
"id": "50941077760ee35e1500000c",
"item_present": true
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/list/{list_id}/add_item": {
"parameters": [
{
"name": "list_id",
"in": "path",
"required": true,
"type": "string"
}
],
"post": {
"operationId": "post-list-add-item",
"summary": "Add Movie",
"tags": [
"Lists"
],
"description": "Add a movie to a list.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:mediaIdBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/list/{list_id}/remove_item": {
"parameters": [
{
"name": "list_id",
"in": "path",
"required": true,
"type": "string"
}
],
"post": {
"operationId": "post-list-remove-item",
"summary": "Remove Movie",
"tags": [
"Lists"
],
"description": "Remove a movie from a list.",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:mediaIdBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"200": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/list/{list_id}/clear": {
"parameters": [
{
"name": "list_id",
"in": "path",
"required": true,
"type": "string"
}
],
"post": {
"operationId": "post-list-clear",
"summary": "Clear List",
"tags": [
"Lists"
],
"description": "Clear all of the items from a list.",
"parameters": [
{
"name": "confirm",
"in": "query",
"required": true,
"type": "boolean"
},
{
"$ref": "#/parameters/trait:session:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-details",
"summary": "Get Details",
"tags": [
"Movies"
],
"description": "Get the primary information about a movie.\n\nSupports `append_to_response`. Read more about this [here](#docTextSection:JdZq8ctmcxNqyLQjp).",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:appendToResponseParam:append_to_response"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-details"
},
"examples": {
"application/json": {
"adult": false,
"backdrop_path": "/fCayJrkfRaCRCTh8GqN30f8oyQF.jpg",
"belongs_to_collection": null,
"budget": 63000000,
"genres": [
{
"id": 18,
"name": "Drama"
}
],
"homepage": "",
"id": 550,
"imdb_id": "tt0137523",
"original_language": "en",
"original_title": "Fight Club",
"overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.",
"popularity": 0.5,
"poster_path": null,
"production_companies": [
{
"name": "20th Century Fox",
"id": 25
}
],
"production_countries": [
{
"iso_3166_1": "US",
"name": "United States of America"
}
],
"release_date": "1999-10-12",
"revenue": 100853753,
"runtime": 139,
"spoken_languages": [
{
"iso_639_1": "en",
"name": "English"
}
],
"status": "Released",
"tagline": "How much can you know about yourself if you've never been in a fight?",
"title": "Fight Club",
"video": false,
"vote_average": 7.8,
"vote_count": 3439
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/account_states": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-movie-account-states",
"summary": "Get Account States",
"tags": [
"Movies"
],
"description": "Grab the following account states for a session:\n\n- Movie rating\n- If it belongs to your watchlist\n- If it belongs to your favourite list",
"parameters": [
{
"$ref": "#/parameters/trait:session:session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/account-states"
},
"examples": {
"application/json": {
"id": 550,
"favorite": true,
"rated": {
"value": 8
},
"watchlist": false
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/alternative_titles": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-alternative-titles-list",
"summary": "Get Alternative Titles",
"tags": [
"Movies"
],
"description": "Get all of the alternative titles for a movie.",
"parameters": [
{
"name": "country",
"in": "query",
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/alternative-titles-list"
},
"examples": {
"application/json": {
"id": 550,
"titles": [
{
"iso_3166_1": "BR",
"title": "Clube da Luta"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/changes": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-movie-changes-list",
"summary": "Get Changes",
"tags": [
"Movies"
],
"description": "Get the changes for a movie. By default only the last 24 hours are returned.\n\nYou can query up to 14 days in a single query by using the `start_date` and `end_date` query parameters.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/change-details"
},
"examples": {
"application/json": {
"changes": [
{
"key": "overview",
"items": [
{
"id": "57c464ef5dbf5b15a6000007",
"action": "updated",
"time": "2016-08-29 16:38:07 UTC",
"iso_639_1": "en",
"value": "When Tony Stark tries to jumpstart a dormant peacekeeping program, things go awry and Earth’s Mightiest Heroes are put to the ultimate test as the fate of the planet hangs in the balance. As the villainous Ultron emerges, it is up to The Avengers to stop him from enacting his terrible plans, and soon uneasy alliances and unexpected action pave the way for an epic and unique global adventure!",
"original_value": "When Tony Stark tries to jumpstart a dormant peacekeeping program, things go awry and Earth’s Mightiest Heroes are put to the ultimate test as the fate of the planet hangs in the balance. As the villainous Ultron emerges, it is up to The Avengers to stop him from enacting his terrible plans, and soon uneasy alliances and unexpected action pave the way for an epic and unique global adventure."
}
]
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/credits": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-credits",
"summary": "Get Credits",
"tags": [
"Movies"
],
"description": "Get the cast and crew for a movie.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/credits"
},
"examples": {
"application/json": {
"id": 550,
"cast": [
{
"cast_id": 4,
"character": "The Narratorr",
"credit_id": "52fe4250c3a36847f80149f3",
"id": 819,
"name": "Edward Norton",
"order": 0,
"profile_path": null
}
],
"crew": [
{
"credit_id": "52fe4250c3a36847f8014a11",
"department": "Production",
"id": 1254,
"job": "Producer",
"name": "Art Linson",
"profile_path": null
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/external_ids": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-external-ids",
"summary": "Get External IDs",
"tags": [
"Movies"
],
"description": "Get the external ids for a movie.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/external-ids"
},
"examples": {
"application/json": {
"id": 54321,
"imdb_id": "tt0082706",
"facebook_id": null,
"instagram_id": null,
"twitter_id": null
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/images": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-images",
"summary": "Get Images",
"tags": [
"Movies"
],
"description": "Get the images that belong to a movie.\n\nQuerying images with a `language` parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the `include_image_language` parameter. This should be a comma seperated value like so: `include_image_language=en,null`.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 550,
"backdrops": [
{
"aspect_ratio": 1.77777777777778,
"file_path": "/fCayJrkfRaCRCTh8GqN30f8oyQF.jpg",
"height": 720,
"iso_639_1": null,
"vote_average": 0,
"vote_count": 0,
"width": 1280
}
],
"posters": [
{
"aspect_ratio": 0.666666666666667,
"file_path": "/fpemzjF623QVTe98pCVlwwtFC5N.jpg",
"height": 1800,
"iso_639_1": "en",
"vote_average": 0,
"vote_count": 0,
"width": 1200
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/keywords": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-keywords-list",
"summary": "Get Keywords",
"tags": [
"Movies"
],
"description": "Get the keywords that have been added to a movie.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/keywords-list"
},
"examples": {
"application/json": {
"id": 550,
"keywords": [
{
"id": 825,
"name": "support group"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/lists": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-lists-paginated",
"summary": "Get Lists",
"tags": [
"Movies"
],
"description": "Get a list of lists that this movie belongs to.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/lists-paginated"
},
"examples": {
"application/json": {
"id": 550,
"page": 1,
"results": [
{
"description": "Pick one and then one or two alternates",
"favorite_count": 0,
"id": 7213,
"item_count": 1358,
"iso_639_1": "en",
"list_type": "movie",
"name": "Movie Night",
"poster_path": "/p60VSQL7usdxztIGokJPpHmKWdU.jpg"
},
{
"description": "Your favorite and classic movies of the 1990s",
"favorite_count": 0,
"id": 6968,
"item_count": 482,
"iso_639_1": "en",
"list_type": "movie",
"name": "1990",
"poster_path": "/5R68Xn4EG0g5qlaQxpE89zGrtes.jpg"
}
],
"total_pages": 18,
"total_results": 358
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/rating": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"post": {
"operationId": "post-movie-rating",
"summary": "Rate Movie",
"tags": [
"Movies"
],
"description": "Rate a movie.\n\nA valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:ratingBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
},
"delete": {
"operationId": "delete-movie-rating",
"summary": "Delete Rating",
"tags": [
"Movies"
],
"description": "Remove your rating for a movie.\n\nA valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"parameters": [
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/recommendations": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-recommendations-paginated",
"summary": "Get Recommendations",
"tags": [
"Movies"
],
"description": "Get a list of recommended movies for a movie.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
28
],
"id": 106912,
"original_language": "en",
"original_title": "Darna! Ang Pagbabalik",
"overview": "Valentina, Darna's snake-haired arch enemy, is trying to take over the Phillipines through subliminal messages on religious TV shows. Darna has her own problems, however, as she has lost her magic pearl and with it the ability to transform into her scantily clad super self. Trapped as her alter-ego, the plucky reporter Narda, she must try to regain the pearl and foil Valentina's plans.",
"release_date": "1994-05-09",
"poster_path": null,
"popularity": 1.012564,
"title": "Darna: The Return",
"video": false,
"vote_average": 0,
"vote_count": 0
}
],
"total_pages": 9,
"total_results": 168
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/release_dates": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-release-dates",
"summary": "Get Release Dates",
"tags": [
"Movies"
],
"description": "Get the release date along with the certification for a movie.\n\nRelease dates support different types:\n\n1. Premiere\n2. Theatrical (limited)\n3. Theatrical\n4. Digital\n5. Physical\n6. TV",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/release-dates-list"
},
"examples": {
"application/json": {
"id": 550,
"results": [
{
"iso_3166_1": "BG",
"release_dates": [
{
"certification": "c",
"iso_639_1": "",
"note": "",
"release_date": "2012-08-28T00:00:00.000Z",
"type": 3
}
]
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/reviews": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-reviews-paginated",
"summary": "Get Reviews",
"tags": [
"Movies"
],
"description": "Get the user reviews for a movie.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/reviews-paginated"
},
"examples": {
"application/json": {
"id": 297761,
"page": 1,
"results": [
{
"id": "57a814dc9251415cfb00309a",
"author": "Frank Ochieng",
"content": "Summertime 2016 has not been very kind to DC Comics-based personalities looking to shine consistently like their big screen Marvel Comics counterparts. Following the super-sized dud that was _Batman v. Superman: Dawn of Justice_ released a few months ago must really put some major pressure on Warner Bros. to gamble on ensuring that the presence of **Suicide Squad** does not meet the same kind of indifferent reception. Well, it turns out that although the anticipation was high for writer-director David Ayer's supervillain saga involving high-powered imprisoned rogues recruited as U.S. governmental operatives out to stop other skillful baddies (as it was for Zack Ryder's aforementioned \"Dawn of Justice\") the concoction of **Suicide Squad** feels like a colorful mishmash of collective misfits laboriously taking up space in a disjointed eye candy-coated spectacle that never manages to match its intended sizzle.\r\n\r\nOne would think that the premise for **Suicide Squad** would tap into the intriguing naughtiness with more robust gumption given the collection of super-powered oddballs asked to be immediate anti-heroes in this toothless jamboree of renegade rejects. Strangely, the grim and brooding presentation of **Suicide Squad** is more of an erratic downer than a hyperactive high-wire act as intended at the creative hands of Ayer. There is no reason why this lively group of adventurous agitators should appear so flat and inconsequential in a boisterous blockbuster that sporadically limps.\r\n\r\nGiven the twisted members that comprise this elite team of terrorizing tools it is very disappointing to see how **Suicide Squad** struggles with its so-called subversive themes. Sadly, this splattered mess never firmly grasps its bid for distinctive irreverence or off-balance exploitation. Instead, **Squad** feels strained in its execution and we are never really invested in entirely watching these treasured troublemakers find redemption because the story is soggy and uninspired. Furthermore, not all of the **Squad** participants are fleshed out satisfyingly for us to get behind with thirsty cynicism. The headlining leads in Will Smith's Floyd Lawton/Deadshot, Oscar-winner Jared Leto's green-haired Joker and Australian beauty Margot Robbie's Harleen Quinzel/Harley Quinn get the meaty standout parts while the lesser known supporting cast get stuck with chewing on the thankless remaining bone while seemingly acting as background furniture to the bigger names.\r\n\r\nNaturally, desperation has set in for the U.S. government as they need to safeguard national security against advanced sinister forces that threaten the fiber of American self-interests everywhere. What better way to hire gifted protection than to consider employing the world's most incarcerated corruptible, cutthroat cretins to perform the dirty work in unforgivable mission ops that require death-defying determination. Enter U.S. Intelligence agent Amanda Waller (Oscar nominee Viola Davis). Waller's duties are to assemble the ragtag team known as the Suicide Squad--ominous (yet talented) jailbirds tapped to step in and assume superhero status (especially when the real superheroes are tied up in other crime-stopping affairs) while helping out for the greater good of our vulnerable society. In exchange for the Suicide Squad's sacrifice in turning from hell-bent heels to reluctant heralded heroes they are promised commuted prison sentences should they effectively defend and destroy the deadly foes out to promote heavy-handed havoc across the board.\r\n\r\nConveniently, bureaucratic bigwig Waller (through voiceover) introduces the Suicide Squad and describes what beneficial assets they bring to the turbulent table. Among the naughty notables include the well-known ace sniper Floyd Lawton/Deadshot as well as legendary lethal joy-boy Joker and his better (or perhaps worst half) in girlfriend Harley Quinn. The other toxic tag-a-longs along for the thrill ride of becoming rebellious rescuers include George Harkness/Boomerang (Jai Courtney), Chato Santana/El Diablo (Jay Hernandez), Waylon Jones/Killer Croc (Adewale Akinnuoye-Agbaje), Tatsu Yamashiro/Katana, Enchantress (Cara Delevingne) and Rick Flag (Joel Kinnaman).\r\n\r\nOverall, **Suicide Squad** is surprisingly depressing and goes through the proverbial motions without so much as taking advantage of its surrealistic makeup. The movie never realizes its excitable potential and drifts into yet another superhero yarn that is more patchy than pronounced. Smith's Deadshot is out in the forefront but for the most part feels restrained and not as spry and savvy as one would imagine. Leto's Joker obviously pales in comparison to the brilliant and mesmerizing psychotic take on the role that earned the late Heath Ledger his posthumous Oscar statuette. In all fairness, nobody could inhabit the Clown Prince of Crime as Ledger uncannily did with committed concentration. Still, Leto's Joker--although viciously off-balance--felt recycled and furiously empty at times. Robbie's turn as Joker's misguided main squeeze merely comes off as a bratty Barbie Doll with synthetic edginess. The other **Squad** participants settle for the back burner more or less which is a crying shame because they should have been more engaged than the tepid material allowed them to be initially.\r\n\r\nWoefully sketchy and missing the fueled opulence that one would expect emerging from this cockeyed costume caper **Suicide Squad** is a detonating dud for the missing explosive DC Comics movie brand that needs to step up the pace if they expect to make a consistent and challenging impression on the devoted fanboys at the box office looking to move beyond the sardonic fantasy-based realm of another redundant serving of a _Batman/Superman_ entry.\r\n\r\n**Suicide Squad** (2016)\r\n\r\nWarner Bros.\r\n\r\n2 hrs. 3 mins.\r\n\r\nStarring: Will Smith, Jared Leto, Margo Robbie, Viola Davis, Joel Kinnaman, Jay Hernandez, Jai Courtney, Scott Eastwood, Adewale Akinnuoye-Agbaje, Ike Barinholtz, Common, Cara Delevinge, Karen Fukuhara, Adam Beach\r\n\r\nDirected and Written by: David Ayer\r\n\r\nMPPA Rating: PG-13\r\n\r\nGenre: Superheroes Saga/Action & Adventure/Comic Book Fantasy\r\n\r\nCritic's rating: ** stars (out of 4 stars)\r\n\r\n(c) **Frank Ochieng** (2016)",
"url": "https://www.themoviedb.org/review/57a814dc9251415cfb00309a"
}
],
"total_pages": 1,
"total_results": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/similar": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-similar-paginated",
"summary": "Get Similar Movies",
"tags": [
"Movies"
],
"description": "Get a list of similar movies. This is **not** the same as the \"Recommendation\" system you see on the website.\n\nThese items are assembled by looking at keywords and genres.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": null,
"genre_ids": [
28
],
"id": 106912,
"original_language": "en",
"original_title": "Darna! Ang Pagbabalik",
"overview": "Valentina, Darna's snake-haired arch enemy, is trying to take over the Phillipines through subliminal messages on religious TV shows. Darna has her own problems, however, as she has lost her magic pearl and with it the ability to transform into her scantily clad super self. Trapped as her alter-ego, the plucky reporter Narda, she must try to regain the pearl and foil Valentina's plans.",
"release_date": "1994-05-09",
"poster_path": null,
"popularity": 1.012564,
"title": "Darna: The Return",
"video": false,
"vote_average": 0,
"vote_count": 0
}
],
"total_pages": 9,
"total_results": 168
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/translations": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-movie-translations-list",
"summary": "Get Translations",
"tags": [
"Movies"
],
"description": "Get a list of translations that have been created for a movie.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/translations-list"
},
"examples": {
"application/json": {
"id": 54321,
"translations": [
{
"iso_3166_1": "US",
"iso_639_1": "en",
"name": "English",
"english_name": "English",
"data": {
"title": "Blind Fist of Bruce",
"overview": "The incomparable martial arts expert, Bruce Li, stars as a wealthy hero who defends his village from the assaults of ill-wishers.",
"homepage": ""
}
},
{
"iso_3166_1": "DE",
"iso_639_1": "de",
"name": "Deutsch",
"english_name": "German",
"data": {
"title": "Wir sind die größten Knochenbrecher",
"overview": "",
"homepage": ""
}
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/{movie_id}/videos": {
"parameters": [
{
"name": "movie_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-movie-videos-list",
"summary": "Get Videos",
"tags": [
"Movies"
],
"description": "Get the videos that have been added to a movie.",
"parameters": [
{
"name": "api_key",
"in": "query",
"type": "string"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/videos-list"
},
"examples": {
"application/json": {
"id": 550,
"results": [
{
"id": "533ec654c3a36854480003eb",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "SUXWAEX2jlg",
"name": "Trailer 1",
"site": "YouTube",
"size": 720,
"type": "Trailer"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/changes": {
"get": {
"operationId": "get-movie-changes-paginated",
"summary": "Get Movie Change List",
"tags": [
"Changes"
],
"description": "Get a list of all of the movie ids that have been changed in the past 24 hours.\n\nYou can query it for up to 14 days worth of changed IDs at a time with the `start_date` and `end_date` query parameters. 100 items are returned per page.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/changes-paginated"
},
"examples": {
"application/json": {
"results": [
{
"id": 412683,
"adult": false
},
{
"id": 412685,
"adult": false
},
{
"id": 75258,
"adult": false
}
],
"page": 1,
"total_pages": 10,
"total_results": 952
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/latest": {
"get": {
"operationId": "get-movie-latest-details",
"summary": "Get Latest",
"tags": [
"Movies"
],
"description": "Get the most newly created movie. This is a live response and will continuously change.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-details"
},
"examples": {
"application/json": {
"adult": false,
"backdrop_path": null,
"belongs_to_collection": null,
"budget": 0,
"genres": [
{
"id": 99,
"name": "Documentary"
}
],
"homepage": "",
"id": 413323,
"imdb_id": "tt5852644",
"original_language": "en",
"original_title": "Deadpool: From Comics to Screen... to Screen",
"overview": "This documentary divided into five segments examines the source and its path to the movies, backstory, special effects story/character areas, cast and performances. It includes notes from Reynolds, Liefeld, Miller, Wernick, Reese, executive producers Aditya Sood and Stan Lee, co-creator/comics writer Fabian Nicieza, producer Simon Kinberg, comics writer Joe Kelly, specialty costume designer Russell Shinkle, makeup designer Bill Corso, production designer Sean Haworth, director of photography Ken Seng, executive producer/unit production manager John J. Kelly, previs supervisor Franck Balson, stunt coordinator Philip J. Silvera, visual effects supervisors Pauline Duvall and Jonathan Rothbart, visual effects producer Annemarie Griggs, 2nd unit director/stunt coordinator Robert Alonzo, special effects coordinator Alex Burdett, utility stunts Regis Harrington, composer Tom Holkenberg, and actors Morena Baccarin, TJ Miller, Brianna Hildebrand, Leslie Uggams, Ed Skrein, and Gina Carano.",
"popularity": 0,
"poster_path": "/chV0avy5ogIB2PMTInT4KpHDzwj.jpg",
"production_companies": [],
"production_countries": [],
"release_date": "2016-05-10",
"revenue": 0,
"runtime": 80,
"spoken_languages": [],
"status": "Released",
"tagline": "",
"title": "Deadpool: From Comics to Screen... to Screen",
"video": false,
"vote_average": 0,
"vote_count": 0
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/now_playing": {
"get": {
"operationId": "get-movie-now-playing-paginated",
"summary": "Get Now Playing",
"tags": [
"Movies"
],
"description": "Get a list of movies in theatres. This is a release type query that looks for all movies that have a release type of 2 or 3 within the specified date range.\n\nYou can optionally specify a `region` prameter which will narrow the search to only look for theatrical release dates within the specified country.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/e1mjopzAS2KNsvpbpahQ1a6SkSn.jpg",
"adult": false,
"overview": "From DC Comics comes the Suicide Squad, an antihero team of incarcerated supervillains who act as deniable assets for the United States government, undertaking high-risk black ops missions in exchange for commuted prison sentences.",
"release_date": "2016-08-03",
"genre_ids": [
14,
28,
80
],
"id": 297761,
"original_title": "Suicide Squad",
"original_language": "en",
"title": "Suicide Squad",
"backdrop_path": "/ndlQ2Cuc3cjTL7lTynw6I4boP4S.jpg",
"popularity": 48.261451,
"vote_count": 1466,
"video": false,
"vote_average": 5.91
},
{
"poster_path": "/lFSSLTlFozwpaGlO31OoUeirBgQ.jpg",
"adult": false,
"overview": "The most dangerous former operative of the CIA is drawn out of hiding to uncover hidden truths about his past.",
"release_date": "2016-07-27",
"genre_ids": [
28,
53
],
"id": 324668,
"original_title": "Jason Bourne",
"original_language": "en",
"title": "Jason Bourne",
"backdrop_path": "/AoT2YrJUJlg5vKE3iMOLvHlTd3m.jpg",
"popularity": 30.690177,
"vote_count": 649,
"video": false,
"vote_average": 5.25
}
],
"dates": {
"maximum": "2016-09-01",
"minimum": "2016-07-21"
},
"total_pages": 33,
"total_results": 649
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/popular": {
"get": {
"operationId": "get-movie-popular-paginated",
"summary": "Get Popular",
"tags": [
"Movies"
],
"description": "Get a list of the current popular movies on TMDb. This list updates daily.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/e1mjopzAS2KNsvpbpahQ1a6SkSn.jpg",
"adult": false,
"overview": "From DC Comics comes the Suicide Squad, an antihero team of incarcerated supervillains who act as deniable assets for the United States government, undertaking high-risk black ops missions in exchange for commuted prison sentences.",
"release_date": "2016-08-03",
"genre_ids": [
14,
28,
80
],
"id": 297761,
"original_title": "Suicide Squad",
"original_language": "en",
"title": "Suicide Squad",
"backdrop_path": "/ndlQ2Cuc3cjTL7lTynw6I4boP4S.jpg",
"popularity": 48.261451,
"vote_count": 1466,
"video": false,
"vote_average": 5.91
},
{
"poster_path": "/lFSSLTlFozwpaGlO31OoUeirBgQ.jpg",
"adult": false,
"overview": "The most dangerous former operative of the CIA is drawn out of hiding to uncover hidden truths about his past.",
"release_date": "2016-07-27",
"genre_ids": [
28,
53
],
"id": 324668,
"original_title": "Jason Bourne",
"original_language": "en",
"title": "Jason Bourne",
"backdrop_path": "/AoT2YrJUJlg5vKE3iMOLvHlTd3m.jpg",
"popularity": 30.690177,
"vote_count": 649,
"video": false,
"vote_average": 5.25
}
],
"total_results": 19629,
"total_pages": 982
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/top_rated": {
"get": {
"operationId": "get-movie-top-rated-paginated",
"summary": "Get Top Rated",
"tags": [
"Movies"
],
"description": "Get the top rated movies on TMDb.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/9O7gLzmreU0nGkIB6K3BsJbzvNv.jpg",
"adult": false,
"overview": "Framed in the 1940s for the double murder of his wife and her lover, upstanding banker Andy Dufresne begins a new life at the Shawshank prison, where he puts his accounting skills to work for an amoral warden. During his long stretch in prison, Dufresne comes to be admired by the other inmates -- including an older prisoner named Red -- for his integrity and unquenchable sense of hope.",
"release_date": "1994-09-10",
"genre_ids": [
18,
80
],
"id": 278,
"original_title": "The Shawshank Redemption",
"original_language": "en",
"title": "The Shawshank Redemption",
"backdrop_path": "/xBKGJQsAIeweesB79KC89FpBrVr.jpg",
"popularity": 6.741296,
"vote_count": 5238,
"video": false,
"vote_average": 8.32
},
{
"poster_path": "/lIv1QinFqz4dlp5U4lQ6HaiskOZ.jpg",
"adult": false,
"overview": "Under the direction of a ruthless instructor, a talented young drummer begins to pursue perfection at any cost, even his humanity.",
"release_date": "2014-10-10",
"genre_ids": [
18,
10402
],
"id": 244786,
"original_title": "Whiplash",
"original_language": "en",
"title": "Whiplash",
"backdrop_path": "/6bbZ6XyvgfjhQwbplnUh1LSj1ky.jpg",
"popularity": 10.776056,
"vote_count": 2059,
"video": false,
"vote_average": 8.29
}
],
"total_results": 5206,
"total_pages": 261
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/movie/upcoming": {
"get": {
"operationId": "get-movie-upcoming-paginated",
"summary": "Get Upcoming",
"tags": [
"Movies"
],
"description": "Get a list of upcoming movies in theatres. This is a release type query that looks for all movies that have a release type of 2 or 3 within the specified date range.\n\nYou can optionally specify a `region` prameter which will narrow the search to only look for theatrical release dates within the specified country.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/pEFRzXtLmxYNjGd0XqJDHPDFKB2.jpg",
"adult": false,
"overview": "A lighthouse keeper and his wife living off the coast of Western Australia raise a baby they rescue from an adrift rowboat.",
"release_date": "2016-09-02",
"genre_ids": [
18
],
"id": 283552,
"original_title": "The Light Between Oceans",
"original_language": "en",
"title": "The Light Between Oceans",
"backdrop_path": "/2Ah63TIvVmZM3hzUwR5hXFg2LEk.jpg",
"popularity": 4.546151,
"vote_count": 11,
"video": false,
"vote_average": 4.41
},
{
"poster_path": "/udU6t5xPNDLlRTxhjXqgWFFYlvO.jpg",
"adult": false,
"overview": "Friends hatch a plot to retrieve a stolen cat by posing as drug dealers for a street gang.",
"release_date": "2016-09-14",
"genre_ids": [
28,
35
],
"id": 342521,
"original_title": "Keanu",
"original_language": "en",
"title": "Keanu",
"backdrop_path": "/scM6zcBTXvUByKxQnyM11qWJbtX.jpg",
"popularity": 3.51555,
"vote_count": 97,
"video": false,
"vote_average": 6.04
}
],
"dates": {
"maximum": "2016-09-22",
"minimum": "2016-09-01"
},
"total_pages": 12,
"total_results": 222
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/network/{network_id}": {
"parameters": [
{
"name": "network_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-network-details",
"summary": "Get Details",
"tags": [
"Networks"
],
"description": "Get the details of a network.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/network"
},
"examples": {
"application/json": {
"id": 49,
"name": "HBO"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/network/{network_id}/alternative_names": {
"parameters": [
{
"name": "network_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-network-alternative-names-list",
"summary": "Get Alternative Names",
"tags": [
"Networks"
],
"description": "Get the alternative names of a network.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/alternative-names-list"
},
"examples": {
"application/json": {
"id": 1,
"results": [
{
"name": "Fuji Television",
"type": ""
},
{
"name": "Fuji Terebijon",
"type": "rōmaji"
},
{
"name": "フジテレビ",
"type": ""
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/network/{network_id}/images": {
"parameters": [
{
"name": "network_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-network-images",
"summary": "Get Images",
"tags": [
"Networks"
],
"description": "Get the TV network logos by id.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 1,
"logos": [
{
"aspect_ratio": 1.024096385542169,
"file_path": "/yS5UJjsSdZXML0YikWTYYHLPKhQ.png",
"height": 249,
"id": "5a7ee3cbc3a36818ac0097b1",
"file_type": ".svg",
"vote_average": 0,
"vote_count": 0,
"width": 255
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-details",
"summary": "Get Details",
"tags": [
"People"
],
"description": "Get the primary person details by id.\n\nSupports `append_to_response`. Read more about this [here](#docTextSection:JdZq8ctmcxNqyLQjp).\n\n#### New as of November 9, 2016\n\nBiographies are now translatable on TMDb. This means you can query person details with a language parameter.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:appendToResponseParam:append_to_response"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-details"
},
"examples": {
"application/json": {
"adult": false,
"also_known_as": [],
"biography": "William Bradley \"Brad\" Pitt (born December 18, 1963) is an American actor and film producer. Pitt has received two Academy Award nominations and four Golden Globe Award nominations, winning one. He has been described as one of the world's most attractive men, a label for which he has received substantial media attention. Pitt began his acting career with television guest appearances, including a role on the CBS prime-time soap opera Dallas in 1987. He later gained recognition as the cowboy hitchhiker who seduces Geena Davis's character in the 1991 road movie Thelma & Louise. Pitt's first leading roles in big-budget productions came with A River Runs Through It (1992) and Interview with the Vampire (1994). He was cast opposite Anthony Hopkins in the 1994 drama Legends of the Fall, which earned him his first Golden Globe nomination. In 1995 he gave critically acclaimed performances in the crime thriller Seven and the science fiction film 12 Monkeys, the latter securing him a Golden Globe Award for Best Supporting Actor and an Academy Award nomination.\n\nFour years later, in 1999, Pitt starred in the cult hit Fight Club. He then starred in the major international hit as Rusty Ryan in Ocean's Eleven (2001) and its sequels, Ocean's Twelve (2004) and Ocean's Thirteen (2007). His greatest commercial successes have been Troy (2004) and Mr. & Mrs. Smith (2005).\n\nPitt received his second Academy Award nomination for his title role performance in the 2008 film The Curious Case of Benjamin Button. Following a high-profile relationship with actress Gwyneth Paltrow, Pitt was married to actress Jennifer Aniston for five years. Pitt lives with actress Angelina Jolie in a relationship that has generated wide publicity. He and Jolie have six children—Maddox, Pax, Zahara, Shiloh, Knox, and Vivienne.\n\nSince beginning his relationship with Jolie, he has become increasingly involved in social issues both in the United States and internationally. Pitt owns a production company named Plan B Entertainment, whose productions include the 2007 Academy Award winning Best Picture, The Departed.\n\nDescription above from the Wikipedia article Brad Pitt, licensed under CC-BY-SA, full list of contributors on Wikipedia.",
"birthday": "1963-12-18",
"deathday": "",
"gender": 0,
"homepage": "",
"id": 287,
"imdb_id": "nm0000093",
"name": "Brad Pitt",
"place_of_birth": "Shawnee - Oklahoma - USA",
"popularity": 1.35777,
"profile_path": "/lZngQUfDpPwlBRebtFo8XFuk9T3.jpg"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/changes": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-changes",
"summary": "Get Changes",
"tags": [
"People"
],
"description": "Get the changes for a person. By default only the last 24 hours are returned.\n\nYou can query up to 14 days in a single query by using the `start_date` and `end_date` query parameters.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/change-details"
},
"examples": {
"application/json": {
"changes": [
{
"key": "images",
"items": [
{
"id": "5696d98292514154c9000291",
"action": "deleted",
"time": "2016-01-13 23:10:58 UTC",
"original_value": {
"profile": {
"file_path": "/wywUfSkVggWhUnXE4qucoIe1EcA.jpg"
}
}
}
]
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/combined_credits": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-combined-credits",
"summary": "Get Combined Credits",
"tags": [
"People"
],
"description": "Get the movie and TV credits together in a single response.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-credits"
},
"examples": {
"application/json": {
"cast": [
{
"adult": false,
"character": "Himself",
"credit_id": "52fe4e93c3a36847f8299dff",
"id": 239459,
"original_title": "No Half Measures: Creating the Final Season of Breaking Bad",
"poster_path": "/8OixSR45U5dbqv8F0tlspmTbXxN.jpg",
"release_date": "2013-11-26",
"title": "No Half Measures: Creating the Final Season of Breaking Bad",
"media_type": "movie"
},
{
"character": "Devon",
"credit_id": "5328ddb6c3a3683d430006a7",
"episode_count": 1,
"first_air_date": "2009-09-17",
"id": 18347,
"name": "Community",
"original_name": "Community",
"poster_path": "/kMceNzAgVtl6MwU5C7Iv9azPbih.jpg",
"media_type": "tv"
},
{
"character": "Himself",
"credit_id": "56c9f199c3a36840870083e9",
"episode_count": 1,
"first_air_date": "2016-02-15",
"id": 65664,
"name": "Talking Saul",
"original_name": "Talking Saul",
"poster_path": "/goAGIZla7EwdH1R4eSX6UXGUov0.jpg",
"media_type": "tv"
}
],
"crew": [
{
"adult": false,
"credit_id": "52fe44cbc3a36847f80aa581",
"department": "Writing",
"id": 8960,
"job": "Screenplay",
"original_title": "Hancock",
"poster_path": "/dsCxSr4w3g2ylhlZg3v5CB5Pid7.jpg",
"release_date": "2008-07-01",
"title": "Hancock",
"media_type": "movie"
},
{
"adult": false,
"credit_id": "52fe44d59251416c75042907",
"department": "Writing",
"id": 12257,
"job": "Screenplay",
"original_title": "Home Fries",
"poster_path": "/canLYYy0QvAFQLSwvIB75zcuLVk.jpg",
"release_date": "1998-11-25",
"title": "Home Fries",
"media_type": "movie"
},
{
"adult": false,
"credit_id": "52fe48e7c3a36847f817fc27",
"department": "Writing",
"id": 55950,
"job": "Writer",
"original_title": "Wilder Napalm",
"poster_path": "/pdfEU6WqcR4l4zrNMpv2hwvKwxJ.jpg",
"release_date": "1993-08-20",
"title": "Wilder Napalm",
"media_type": "movie"
}
],
"id": 66633
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/external_ids": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-external-ids",
"summary": "Get External IDs",
"tags": [
"People"
],
"description": "Get the external ids for a person. We currently support the following external sources.\n\n| **External Sources** |\n| ------------ |\n| IMDB ID |\n| Facebook |\n| Freebase MID |\n| Freebase ID |\n| Instagram |\n| TVRage ID |\n| Twitter |",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/external-ids"
},
"examples": {
"application/json": {
"imdb_id": "nm0319213",
"facebook_id": null,
"freebase_mid": "/m/03y9ccy",
"freebase_id": null,
"tvrage_id": 67721,
"twitter_id": null,
"id": 66633
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/images": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-images-list",
"summary": "Get Images",
"tags": [
"People"
],
"description": "Get the images for a person.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 66633,
"profiles": [
{
"aspect_ratio": 0.666666666666667,
"file_path": "/rLSUjr725ez1cK7SKVxC9udO03Y.jpg",
"height": 819,
"iso_639_1": null,
"vote_average": 5.3125,
"vote_count": 1,
"width": 546
},
{
"aspect_ratio": 0.666666666666667,
"file_path": "/lYqC8Amj4owX05xQg5Yo7uUHgah.jpg",
"height": 3000,
"iso_639_1": null,
"vote_average": 0,
"vote_count": 0,
"width": 2000
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/movie_credits": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-movie-credits",
"summary": "Get Movie Credits",
"tags": [
"People"
],
"description": "Get the movie credits for a person.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-credits"
},
"examples": {
"application/json": {
"cast": [
{
"adult": false,
"character": "Himself",
"credit_id": "52fe4e93c3a36847f8299dff",
"id": 239459,
"original_title": "No Half Measures: Creating the Final Season of Breaking Bad",
"poster_path": "/8OixSR45U5dbqv8F0tlspmTbXxN.jpg",
"release_date": "2013-11-26",
"title": "No Half Measures: Creating the Final Season of Breaking Bad"
}
],
"crew": [
{
"adult": false,
"credit_id": "52fe44cbc3a36847f80aa581",
"department": "Writing",
"id": 8960,
"job": "Screenplay",
"original_title": "Hancock",
"poster_path": "/dsCxSr4w3g2ylhlZg3v5CB5Pid7.jpg",
"release_date": "2008-07-01",
"title": "Hancock"
},
{
"adult": false,
"credit_id": "52fe44d59251416c75042907",
"department": "Writing",
"id": 12257,
"job": "Screenplay",
"original_title": "Home Fries",
"poster_path": "/canLYYy0QvAFQLSwvIB75zcuLVk.jpg",
"release_date": "1998-11-25",
"title": "Home Fries"
},
{
"adult": false,
"credit_id": "52fe48e7c3a36847f817fc27",
"department": "Writing",
"id": 55950,
"job": "Writer",
"original_title": "Wilder Napalm",
"poster_path": "/pdfEU6WqcR4l4zrNMpv2hwvKwxJ.jpg",
"release_date": "1993-08-20",
"title": "Wilder Napalm"
}
],
"id": 66633
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/tagged_images": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-tagged-images-paginated",
"summary": "Get Tagged Images",
"tags": [
"People"
],
"description": "Get the images that this person has been tagged in.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-tagged-images-paginated"
},
"examples": {
"application/json": {
"id": 287,
"page": 1,
"results": [
{
"aspect_ratio": 0.666666666666667,
"file_path": "/811DjJTon9gD6hZ8nCjSitaIXFQ.jpg",
"height": 1800,
"id": "5520e4a59251415c82002fb9",
"iso_639_1": "en",
"vote_average": 5.82903040734366,
"vote_count": 20,
"width": 1200,
"image_type": "poster",
"media": {
"adult": false,
"backdrop_path": "/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg",
"genre_ids": [
18
],
"_id": "4bc88fc1017a3c122d009254",
"id": 550,
"original_language": "en",
"original_title": "Fight Club",
"overview": "A ticking-time-bomb insomniac and a slippery soap salesman channel primal male aggression into a shocking new form of therapy. Their concept catches on, with underground \"fight clubs\" forming in every town, until an eccentric gets in the way and ignites an out-of-control spiral toward oblivion.",
"release_date": "1999-10-14",
"poster_path": "/811DjJTon9gD6hZ8nCjSitaIXFQ.jpg",
"popularity": 6.590102,
"title": "Fight Club",
"video": false,
"vote_average": 8.1,
"vote_count": 5221
},
"media_type": "movie"
},
{
"aspect_ratio": 0.666666666666667,
"file_path": "/p11Ftd4VposrAzthkhF53ifYZRl.jpg",
"height": 2100,
"id": "564536209251410a49006e41",
"iso_639_1": "en",
"vote_average": 5.8250276854928,
"vote_count": 23,
"width": 1400,
"image_type": "poster",
"media": {
"adult": false,
"backdrop_path": "/jmlMLYEsYY1kRc5qHIyTdxCeVmZ.jpg",
"genre_ids": [
18,
35
],
"_id": "54b9978fc3a3686c6b005e71",
"id": 318846,
"original_language": "en",
"original_title": "The Big Short",
"overview": "The men who made millions from a global economic meltdown.",
"release_date": "2015-12-11",
"poster_path": "/p11Ftd4VposrAzthkhF53ifYZRl.jpg",
"popularity": 5.46459,
"title": "The Big Short",
"video": false,
"vote_average": 7.2,
"vote_count": 1182
},
"media_type": "movie"
}
],
"total_pages": 5,
"total_results": 94
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/translations": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-translations-list",
"summary": "Get Translations",
"tags": [
"People"
],
"description": "Get a list of translations that have been created for a person.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/translations-list"
},
"examples": {
"application/json": {
"translations": [
{
"iso_639_1": "en",
"iso_3166_1": "US",
"name": "English",
"data": {
"biography": "An American actress. She began her television career with several guest appearances on television shows such as Saved By The Bell: The New Class, Days of our Lives, and California Dreams. She is known for her recurring role as Danni Sullivan on NBC comedy drama series Scrubs. Her screen debut came in A Return to Salem's Lot (1987), followed by the hit films The Big Lebowski (1998), Urban Legend (1998), and American Pie (1999). She has since portrayed supporting as well as lead roles in several films, including Dr. T & the Women (2000), Josie and the Pussycats (2001), National Lampoon's Van Wilder (2002), My Boss's Daughter (2003), and Alone in the Dark (2005).\n\nDescription above from the Wikipedia article Tara Reid, licensed under CC-BY-SA, full list of contributors on Wikipedia."
},
"english_name": "en"
},
{
"iso_639_1": "de",
"iso_3166_1": "DE",
"name": "Deutsch",
"data": {
"biography": ""
},
"english_name": "de"
}
],
"id": 1234
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/{person_id}/tv_credits": {
"parameters": [
{
"name": "person_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-person-tv-credits",
"summary": "Get TV Credits",
"tags": [
"People"
],
"description": "Get the TV show credits for a person.\n\nYou can query for some extra details about the credit with the [credit method](#endpoint:xPWdEBLkvCNZSicLN).",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-credits"
},
"examples": {
"application/json": {
"cast": [
{
"character": "Devon",
"credit_id": "5328ddb6c3a3683d430006a7",
"episode_count": 1,
"first_air_date": "2009-09-17",
"id": 18347,
"name": "Community",
"original_name": "Community",
"poster_path": "/kMceNzAgVtl6MwU5C7Iv9azPbih.jpg"
},
{
"character": "Himself",
"credit_id": "56c9f199c3a36840870083e9",
"episode_count": 1,
"first_air_date": "2016-02-15",
"id": 65664,
"name": "Talking Saul",
"original_name": "Talking Saul",
"poster_path": "/goAGIZla7EwdH1R4eSX6UXGUov0.jpg"
},
{
"character": "Self",
"credit_id": "56cb156392514108620001bf",
"episode_count": 1,
"first_air_date": "2003-01-23",
"id": 1428,
"name": "MythBusters",
"original_name": "MythBusters",
"poster_path": "/vTRwO0OsAQfwwWQtls9z8W4DU7j.jpg"
}
],
"crew": [
{
"credit_id": "52542287760ee31328001af1",
"department": "Production",
"episode_count": 68,
"first_air_date": "2008-01-19",
"id": 1396,
"job": "Executive Producer",
"name": "Breaking Bad",
"original_name": "Breaking Bad",
"poster_path": "/1yeVJox3rjo2jBKrrihIMj7uoS9.jpg"
},
{
"credit_id": "52542275760ee313280006ce",
"department": "Writing",
"episode_count": 81,
"first_air_date": "2008-01-19",
"id": 1396,
"job": "Writer",
"name": "Breaking Bad",
"original_name": "Breaking Bad",
"poster_path": "/1yeVJox3rjo2jBKrrihIMj7uoS9.jpg"
},
{
"credit_id": "52542275760ee313280006e8",
"department": "Directing",
"episode_count": 26,
"first_air_date": "2008-01-19",
"id": 1396,
"job": "Director",
"name": "Breaking Bad",
"original_name": "Breaking Bad",
"poster_path": "/1yeVJox3rjo2jBKrrihIMj7uoS9.jpg"
}
],
"id": 66633
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/changes": {
"get": {
"operationId": "get-person-changes-paginated",
"summary": "Get Person Change List",
"tags": [
"Changes"
],
"description": "Get a list of all of the person ids that have been changed in the past 24 hours.\n\nYou can query it for up to 14 days worth of changed IDs at a time with the `start_date` and `end_date` query parameters. 100 items are returned per page.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/changes-paginated"
},
"examples": {
"application/json": {
"results": [
{
"id": 1670120,
"adult": false
},
{
"id": 1670121,
"adult": false
},
{
"id": 1670122,
"adult": false
}
],
"page": 1,
"total_pages": 7,
"total_results": 620
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/latest": {
"get": {
"operationId": "get-person-latest-details",
"summary": "Get Latest",
"tags": [
"People"
],
"description": "Get the most newly created person. This is a live response and will continuously change.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-details"
},
"examples": {
"application/json": {
"adult": false,
"also_known_as": [],
"biography": null,
"birthday": null,
"deathday": null,
"gender": 0,
"homepage": null,
"id": 1671971,
"imdb_id": null,
"name": "Midnight Syndicate",
"place_of_birth": null,
"popularity": 0,
"profile_path": null
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/person/popular": {
"get": {
"operationId": "get-person-popular-paginated",
"summary": "Get Popular",
"tags": [
"People"
],
"description": "Get the list of popular people on TMDb. This list updates daily.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"profile_path": "/z3sLuRKP7hQVrvSTsqdLjGSldwG.jpg",
"adult": false,
"id": 28782,
"known_for": [
{
"poster_path": "/hE24GYddaxB9MVZl1CaiI86M3kp.jpg",
"adult": false,
"overview": "A cryptic message from Bond’s past sends him on a trail to uncover a sinister organization. While M battles political forces to keep the secret service alive, Bond peels back the layers of deceit to reveal the terrible truth behind SPECTRE.",
"release_date": "2015-10-26",
"original_title": "Spectre",
"genre_ids": [
28,
12,
80
],
"id": 206647,
"media_type": "movie",
"original_language": "en",
"title": "Spectre",
"backdrop_path": "/wVTYlkKPKrljJfugXN7UlLNjtuJ.jpg",
"popularity": 7.090211,
"vote_count": 2956,
"video": false,
"vote_average": 6.2
},
{
"poster_path": "/ezIurBz2fdUc68d98Fp9dRf5ihv.jpg",
"adult": false,
"overview": "Six months after the events depicted in The Matrix, Neo has proved to be a good omen for the free humans, as more and more humans are being freed from the matrix and brought to Zion, the one and only stronghold of the Resistance. Neo himself has discovered his superpowers including super speed, ability to see the codes of the things inside the matrix and a certain degree of pre-cognition. But a nasty piece of news hits the human resistance: 250,000 machine sentinels are digging to Zion and would reach them in 72 hours. As Zion prepares for the ultimate war, Neo, Morpheus and Trinity are advised by the Oracle to find the Keymaker who would help them reach the Source. Meanwhile Neo's recurrent dreams depicting Trinity's death have got him worried and as if it was not enough, Agent Smith has somehow escaped deletion, has become more powerful than before and has fixed Neo as his next target.",
"release_date": "2003-05-15",
"original_title": "The Matrix Reloaded",
"genre_ids": [
12,
28,
53,
878
],
"id": 604,
"media_type": "movie",
"original_language": "en",
"title": "The Matrix Reloaded",
"backdrop_path": "/1jgulSytTJcATkGX8syGbD2glXD.jpg",
"popularity": 3.41123,
"vote_count": 2187,
"video": false,
"vote_average": 6.57
}
],
"name": "Monica Bellucci",
"popularity": 48.609344
},
{
"profile_path": "/tDPS8QHdOmdmu400haPcYum8BHC.jpg",
"adult": false,
"id": 21911,
"known_for": [
{
"poster_path": "/vD5plFV1ec9CSIsdlPe9icCDRTL.jpg",
"adult": false,
"overview": "Former Special Forces officer Frank Martin will deliver anything to anyone for the right price, and his no-questions-asked policy puts him in high demand. But when he realizes his latest cargo is alive, it sets in motion a dangerous chain of events. The bound and gagged Lai is being smuggled to France by a shady American businessman, and Frank works to save her as his own illegal activities are uncovered by a French detective.",
"release_date": "2002-10-02",
"original_title": "The Transporter",
"genre_ids": [
28,
80,
53
],
"id": 4108,
"media_type": "movie",
"original_language": "en",
"title": "The Transporter",
"backdrop_path": "/poKaphSqmgC1vtUYGagzyU4KP2m.jpg",
"popularity": 2.99031,
"vote_count": 988,
"video": false,
"vote_average": 6.52
},
{
"poster_path": "/tCUEJ6Svr9eqcUOpxlRbFKlEVqm.jpg",
"adult": false,
"overview": "Asian Hawk (Jackie Chan) leads a mercenary team to recover several lost artifacts from the Old Summer Palace, the bronze heads of the 12 Chinese Zodiac animals which were sacked by the French and British armies from the imperial Summer Palace in Beijing in 1860. Assisted by a Chinese student and a Parisian lady, Hawk stops at nothing to accomplish the mission.",
"release_date": "2012-12-20",
"original_title": "Chinese Zodiac",
"genre_ids": [
28,
12
],
"id": 98567,
"media_type": "movie",
"original_language": "cn",
"title": "Chinese Zodiac",
"backdrop_path": "/b8i4Zg7gzMgRmjP9oRxtx8HoiS6.jpg",
"popularity": 2.325203,
"vote_count": 181,
"video": false,
"vote_average": 6.15
}
],
"name": "Shu Qi",
"popularity": 35.790232
}
],
"total_results": 19671,
"total_pages": 984
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/review/{review_id}": {
"parameters": [
{
"name": "review_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-review-details",
"summary": "Get Details",
"tags": [
"Reviews"
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/review"
},
"examples": {
"application/json": {
"id": "5488c29bc3a3686f4a00004a",
"author": "Travis Bell",
"content": "Like most of the reviews here, I agree that Guardians of the Galaxy was an absolute hoot. Guardians never takes itself too seriously which makes this movie a whole lot of fun.\r\n\r\nThe cast was perfectly chosen and even though two of the main five were CG, knowing who voiced and acted alongside them completely filled out these characters.\r\n\r\nGuardians of the Galaxy is one of those rare complete audience pleasers. Good fun for everyone!",
"iso_639_1": "en",
"media_id": 118340,
"media_title": "Guardians of the Galaxy",
"media_type": "Movie",
"url": "https://www.themoviedb.org/review/5488c29bc3a3686f4a00004a"
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/collection": {
"get": {
"operationId": "get-search-collection-paginated",
"summary": "Search Collections",
"tags": [
"Search"
],
"description": "Search for collections.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/collection-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"id": 9485,
"backdrop_path": "/z5A5W3WYJc3UVEWljSGwdjDgQ0j.jpg",
"name": "The Fast and the Furious Collection",
"poster_path": "/uv63yAGg1zETAs1XQsOQpava87l.jpg"
}
],
"total_pages": 1,
"total_results": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/company": {
"get": {
"operationId": "get-search-company-paginated",
"summary": "Search Companies",
"tags": [
"Search"
],
"description": "Search for companies.",
"parameters": [
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/company-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"id": 1,
"logo_path": "/8rUnVMVZjlmQsJ45UGotD0Uznxj.png",
"name": "Lucasfilm"
},
{
"id": 535,
"logo_path": null,
"name": "Lucasfilm Ltd."
},
{
"id": 71126,
"logo_path": null,
"name": "Lucasfilm Kids"
},
{
"id": 7778,
"logo_path": null,
"name": "Lucasfilms"
}
],
"total_pages": 1,
"total_results": 4
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/keyword": {
"get": {
"operationId": "get-search-keyword-paginated",
"summary": "Search Keywords",
"tags": [
"Search"
],
"description": "Search for keywords.",
"parameters": [
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/keyword-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"id": 9951,
"name": "alien"
},
{
"id": 4939,
"name": "alien phenomenons"
},
{
"id": 10158,
"name": "alien planet"
}
],
"total_pages": 2,
"total_results": 39
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/movie": {
"get": {
"operationId": "get-search-movie-paginated",
"summary": "Search Movies",
"tags": [
"Search"
],
"description": "Search for movies.",
"parameters": [
{
"name": "year",
"in": "query",
"type": "integer"
},
{
"name": "primary_release_year",
"in": "query",
"type": "integer"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:includeAdultParam:include_adult"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/movie-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/cezWGskPY5x7GaglTTRN4Fugfb8.jpg",
"adult": false,
"overview": "When an unexpected enemy emerges and threatens global safety and security, Nick Fury, director of the international peacekeeping agency known as S.H.I.E.L.D., finds himself in need of a team to pull the world back from the brink of disaster. Spanning the globe, a daring recruitment effort begins!",
"release_date": "2012-04-25",
"genre_ids": [
878,
28,
12
],
"id": 24428,
"original_title": "The Avengers",
"original_language": "en",
"title": "The Avengers",
"backdrop_path": "/hbn46fQaRmlpBuUrEiFqv0GDL6Y.jpg",
"popularity": 7.353212,
"vote_count": 8503,
"video": false,
"vote_average": 7.33
},
{
"poster_path": "/7cJGRajXMU2aYdTbElIl6FtzOl2.jpg",
"adult": false,
"overview": "British Ministry agent John Steed, under direction from \"Mother\", investigates a diabolical plot by arch-villain Sir August de Wynter to rule the world with his weather control machine. Steed investigates the beautiful Doctor Mrs. Emma Peel, the only suspect, but simultaneously falls for her and joins forces with her to combat Sir August.",
"release_date": "1998-08-13",
"genre_ids": [
53
],
"id": 9320,
"original_title": "The Avengers",
"original_language": "en",
"title": "The Avengers",
"backdrop_path": "/8YW4rwWQgC2JRlBcpStMNUko13k.jpg",
"popularity": 2.270454,
"vote_count": 111,
"video": false,
"vote_average": 4.7
}
],
"total_results": 14,
"total_pages": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/multi": {
"get": {
"operationId": "get-search-multi-paginated",
"summary": "Multi Search",
"tags": [
"Search"
],
"description": "Search multiple models in a single request. Multi search currently supports searching for movies, tv shows and people in a single request.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:includeAdultParam:include_adult"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/search-multi-results-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": null,
"popularity": 1,
"id": 24511,
"overview": "",
"backdrop_path": null,
"vote_average": 0,
"media_type": "tv",
"first_air_date": "",
"origin_country": [
"GB"
],
"genre_ids": [],
"original_language": "en",
"vote_count": 0,
"name": "Bradley",
"original_name": "Bradley"
},
{
"poster_path": "/dl4ftVOH532YmV1I9jOLYwexv2F.jpg",
"popularity": 1,
"id": 19532,
"overview": "The Mrs Bradley Mysteries is a 1998-99 British drama series starring Diana Rigg as Adela Bradley, and Neil Dudgeon as her chauffeur George Moody. The series was produced by the BBC for its BBC One channel, based on the character created by detective writer Gladys Mitchell. Five episodes were produced, including a pilot special. Graham Dalby provided the theme music You're the Cream in My Coffee and he appeared with his orchestra in two episodes. Stylish images of the 1920s are featured, including a classic Rolls Royce limousine and art deco fashions and jewellery worn by the title character.\n\nThe series was shown in the United States by PBS broadcaster WGBH as part of its Mystery! anthology strand, and introduced by Diana Rigg. The full series was also aired in Australia in 2011 by the Seven Network's station 7Two.",
"backdrop_path": "/lHebXNadF0WDJWTxO4Zud3xM8he.jpg",
"vote_average": 0,
"media_type": "tv",
"first_air_date": "",
"origin_country": [],
"genre_ids": [
18
],
"original_language": "en",
"vote_count": 0,
"name": "The Mrs Bradley Mysteries",
"original_name": "The Mrs Bradley Mysteries"
},
{
"profile_path": "/2daC5DeXqwkFND0xxutbnSVKN6c.jpg",
"adult": false,
"id": 51329,
"media_type": "person",
"known_for": [
{
"poster_path": "/y31QB9kn3XSudA15tV7UWQ9XLuW.jpg",
"adult": false,
"overview": "Light years from Earth, 26 years after being abducted, Peter Quill finds himself the prime target of a manhunt after discovering an orb wanted by Ronan the Accuser.",
"release_date": "2014-07-30",
"original_title": "Guardians of the Galaxy",
"genre_ids": [
28,
878,
12
],
"id": 118340,
"media_type": "movie",
"original_language": "en",
"title": "Guardians of the Galaxy",
"backdrop_path": "/bHarw8xrmQeqf3t8HpuMY7zoK4x.jpg",
"popularity": 9.267731,
"vote_count": 5002,
"video": false,
"vote_average": 7.97
},
{
"poster_path": "/eshEkiG7NmU4ekA8CtpIdYiYufZ.jpg",
"adult": false,
"overview": "When three friends finally come to after a raucous night of bachelor-party revelry, they find a baby in the closet and a tiger in the bathroom. But they can't seem to locate their best friend, Doug -- who's supposed to be tying the knot. Launching a frantic search for Doug, the trio perseveres through a nasty hangover to try to make it to the church on time.",
"release_date": "2009-06-05",
"original_title": "The Hangover",
"genre_ids": [
35
],
"id": 18785,
"media_type": "movie",
"original_language": "en",
"title": "The Hangover",
"backdrop_path": "/39LohvXfll5dGCQIV9B9VJ16ImE.jpg",
"popularity": 3.69347,
"vote_count": 3761,
"video": false,
"vote_average": 7.08
}
],
"name": "Bradley Cooper",
"popularity": 6.431053
},
{
"poster_path": "/3impN03bMWR6io6NlXM1Wci0Lr3.jpg",
"adult": false,
"overview": "Manny Pacquiao takes the ring, perhaps for the very last time, against Timothy Bradley on Sunday.",
"release_date": "2016-04-09",
"original_title": "Pacquiao VS Bradley 3",
"genre_ids": [],
"id": 392316,
"media_type": "movie",
"original_language": "en",
"title": "Pacquiao VS Bradley 3",
"backdrop_path": "/A1AR3gsHve1YqfqYM0r2EhPxRUj.jpg",
"popularity": 1.017608,
"vote_count": 0,
"video": false,
"vote_average": 0
},
{
"profile_path": "/4XAtJsz67pmpIsCQ9SBKfqayk2d.jpg",
"adult": false,
"id": 154689,
"media_type": "person",
"known_for": [
{
"poster_path": "/xn3QM6aInhQp631K2lXpGFox2Kc.jpg",
"popularity": 6.605526,
"id": 60866,
"overview": "A medical student who becomes a zombie joins a Coroner's Office in order to gain access to the brains she must reluctantly eat so that she can maintain her humanity. But every brain she eats, she also inherits their memories and must now solve their deaths with help from the Medical examiner and a police detective.",
"backdrop_path": "/d2YDPTQPe3mI2LqBWwb0CchN54f.jpg",
"vote_average": 6.01,
"media_type": "tv",
"first_air_date": "2015-03-17",
"origin_country": [
"US"
],
"genre_ids": [
27,
18,
80,
10765
],
"original_language": "en",
"vote_count": 69,
"name": "iZombie",
"original_name": "iZombie"
},
{
"poster_path": "/uK7Y7ajLx9bmM34COQzQ35HqlSr.jpg",
"popularity": 7.267267,
"id": 7225,
"overview": "Merlin is a British fantasy-adventure television programme by Julian Jones, Jake Michie, Julian Murphy and Johnny Capps. It was broadcast on BBC One from 20 September 2008 to 24 December 2012. The show is loosely based on the Arthurian legends of the young wizard Merlin and his relationship with Arthur Pendragon but differs from traditional versions in many ways. The show was influenced by the US drama series Smallville, about the early years of Superman, and was produced by independent production company Shine Limited.\n\nThe show was greenlit by the BBC in 2006, after unsuccessful attempts. The series premiered in 2008 to mixed reviews but decent ratings, and proved popular on the BBC's digital catch-up service, iPlayer. It was commissioned by the BBC for a second series, and was picked up in the United States by one of the main broadcasters, NBC, though it later moved to the cable network Syfy due to low ratings. In 2012, the show's producers announced that its fifth series would be its last, with a two-part finale finishing the show on 24 December 2012.",
"backdrop_path": "/c1nR2MRShXYqY04I6V3qwebvkB7.jpg",
"vote_average": 6.45,
"media_type": "tv",
"first_air_date": "2008-09-20",
"origin_country": [
"GB"
],
"genre_ids": [
10759,
18,
10751,
10765
],
"original_language": "en",
"vote_count": 20,
"name": "Merlin",
"original_name": "Merlin"
}
],
"name": "Bradley James",
"popularity": 2.67723
}
],
"total_results": 382,
"total_pages": 20
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/person": {
"get": {
"operationId": "get-search-person-paginated",
"summary": "Search People",
"tags": [
"Search"
],
"description": "Search for people.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
},
{
"$ref": "#/parameters/trait:includeAdultParam:include_adult"
},
{
"$ref": "#/parameters/trait:regionParam:region"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/person-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"profile_path": "/2daC5DeXqwkFND0xxutbnSVKN6c.jpg",
"adult": false,
"id": 51329,
"known_for": [
{
"poster_path": "/y31QB9kn3XSudA15tV7UWQ9XLuW.jpg",
"adult": false,
"overview": "Light years from Earth, 26 years after being abducted, Peter Quill finds himself the prime target of a manhunt after discovering an orb wanted by Ronan the Accuser.",
"release_date": "2014-07-30",
"original_title": "Guardians of the Galaxy",
"genre_ids": [
28,
878,
12
],
"id": 118340,
"media_type": "movie",
"original_language": "en",
"title": "Guardians of the Galaxy",
"backdrop_path": "/bHarw8xrmQeqf3t8HpuMY7zoK4x.jpg",
"popularity": 9.267731,
"vote_count": 5002,
"video": false,
"vote_average": 7.97
},
{
"poster_path": "/eshEkiG7NmU4ekA8CtpIdYiYufZ.jpg",
"adult": false,
"overview": "When three friends finally come to after a raucous night of bachelor-party revelry, they find a baby in the closet and a tiger in the bathroom. But they can't seem to locate their best friend, Doug -- who's supposed to be tying the knot. Launching a frantic search for Doug, the trio perseveres through a nasty hangover to try to make it to the church on time.",
"release_date": "2009-06-05",
"original_title": "The Hangover",
"genre_ids": [
35
],
"id": 18785,
"media_type": "movie",
"original_language": "en",
"title": "The Hangover",
"backdrop_path": "/39LohvXfll5dGCQIV9B9VJ16ImE.jpg",
"popularity": 3.69347,
"vote_count": 3761,
"video": false,
"vote_average": 7.08
}
],
"name": "Bradley Cooper",
"popularity": 6.431053
},
{
"profile_path": "/4XAtJsz67pmpIsCQ9SBKfqayk2d.jpg",
"adult": false,
"id": 154689,
"known_for": [
{
"poster_path": "/xn3QM6aInhQp631K2lXpGFox2Kc.jpg",
"popularity": 6.605526,
"id": 60866,
"overview": "A medical student who becomes a zombie joins a Coroner's Office in order to gain access to the brains she must reluctantly eat so that she can maintain her humanity. But every brain she eats, she also inherits their memories and must now solve their deaths with help from the Medical examiner and a police detective.",
"backdrop_path": "/d2YDPTQPe3mI2LqBWwb0CchN54f.jpg",
"vote_average": 6.01,
"media_type": "tv",
"first_air_date": "2015-03-17",
"origin_country": [
"US"
],
"genre_ids": [
27,
18,
80,
10765
],
"original_language": "en",
"vote_count": 69,
"name": "iZombie",
"original_name": "iZombie"
},
{
"poster_path": "/uK7Y7ajLx9bmM34COQzQ35HqlSr.jpg",
"popularity": 7.267267,
"id": 7225,
"overview": "Merlin is a British fantasy-adventure television programme by Julian Jones, Jake Michie, Julian Murphy and Johnny Capps. It was broadcast on BBC One from 20 September 2008 to 24 December 2012. The show is loosely based on the Arthurian legends of the young wizard Merlin and his relationship with Arthur Pendragon but differs from traditional versions in many ways. The show was influenced by the US drama series Smallville, about the early years of Superman, and was produced by independent production company Shine Limited.\n\nThe show was greenlit by the BBC in 2006, after unsuccessful attempts. The series premiered in 2008 to mixed reviews but decent ratings, and proved popular on the BBC's digital catch-up service, iPlayer. It was commissioned by the BBC for a second series, and was picked up in the United States by one of the main broadcasters, NBC, though it later moved to the cable network Syfy due to low ratings. In 2012, the show's producers announced that its fifth series would be its last, with a two-part finale finishing the show on 24 December 2012.",
"backdrop_path": "/c1nR2MRShXYqY04I6V3qwebvkB7.jpg",
"vote_average": 6.45,
"media_type": "tv",
"first_air_date": "2008-09-20",
"origin_country": [
"GB"
],
"genre_ids": [
10759,
18,
10751,
10765
],
"original_language": "en",
"vote_count": 20,
"name": "Merlin",
"original_name": "Merlin"
}
],
"name": "Bradley James",
"popularity": 2.67723
}
],
"total_results": 363,
"total_pages": 19
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/search/tv": {
"get": {
"operationId": "get-search-tv-paginated",
"summary": "Search TV Shows",
"tags": [
"Search"
],
"description": "Search for a TV show.",
"parameters": [
{
"name": "first_air_date_year",
"in": "query",
"type": "integer"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:queryParam:query"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/jIhL6mlT7AblhbHJgEoiBIOUVl1.jpg",
"popularity": 29.780826,
"id": 1399,
"backdrop_path": "/mUkuc2wyV9dHLG0D0Loaw5pO2s8.jpg",
"vote_average": 7.91,
"overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
"first_air_date": "2011-04-17",
"origin_country": [
"US"
],
"genre_ids": [
10765,
10759,
18
],
"original_language": "en",
"vote_count": 1172,
"name": "Game of Thrones",
"original_name": "Game of Thrones"
}
],
"total_results": 1,
"total_pages": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/trending/{media_type}/{time_window}": {
"parameters": [
{
"name": "media_type",
"in": "path",
"required": true,
"type": "string",
"enum": [
"all",
"movie",
"tv",
"person"
]
},
{
"name": "time_window",
"in": "path",
"required": true,
"type": "string",
"enum": [
"day",
"week"
]
}
],
"get": {
"operationId": "get-trending-paginated",
"summary": "Get Trending",
"tags": [
"Trending"
],
"description": "Get the daily or weekly trending items. The daily trending list tracks items over the period of a day while items have a 24 hour half life. The weekly list tracks items over a 7 day period, with a 7 day half life.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/search-multi-results-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/cezWGskPY5x7GaglTTRN4Fugfb8.jpg",
"adult": false,
"overview": "When an unexpected enemy emerges and threatens global safety and security, Nick Fury, director of the international peacekeeping agency known as S.H.I.E.L.D., finds himself in need of a team to pull the world back from the brink of disaster. Spanning the globe, a daring recruitment effort begins!",
"release_date": "2012-04-25",
"genre_ids": [
878,
28,
12
],
"id": 24428,
"original_title": "The Avengers",
"original_language": "en",
"title": "The Avengers",
"backdrop_path": "/hbn46fQaRmlpBuUrEiFqv0GDL6Y.jpg",
"popularity": 7.353212,
"vote_count": 8503,
"video": false,
"vote_average": 7.33
},
{
"poster_path": "/7cJGRajXMU2aYdTbElIl6FtzOl2.jpg",
"adult": false,
"overview": "British Ministry agent John Steed, under direction from \"Mother\", investigates a diabolical plot by arch-villain Sir August de Wynter to rule the world with his weather control machine. Steed investigates the beautiful Doctor Mrs. Emma Peel, the only suspect, but simultaneously falls for her and joins forces with her to combat Sir August.",
"release_date": "1998-08-13",
"genre_ids": [
53
],
"id": 9320,
"original_title": "The Avengers",
"original_language": "en",
"title": "The Avengers",
"backdrop_path": "/8YW4rwWQgC2JRlBcpStMNUko13k.jpg",
"popularity": 2.270454,
"vote_count": 111,
"video": false,
"vote_average": 4.7
}
],
"total_results": 14,
"total_pages": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-details",
"summary": "Get Details",
"tags": [
"TV"
],
"description": "Get the primary TV show details by id.\n\nSupports `append_to_response`. Read more about this [here](#docTextSection:JdZq8ctmcxNqyLQjp).",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:appendToResponseParam:append_to_response"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-details"
},
"examples": {
"application/json": {
"backdrop_path": "/mUkuc2wyV9dHLG0D0Loaw5pO2s8.jpg",
"created_by": [
{
"id": 9813,
"name": "David Benioff",
"profile_path": "/8CuuNIKMzMUL1NKOPv9AqEwM7og.jpg"
},
{
"id": 228068,
"name": "D. B. Weiss",
"profile_path": "/caUAtilEe06OwOjoQY3B7BgpARi.jpg"
}
],
"episode_run_time": [
60
],
"first_air_date": "2011-04-17",
"genres": [
{
"id": 10765,
"name": "Sci-Fi & Fantasy"
},
{
"id": 10759,
"name": "Action & Adventure"
},
{
"id": 18,
"name": "Drama"
}
],
"homepage": "http://www.hbo.com/game-of-thrones",
"id": 1399,
"in_production": true,
"languages": [
"es",
"en",
"de"
],
"last_air_date": "2016-06-26",
"name": "Game of Thrones",
"networks": [
{
"id": 49,
"name": "HBO"
}
],
"number_of_episodes": 51,
"number_of_seasons": 6,
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "Game of Thrones",
"overview": "Seven noble families fight for control of the mythical land of Westeros. Friction between the houses leads to full-scale war. All while a very ancient evil awakens in the farthest north. Amidst the war, a neglected military order of misfits, the Night's Watch, is all that stands between the realms of men and icy horrors beyond.",
"popularity": 28.780826,
"poster_path": "/jIhL6mlT7AblhbHJgEoiBIOUVl1.jpg",
"production_companies": [
{
"name": "Home Box Office (HBO)",
"id": 3268
},
{
"name": "Generator Entertainment",
"id": 5820
},
{
"name": "Television 360",
"id": 12525
},
{
"name": "Bighead Littlehead",
"id": 12526
},
{
"name": "Revolution Sun Studios",
"id": 76043
}
],
"seasons": [
{
"air_date": "2010-12-05",
"episode_count": 13,
"id": 3627,
"poster_path": "/kMTcwNRfFKCZ0O2OaBZS0nZ2AIe.jpg",
"season_number": 0
},
{
"air_date": "2011-04-17",
"episode_count": 10,
"id": 3624,
"poster_path": "/olJ6ivXxCMq3cfujo1IRw30OrsQ.jpg",
"season_number": 1
},
{
"air_date": "2012-04-01",
"episode_count": 10,
"id": 3625,
"poster_path": "/3U8IVLqitMHMuEAgkuz8qReguHd.jpg",
"season_number": 2
},
{
"air_date": "2013-03-31",
"episode_count": 10,
"id": 3626,
"poster_path": "/eVWAat0GqF6s5LLThrI7ClpKr96.jpg",
"season_number": 3
},
{
"air_date": "2014-04-06",
"episode_count": 10,
"id": 3628,
"poster_path": "/dniQ7zw3mbLJkd1U0gdFEh4b24O.jpg",
"season_number": 4
},
{
"air_date": "2015-04-12",
"episode_count": 10,
"id": 62090,
"poster_path": "/yKOltUHsp9X7dXWIm0hNGcIQa4G.jpg",
"season_number": 5
},
{
"air_date": "2016-04-24",
"episode_count": 10,
"id": 71881,
"poster_path": "/zvYrzLMfPIenxoq2jFY4eExbRv8.jpg",
"season_number": 6
}
],
"status": "Returning Series",
"type": "Scripted",
"vote_average": 7.9,
"vote_count": 1174
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/account_states": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-account-states",
"summary": "Get Account States",
"tags": [
"TV"
],
"description": "Grab the following account states for a session:\n\n- TV show rating\n- If it belongs to your watchlist\n- If it belongs to your favourite list",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/account-states"
},
"examples": {
"application/json": {
"id": 1399,
"favorite": true,
"rated": {
"value": 9
},
"watchlist": false
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/alternative_titles": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-alternative-titles-list",
"summary": "Get Alternative Titles",
"tags": [
"TV"
],
"description": "Returns all of the alternative titles for a TV show.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/alternative-titles-list"
},
"examples": {
"application/json": {
"id": 1399,
"results": [
{
"title": "Game of Thrones - Das Lied von Eis und Feuer",
"iso_3166_1": "DE"
},
{
"title": "Le Trône de fer",
"iso_3166_1": "FR"
},
{
"title": "Παιχνίδι Του Στέμματος",
"iso_3166_1": "GR"
},
{
"title": "صراع العروش",
"iso_3166_1": "SA"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/changes": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-changes",
"summary": "Get Changes",
"tags": [
"TV"
],
"description": "Get the changes for a TV show. By default only the last 24 hours are returned.\n\nYou can query up to 14 days in a single query by using the `start_date` and `end_date` query parameters.\n\nTV show changes are different than movie changes in that there are some edits on seasons and episodes that will create a change entry at the show level. These can be found under the season and episode keys. These keys will contain a `series_id` and `episode_id`. You can use the [season changes](#endpoint:ZqhtyQbJ4YXz8RSya) and [episode changes](#endpoint:FpqrhBzgf2RJv4bHC) methods to look these up individually.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/change-details"
},
"examples": {
"application/json": {
"changes": [
{
"key": "season",
"items": [
{
"id": "5725bbf49251411e9f002658",
"action": "updated",
"time": "2016-05-01 08:19:00 UTC",
"value": {
"season_id": 71881,
"season_number": 6
}
},
{
"id": "572623e892514177440033da",
"action": "updated",
"time": "2016-05-01 15:42:32 UTC",
"value": {
"season_id": 3626,
"season_number": 3
}
},
{
"id": "57273ad99251410387001935",
"action": "updated",
"time": "2016-05-02 11:32:41 UTC",
"value": {
"season_id": 3625,
"season_number": 2
}
}
]
},
{
"key": "overview",
"items": [
{
"id": "5727611ac3a3682dee000640",
"action": "updated",
"time": "2016-05-02 14:15:54 UTC",
"iso_639_1": "el",
"value": "Από τις κόκκινες αμμουδιές του Νότου και τις άγριες πεδιάδες της Ανατολής έως τον παγωμένο Βορρά και το αρχαίο Τείχος, που προστατεύει το Στέμμα από σκοτεινά όντα, οι ισχυρές οικογένειες των Επτά Βασιλείων επιδίδονται σε μια ανελέητη μάχη στη διαδοχή του Σιδερένιου Θρόνου. Μια ιστορία γεμάτη ίντριγκες και προδοσίες, ιπποτισμό και τιμή, κατακτήσεις και θριάμβους. Στο Παιχνίδι του Στέμματος, θα νικήσεις ή θα πεθάνεις.",
"original_value": "Από τις κόκκινες αμμουδιές του Νότου και τις άγριες πεδιάδες της Ανατολής έως τον παγωμένο Βορρά και το αρχαίο Τοίχος, που προστατεύει το Στέμμα από σκοτεινά όντα, οι ισχυρές οικογένειες των Επτά Βασιλείων επιδίδονται σε μια ανελέητη μάχη στη διαδοχή του Σιδερένιου Θρόνου. Μια ιστορία γεμάτη ίντριγκες και προδοσίες, ιπποτισμό και τιμή, κατακτήσεις και θριάμβους. Στο Παιχνίδι του Στέμματος, θα νικήσεις ή θα πεθάνεις."
},
{
"id": "5731f00ec3a36803b9000253",
"action": "updated",
"time": "2016-05-10 14:28:30 UTC",
"iso_639_1": "uk",
"value": "Серіал \"Гра Престолів\" знято за сюжетом фентезі-бестселерів \"Пісня льоду і полум'я\" Джорджа Р.Р. Мартіна (володаря премій Г'юґо та Неб'юла). З моменту свого створення \"Гра Престолів\" став одним з найдорожчих фентезі-серіалів в історії телебачення. Це одна з причин, з якої телекритики вважають серіал головним претендентом на лаври \"Володара перстенів\" (як першовідкривача жанру) на телебаченні.\n\nПодії серіалу розгортаються у фентезійному світі, мешканцями якого - амбіційні чоловіки та жінки, котрим притаманні як гідність, так і розпуста. Найцінніша річ у цьому Королівстві – Залізний Трон. Той, хто ним володіє, отримує неймовірну владу і визнання.\n\nЗа панування у Королівстві бореться одразу декілька відомих родин. Серед них: благородні Старки, змовники Ланністери, принцеса драконів Дейнеріс і її жорстокий брат Візеріс.\n\n\"Гра престолів\" – це історія про двовладдя і зраду, гідність і безчестя, завоювання й тріумф. І кожного учасника цієї гри очікує або перемога, або смерть.",
"original_value": "Серіал \"Гра Престолів\" знято за сюжетом фентезі-бестселерів \"Пісня льоду і полум'я\" Джрорджа Р.Р. Мартіна (володаря премій Г'юґо та Неб'юла). З моменту свого створення \"Гра Престолів\" став одним з найдорожчих фентезі-серіалів в історії телебачення. Це одна з причин, з якої телекритики вважають серіал головним претендентом на лаври \"Володара перстенів\" (як першовідкривача жанру) на телебаченні.\n\nПодії серіалу розгортаються у фентезійному світі, мешканцями якого - амбіційні чоловіки та жінки, котрим притаманні як гідність, так і розпуста. Найцінніша річ у цьому Королівстві – Залізний Трон. Той, хто ним володіє, отримує неймовірну владу і визнання.\n\nЗа панування у Королівстві бореться одразу декілька відомих родин. Серед них: благородні Старки, змовники Ланністери, принцеса драконів Дейнеріс і її жорстокий брат Візеріс.\n\n\"Гра престолів\" – це історія про двовладдя і зраду, гідність і безчестя, завоювання й тріумф. І кожного учасника цієї гри очікує або перемога, або смерть. "
}
]
},
{
"key": "production_companies",
"items": [
{
"id": "57277eafc3a3681da20000df",
"action": "added",
"time": "2016-05-02 16:22:07 UTC",
"value": {
"id": 76043,
"name": "Revolution Sun Studios"
}
},
{
"id": "57277eafc3a3681da20000e0",
"action": "added",
"time": "2016-05-02 16:22:07 UTC",
"value": {
"id": 12525,
"name": "Television 360"
}
}
]
},
{
"key": "season_regular",
"items": [
{
"id": "57279627c3a3681da20004ae",
"action": "added",
"time": "2016-05-02 18:02:15 UTC",
"value": {
"add_to_every_season": false,
"character": "Myrcella Baratheon",
"credit_id": "556b61d2c3a36826f800209b",
"order": 132,
"person_id": 1472584,
"season_id": 71881
}
},
{
"id": "572796309251415f10000c27",
"action": "deleted",
"time": "2016-05-02 18:02:24 UTC",
"original_value": {
"credit_id": "556b61d2c3a36826f800209b",
"person_id": 1472584,
"season_id": 71881
}
}
]
},
{
"key": "images",
"items": [
{
"id": "57301731c3a36874eb002c3c",
"action": "added",
"time": "2016-05-09 04:50:57 UTC",
"value": {
"poster": {
"file_path": "/ciCbuYerIGdcxM8cOLcJ4qR1MLM.jpg"
}
}
},
{
"id": "57301757c3a3685b5c0041cc",
"action": "updated",
"time": "2016-05-09 04:51:35 UTC",
"iso_639_1": "en",
"value": {
"poster": {
"file_path": "/ciCbuYerIGdcxM8cOLcJ4qR1MLM.jpg",
"iso_639_1": "en"
}
},
"original_value": {
"poster": {
"file_path": "/ciCbuYerIGdcxM8cOLcJ4qR1MLM.jpg",
"iso_639_1": null
}
}
}
]
},
{
"key": "crew",
"items": [
{
"id": "5731f8bc92514153ba000016",
"action": "deleted",
"time": "2016-05-10 15:05:32 UTC",
"original_value": {
"credit_id": "5256c8c819c2956ff6048800",
"department": "Production",
"job": "Producer",
"person_id": 176489,
"season_id": 3627
}
},
{
"id": "5731f8c592514153ba000017",
"action": "deleted",
"time": "2016-05-10 15:05:41 UTC",
"original_value": {
"credit_id": "5256c8c819c2956ff6048800",
"department": "Production",
"job": "Producer",
"person_id": 176489,
"season_id": 3624
}
}
]
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/content_ratings": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-content-ratings-list",
"summary": "Get Content Ratings",
"tags": [
"TV"
],
"description": "Get the list of content ratings (certifications) that have been added to a TV show.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/ratings-list"
},
"examples": {
"application/json": {
"results": [
{
"iso_3166_1": "DE",
"rating": "16"
},
{
"iso_3166_1": "GB",
"rating": "18"
},
{
"iso_3166_1": "AU",
"rating": "R18+"
},
{
"iso_3166_1": "US",
"rating": "TV-MA"
},
{
"iso_3166_1": "CA",
"rating": "18+"
},
{
"iso_3166_1": "RU",
"rating": "18+"
}
],
"id": 1399
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/credits": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-credits",
"summary": "Get Credits",
"tags": [
"TV"
],
"description": "Get the credits (cast and crew) that have been added to a TV show.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/credits"
},
"examples": {
"application/json": {
"cast": [
{
"character": "Jon Snow",
"credit_id": "5256c8af19c2956ff6047af6",
"id": 239019,
"name": "Kit Harington",
"profile_path": "/dwRmvQUkddCx6Xi7vDrdnQL4SJ0.jpg",
"order": 0
},
{
"character": "Daenerys Targaryen",
"credit_id": "5256c8af19c2956ff60479f6",
"id": 1223786,
"name": "Emilia Clarke",
"profile_path": "/tB1nE2LJH81f5UMiGhKCSlaqsF1.jpg",
"order": 1
},
{
"character": "Tyrion Lannister",
"credit_id": "5256c8b219c2956ff6047cd8",
"id": 22970,
"name": "Peter Dinklage",
"profile_path": "/xuB7b4GbARu4HN6gq5zMqjGbkwF.jpg",
"order": 2
}
],
"crew": [
{
"credit_id": "56b86628c3a36806ec010e9b",
"department": "Production",
"id": 1467117,
"name": "Peter Welter Soler",
"job": "Line Producer",
"profile_path": null
},
{
"credit_id": "57bb168cc3a36815bb007ae3",
"department": "Art",
"id": 1406918,
"name": "Brendan Rankin",
"job": "Art Direction",
"profile_path": null
},
{
"credit_id": "56b8665b9251414c4500967c",
"department": "Art",
"id": 80424,
"name": "Philip Elton",
"job": "Art Direction",
"profile_path": null
}
],
"id": 1399
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/episode_groups": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-episode-groups",
"summary": "Get Episode Groups",
"tags": [
"TV"
],
"description": "Get all of the episode groups that have been created for a TV show.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/episode-group-list"
},
"examples": {
"application/json": {
"results": [
{
"description": "All episodes chronologically split by calendar year.",
"episode_count": 903,
"group_count": 23,
"id": "5af83d88c3a3682ac8007b28",
"name": "Year Split",
"network": {
"id": 569,
"logo_path": "/cIMyE9cw1W4kMFGxmC17HKTnVz9.png",
"name": "Yomiuri Telecasting Corporation",
"origin_country": "JP"
},
"type": 1
},
{
"description": "All specials chronologically split by different groups of specials, for examples, OVAs and Magic Files.",
"episode_count": 50,
"group_count": 7,
"id": "5b09cf3892514146fb007a0e",
"name": "Specials",
"network": null,
"type": 1
}
],
"id": 30983
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/external_ids": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-external-ids",
"summary": "Get External IDs",
"tags": [
"TV"
],
"description": "Get the external ids for a TV show. We currently support the following external sources.\n\n| **External Sources** |\n| -------------------- |\n| IMDB ID |\n| Freebase MID |\n| Freebase ID |\n| TVDB ID |\n| TVRage ID |",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/external-ids"
},
"examples": {
"application/json": {
"imdb_id": "tt0944947",
"freebase_mid": "/m/0524b41",
"freebase_id": "/en/game_of_thrones",
"tvdb_id": 121361,
"tvrage_id": 24493,
"id": 1399
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/images": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-images",
"summary": "Get Images",
"tags": [
"TV"
],
"description": "Get the images that belong to a TV show.\n\nQuerying images with a `language` parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the `include_image_language` parameter. This should be a comma seperated value like so: `include_image_language=en,null`.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"backdrops": [
{
"aspect_ratio": 1.77777777777778,
"file_path": "/mUkuc2wyV9dHLG0D0Loaw5pO2s8.jpg",
"height": 1080,
"iso_639_1": null,
"vote_average": 5.6265664160401,
"vote_count": 13,
"width": 1920
},
{
"aspect_ratio": 1.77777777777778,
"file_path": "/aKz3lXU71wqdslC1IYRC3yHD6yw.jpg",
"height": 1080,
"iso_639_1": null,
"vote_average": 5.52123552123552,
"vote_count": 11,
"width": 1920
}
],
"id": 1399,
"posters": [
{
"aspect_ratio": 0.666666666666667,
"file_path": "/hDd5Zd9VMOqBeHa2agbnHZ98WWr.jpg",
"height": 3000,
"iso_639_1": "en",
"vote_average": 5.57744937055282,
"vote_count": 24,
"width": 2000
},
{
"aspect_ratio": 0.666666666666667,
"file_path": "/hVK3ZytqiDYBPoIERK6SegUM2JE.jpg",
"height": 3000,
"iso_639_1": null,
"vote_average": 5.47974413646056,
"vote_count": 4,
"width": 2000
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/keywords": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-keywords-list",
"summary": "Get Keywords",
"tags": [
"TV"
],
"description": "Get the keywords that have been added to a TV show.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/keywords-list"
},
"examples": {
"application/json": {
"id": 1399,
"results": [
{
"id": 6091,
"name": "war"
},
{
"id": 818,
"name": "based on novel"
},
{
"id": 4152,
"name": "kingdom"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/recommendations": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-recommendations-paginated",
"summary": "Get Recommendations",
"tags": [
"TV"
],
"description": "Get the list of TV show recommendations for this item.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"backdrop_path": "/AwB0BmQm1GxP0BH8ZL7WPNDTkb5.jpg",
"first_air_date": "2016-01-05",
"genre_ids": [
10759,
10765
],
"id": 64122,
"original_language": "en",
"original_name": "The Shannara Chronicles",
"overview": "A young Healer armed with an unpredictable magic guides a runaway Elf in her perilous quest to save the peoples of the Four Lands from an age-old Demon scourge.",
"origin_country": [
"US"
],
"poster_path": "/aurZJ8UsXqhGwwBnNuZsPNepY8y.jpg",
"popularity": 9.523348,
"name": "The Shannara Chronicles",
"vote_average": 5.5,
"vote_count": 61
},
{
"backdrop_path": "/erYc6rPUSsoxwMx4hStEjVP3X3J.jpg",
"first_air_date": "2012-08-07",
"genre_ids": [
16,
10759,
10765,
35
],
"id": 44305,
"original_language": "en",
"original_name": "DreamWorks Dragons",
"overview": "DreamWorks Dragons is an American computer-animated television series airing on Cartoon Network based on the 2010 film How to Train Your Dragon. The series serves as a bridge between the first film and its 2014 sequel. Riders of Berk follows Hiccup as he tries to keep balance within the new cohabitation of Dragons and Vikings. Alongside keeping up with Berk's newest installment — A Dragon Training Academy — Hiccup, Toothless, and the rest of the Viking Teens are put to the test when they are faced with new worlds harsher than Berk, new dragons that can't all be trained, and new enemies who are looking for every reason to destroy the harmony between Vikings and Dragons all together.",
"origin_country": [
"US"
],
"poster_path": "/8T8bAVzaKKyDNGQ6DQB3HF80wbJ.jpg",
"popularity": 11.861156,
"name": "DreamWorks Dragons",
"vote_average": 7.3,
"vote_count": 14
}
],
"total_pages": 10,
"total_results": 185
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/similar": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-similar-paginated",
"summary": "Get Similar TV Shows",
"tags": [
"TV"
],
"description": "Get a list of similar TV shows. These items are assembled by looking at keywords and genres.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"backdrop_path": "/AwB0BmQm1GxP0BH8ZL7WPNDTkb5.jpg",
"first_air_date": "2016-01-05",
"genre_ids": [
10759,
10765
],
"id": 64122,
"original_language": "en",
"original_name": "The Shannara Chronicles",
"overview": "A young Healer armed with an unpredictable magic guides a runaway Elf in her perilous quest to save the peoples of the Four Lands from an age-old Demon scourge.",
"origin_country": [
"US"
],
"poster_path": "/aurZJ8UsXqhGwwBnNuZsPNepY8y.jpg",
"popularity": 9.523348,
"name": "The Shannara Chronicles",
"vote_average": 5.5,
"vote_count": 61
},
{
"backdrop_path": "/erYc6rPUSsoxwMx4hStEjVP3X3J.jpg",
"first_air_date": "2012-08-07",
"genre_ids": [
16,
10759,
10765,
35
],
"id": 44305,
"original_language": "en",
"original_name": "DreamWorks Dragons",
"overview": "DreamWorks Dragons is an American computer-animated television series airing on Cartoon Network based on the 2010 film How to Train Your Dragon. The series serves as a bridge between the first film and its 2014 sequel. Riders of Berk follows Hiccup as he tries to keep balance within the new cohabitation of Dragons and Vikings. Alongside keeping up with Berk's newest installment — A Dragon Training Academy — Hiccup, Toothless, and the rest of the Viking Teens are put to the test when they are faced with new worlds harsher than Berk, new dragons that can't all be trained, and new enemies who are looking for every reason to destroy the harmony between Vikings and Dragons all together.",
"origin_country": [
"US"
],
"poster_path": "/8T8bAVzaKKyDNGQ6DQB3HF80wbJ.jpg",
"popularity": 11.861156,
"name": "DreamWorks Dragons",
"vote_average": 7.3,
"vote_count": 14
}
],
"total_pages": 10,
"total_results": 185
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/translations": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-translations-list",
"summary": "Get Translations",
"tags": [
"TV"
],
"description": "Get a list of the translations that exist for a TV show.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/translations-list"
},
"examples": {
"application/json": {
"id": 12345,
"translations": [
{
"iso_3166_1": "US",
"iso_639_1": "en",
"name": "English",
"english_name": "English",
"data": {
"name": "",
"overview": "Van der Valk is a British television series that was produced by Thames Television for the ITV network. It starred Barry Foster in the title role as Dutch detective Commissaris \"Piet\" van der Valk. Based on the characters and atmosphere of the novels of Nicolas Freeling, the first series was shown in 1972.",
"homepage": ""
}
},
{
"iso_3166_1": "DE",
"iso_639_1": "de",
"name": "Deutsch",
"english_name": "German",
"data": {
"name": "Van der Valk",
"overview": "Van der Valk ist eine britische Fernseh-Krimiserie ",
"homepage": ""
}
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/videos": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-videos-list",
"summary": "Get Videos",
"tags": [
"TV"
],
"description": "Get the videos that have been added to a TV show.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/videos-list"
},
"examples": {
"application/json": {
"id": 1399,
"results": [
{
"id": "572003f992514121f30003c6",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "BpJYNVhGf1s",
"name": "\"The Game Begins\"",
"site": "YouTube",
"size": 720,
"type": "Trailer"
},
{
"id": "55311e34c3a368411700235c",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "iGp_N3Ir7Do",
"name": "Trailer",
"site": "YouTube",
"size": 720,
"type": "Trailer"
},
{
"id": "5335ee1dc3a36826430000e6",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "s7L2PVdrb_8",
"name": "Intro",
"site": "YouTube",
"size": 720,
"type": "Opening Credits"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/rating": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"post": {
"operationId": "post-tv-rating",
"summary": "Rate TV Show",
"tags": [
"TV"
],
"description": "Rate a TV show.\n\nA valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:ratingBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
},
"delete": {
"operationId": "delete-tv-rating",
"summary": "Delete Rating",
"tags": [
"TV"
],
"description": "Remove your rating for a TV show.\n\nA valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"parameters": [
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/screened_theatrically": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-screened-theatrically",
"summary": "Get Screened Theatrically",
"tags": [
"TV"
],
"description": "Get a list of seasons or episodes that have been screened in a film festival or theatre.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/season-episode-list"
},
"examples": {
"application/json": {
"id": 68716,
"results": [
{
"id": 1279700,
"episode_number": 1,
"season_number": 1
},
{
"id": 1332116,
"episode_number": 2,
"season_number": 1
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-details",
"summary": "Get Details",
"tags": [
"TV Seasons"
],
"description": "Get the TV season details by id.\n\nSupports `append_to_response`. Read more about this [here](#docTextSection:JdZq8ctmcxNqyLQjp).",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:appendToResponseParam:append_to_response"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/season-details"
},
"examples": {
"application/json": {
"_id": "5256c89f19c2956ff6046d47",
"air_date": "2011-04-17",
"episodes": [
{
"air_date": "2011-04-17",
"crew": [
{
"id": 44797,
"credit_id": "5256c8a219c2956ff6046e77",
"name": "Tim Van Patten",
"department": "Directing",
"job": "Director",
"profile_path": "/6b7l9YbkDHDOzOKUFNqBVaPjcgm.jpg"
},
{
"id": 1318704,
"credit_id": "54eef2429251417974005cb6",
"name": "Alik Sakharov",
"department": "Camera",
"job": "Director of Photography",
"profile_path": "/50ZlHkh66aOPxQMjQ21LJDAkYlR.jpg"
},
{
"id": 18077,
"credit_id": "54eef2ab925141795f005d4f",
"name": "Oral Norrie Ottey",
"department": "Editing",
"job": "Editor",
"profile_path": null
}
],
"episode_number": 1,
"guest_stars": [
{
"id": 117642,
"name": "Jason Momoa",
"credit_id": "5256c8a219c2956ff6046f40",
"character": "Khal Drogo",
"order": 0,
"profile_path": "/PSK6GmsVwdhqz9cd1lwzC6a7EA.jpg"
},
{
"id": 946696,
"name": "Ian Whyte",
"credit_id": "5750cd459251412b0f000224",
"character": "White Walker",
"order": 46,
"profile_path": "/6mRY7hTtHfDTGuTLmZmODOu9buF.jpg"
},
{
"id": 438859,
"name": "Susan Brown",
"credit_id": "57520bc19251414c470000de",
"character": "Septa Mordane",
"order": 52,
"profile_path": "/5bYvoJDOw4okAzSxJ1avXweUyA9.jpg"
}
],
"name": "Winter Is Coming",
"overview": "Jon Arryn, the Hand of the King, is dead. King Robert Baratheon plans to ask his oldest friend, Eddard Stark, to take Jon's place. Across the sea, Viserys Targaryen plans to wed his sister to a nomadic warlord in exchange for an army.",
"id": 63056,
"production_code": "101",
"season_number": 1,
"still_path": "/wrGWeW4WKxnaeA8sxJb2T9O6ryo.jpg",
"vote_average": 7.11904761904762,
"vote_count": 21
},
{
"air_date": "2011-04-24",
"crew": [
{
"id": 44797,
"credit_id": "5256c8a219c2956ff6046e77",
"name": "Tim Van Patten",
"department": "Directing",
"job": "Director",
"profile_path": "/6b7l9YbkDHDOzOKUFNqBVaPjcgm.jpg"
},
{
"id": 1318704,
"credit_id": "54eef2429251417974005cb6",
"name": "Alik Sakharov",
"department": "Camera",
"job": "Director of Photography",
"profile_path": "/50ZlHkh66aOPxQMjQ21LJDAkYlR.jpg"
},
{
"id": 18077,
"credit_id": "54eef2ab925141795f005d4f",
"name": "Oral Norrie Ottey",
"department": "Editing",
"job": "Editor",
"profile_path": null
}
],
"episode_number": 2,
"guest_stars": [
{
"id": 117642,
"name": "Jason Momoa",
"credit_id": "5256c8a219c2956ff6046f40",
"character": "Khal Drogo",
"order": 0,
"profile_path": "/PSK6GmsVwdhqz9cd1lwzC6a7EA.jpg"
},
{
"id": 225870,
"name": "Wilko Johnson",
"credit_id": "5750d240c3a3682fa000041c",
"character": "Ilyn Payne",
"order": 49,
"profile_path": "/ofncvvhuucP8ip3x8duQEzhJrsT.jpg"
},
{
"id": 1048692,
"name": "Amrita Acharia",
"credit_id": "5750d365925141087f0006e1",
"character": "Irri",
"order": 50,
"profile_path": "/uwz4vjtIMxD9y7uq3CFpPjrznVR.jpg"
}
],
"name": "The Kingsroad",
"overview": "While Bran recovers from his fall, Ned takes only his daughters to Kings Landing. Jon Snow goes with his uncle Benjen to The Wall. Tyrion joins them.",
"id": 63057,
"production_code": "102",
"season_number": 1,
"still_path": "/icjOgl5F9DhysOEo6Six2Qfwcu2.jpg",
"vote_average": 7.375,
"vote_count": 4
}
],
"name": "Season 1",
"overview": "Trouble is brewing in the Seven Kingdoms of Westeros. For the driven inhabitants of this visionary world, control of Westeros' Iron Throne holds the lure of great power. But in a land where the seasons can last a lifetime, winter is coming...and beyond the Great Wall that protects them, an ancient evil has returned. In Season One, the story centers on three primary areas: the Stark and the Lannister families, whose designs on controlling the throne threaten a tenuous peace; the dragon princess Daenerys, heir to the former dynasty, who waits just over the Narrow Sea with her malevolent brother Viserys; and the Great Wall--a massive barrier of ice where a forgotten danger is stirring.",
"id": 3624,
"poster_path": "/olJ6ivXxCMq3cfujo1IRw30OrsQ.jpg",
"season_number": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/account_states": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-account-states",
"summary": "Get Account States",
"tags": [
"TV Seasons"
],
"description": "Returns all of the user ratings for the season's episodes.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/episode-rating-list"
},
"examples": {
"application/json": {
"id": 3624,
"results": [
{
"id": 63056,
"episode_number": 1,
"rated": {
"value": 9
}
},
{
"id": 63057,
"episode_number": 2,
"rated": false
},
{
"id": 63058,
"episode_number": 3,
"rated": false
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/credits": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-credits",
"summary": "Get Credits",
"tags": [
"TV Seasons"
],
"description": "Get the credits for TV season.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/credits"
},
"examples": {
"application/json": {
"cast": [
{
"character": "Eddard Stark",
"credit_id": "5256c8ad19c2956ff60478a6",
"id": 48,
"name": "Sean Bean",
"profile_path": "/7MCfXCIWi9ViLrgKCV3Hz4f6jov.jpg",
"order": 0
},
{
"character": "Jon Snow",
"credit_id": "5256c8af19c2956ff6047af6",
"id": 239019,
"name": "Kit Harington",
"profile_path": "/dwRmvQUkddCx6Xi7vDrdnQL4SJ0.jpg",
"order": 0
},
{
"character": "Robert Baratheon",
"credit_id": "5256c8ad19c2956ff60478e2",
"id": 13633,
"name": "Mark Addy",
"profile_path": "/tGWYaLPIGvPJiKx9KzTBMITo7uK.jpg",
"order": 1
}
],
"crew": [
{
"credit_id": "54eee8b8c3a3686d5e005430",
"department": "Art",
"id": 9153,
"name": "Gemma Jackson",
"job": "Production Design",
"profile_path": null
},
{
"credit_id": "54ef3928925141796e00614d",
"department": "Production",
"id": 16363,
"name": "Nina Gold",
"job": "Casting",
"profile_path": "/kljYhRvTAqQfX198mjz0ITP0hFM.jpg"
},
{
"credit_id": "54ef391cc3a3686b9a003bd0",
"department": "Production",
"id": 1019426,
"name": "Robert Sterne",
"job": "Casting",
"profile_path": null
}
],
"id": 3624
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/external_ids": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-external-ids",
"summary": "Get External IDs",
"tags": [
"TV Seasons"
],
"description": "Get the external ids for a TV season. We currently support the following external sources.\n\n| **External Sources** |\n| -------------------- |\n| Freebase MID |\n| Freebase ID |\n| TVDB ID |\n| TVRage ID |",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/external-ids"
},
"examples": {
"application/json": {
"freebase_mid": "/m/0gmd1gd",
"freebase_id": null,
"tvdb_id": 364731,
"tvrage_id": null,
"id": 3624
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/images": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-images",
"summary": "Get Images",
"tags": [
"TV Seasons"
],
"description": "Get the images that belong to a TV season.\n\nQuerying images with a `language` parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the `include_image_language` parameter. This should be a comma seperated value like so: `include_image_language=en,null`.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 3624,
"posters": [
{
"aspect_ratio": 0.666666666666667,
"file_path": "/olJ6ivXxCMq3cfujo1IRw30OrsQ.jpg",
"height": 1425,
"iso_639_1": "en",
"vote_average": 5.37612146307798,
"vote_count": 6,
"width": 950
},
{
"aspect_ratio": 0.68,
"file_path": "/9Pf7Wf5b0FxGglMqnuoVD86XpmY.jpg",
"height": 1500,
"iso_639_1": "hu",
"vote_average": 5.3125,
"vote_count": 1,
"width": 1020
},
{
"aspect_ratio": 0.700909090909091,
"file_path": "/uAWrtCFIJo6gUweHwuSSqRILaIX.jpg",
"height": 1100,
"iso_639_1": "es",
"vote_average": 5.3125,
"vote_count": 1,
"width": 771
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/videos": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-videos",
"summary": "Get Videos",
"tags": [
"TV Seasons"
],
"description": "Get the videos that have been added to a TV season.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/videos-list"
},
"examples": {
"application/json": {
"id": 3624,
"results": [
{
"id": "534921db0e0a266b3f0013bb",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "9cqABojhqr4",
"name": "Pledge Your Allegiance - House Stark",
"site": "YouTube",
"size": 720,
"type": "Featurette"
},
{
"id": "534922b00e0a266b4a0014e9",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "5H7Q3SZ2kec",
"name": "Character Feature - Catelyn Stark",
"site": "YouTube",
"size": 720,
"type": "Featurette"
},
{
"id": "534922d30e0a266b4a0014ee",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "JLF5afwjvQQ",
"name": "Character Feature - Robb Stark",
"site": "YouTube",
"size": 720,
"type": "Featurette"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-details",
"summary": "Get Details",
"tags": [
"TV Episodes"
],
"description": "Get the TV episode details by id.\n\nSupports `append_to_response`. Read more about this [here](#docTextSection:JdZq8ctmcxNqyLQjp).",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:appendToResponseParam:append_to_response"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/episode-details"
},
"examples": {
"application/json": {
"air_date": "2011-04-17",
"crew": [
{
"id": 44797,
"credit_id": "5256c8a219c2956ff6046e77",
"name": "Tim Van Patten",
"department": "Directing",
"job": "Director",
"profile_path": "/6b7l9YbkDHDOzOKUFNqBVaPjcgm.jpg"
},
{
"id": 1318704,
"credit_id": "54eef2429251417974005cb6",
"name": "Alik Sakharov",
"department": "Camera",
"job": "Director of Photography",
"profile_path": "/50ZlHkh66aOPxQMjQ21LJDAkYlR.jpg"
},
{
"id": 18077,
"credit_id": "54eef2ab925141795f005d4f",
"name": "Oral Norrie Ottey",
"department": "Editing",
"job": "Editor",
"profile_path": null
}
],
"episode_number": 1,
"guest_stars": [
{
"id": 117642,
"name": "Jason Momoa",
"credit_id": "5256c8a219c2956ff6046f40",
"character": "Khal Drogo",
"order": 0,
"profile_path": "/PSK6GmsVwdhqz9cd1lwzC6a7EA.jpg"
},
{
"id": 946696,
"name": "Ian Whyte",
"credit_id": "5750cd459251412b0f000224",
"character": "White Walker",
"order": 46,
"profile_path": "/6mRY7hTtHfDTGuTLmZmODOu9buF.jpg"
},
{
"id": 438859,
"name": "Susan Brown",
"credit_id": "57520bc19251414c470000de",
"character": "Septa Mordane",
"order": 52,
"profile_path": "/5bYvoJDOw4okAzSxJ1avXweUyA9.jpg"
}
],
"name": "Winter Is Coming",
"overview": "Jon Arryn, the Hand of the King, is dead. King Robert Baratheon plans to ask his oldest friend, Eddard Stark, to take Jon's place. Across the sea, Viserys Targaryen plans to wed his sister to a nomadic warlord in exchange for an army.",
"id": 63056,
"production_code": "101",
"season_number": 1,
"still_path": "/wrGWeW4WKxnaeA8sxJb2T9O6ryo.jpg",
"vote_average": 7.11904761904762,
"vote_count": 21
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/account_states": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-account-states",
"summary": "Get Account States",
"tags": [
"TV Episodes"
],
"description": "Get your rating for a episode.",
"parameters": [
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/episode-rating-list"
},
"examples": {
"application/json": {
"id": 63056,
"rated": {
"value": 9
}
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/credits": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-credits",
"summary": "Get Credits",
"tags": [
"TV Episodes"
],
"description": "Get the credits (cast, crew and guest stars) for a TV episode.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/credits"
},
"examples": {
"application/json": {
"cast": [
{
"character": "Eddard Stark",
"credit_id": "5256c8ad19c2956ff60478a6",
"id": 48,
"name": "Sean Bean",
"profile_path": "/7MCfXCIWi9ViLrgKCV3Hz4f6jov.jpg",
"order": 0
},
{
"character": "Jon Snow",
"credit_id": "5256c8af19c2956ff6047af6",
"id": 239019,
"name": "Kit Harington",
"profile_path": "/dwRmvQUkddCx6Xi7vDrdnQL4SJ0.jpg",
"order": 0
},
{
"character": "Robert Baratheon",
"credit_id": "5256c8ad19c2956ff60478e2",
"id": 13633,
"name": "Mark Addy",
"profile_path": "/tGWYaLPIGvPJiKx9KzTBMITo7uK.jpg",
"order": 1
},
{
"character": "Daenerys Targaryen",
"credit_id": "5256c8af19c2956ff60479f6",
"id": 1223786,
"name": "Emilia Clarke",
"profile_path": "/tB1nE2LJH81f5UMiGhKCSlaqsF1.jpg",
"order": 1
}
],
"crew": [
{
"id": 44797,
"credit_id": "5256c8a219c2956ff6046e77",
"name": "Tim Van Patten",
"department": "Directing",
"job": "Director",
"profile_path": "/6b7l9YbkDHDOzOKUFNqBVaPjcgm.jpg"
},
{
"id": 1318704,
"credit_id": "54eef2429251417974005cb6",
"name": "Alik Sakharov",
"department": "Camera",
"job": "Director of Photography",
"profile_path": "/50ZlHkh66aOPxQMjQ21LJDAkYlR.jpg"
},
{
"id": 18077,
"credit_id": "54eef2ab925141795f005d4f",
"name": "Oral Norrie Ottey",
"department": "Editing",
"job": "Editor",
"profile_path": null
}
],
"guest_stars": [
{
"id": 117642,
"name": "Jason Momoa",
"credit_id": "5256c8a219c2956ff6046f40",
"character": "Khal Drogo",
"order": 0,
"profile_path": "/PSK6GmsVwdhqz9cd1lwzC6a7EA.jpg"
},
{
"id": 946696,
"name": "Ian Whyte",
"credit_id": "5750cd459251412b0f000224",
"character": "White Walker",
"order": 46,
"profile_path": "/6mRY7hTtHfDTGuTLmZmODOu9buF.jpg"
},
{
"id": 438859,
"name": "Susan Brown",
"credit_id": "57520bc19251414c470000de",
"character": "Septa Mordane",
"order": 52,
"profile_path": "/5bYvoJDOw4okAzSxJ1avXweUyA9.jpg"
}
],
"id": 63056
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/external_ids": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-external-ids",
"summary": "Get TV Episode External IDs",
"tags": [
"TV Episodes"
],
"description": "Get the external ids for a TV episode. We currently support the following external sources.\n\n| **External Sources** |\n| -------------------- |\n| IMDB ID |\n| Freebase MID |\n| Freebase ID |\n| TVDB ID |\n| TVRage ID |",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/external-ids"
},
"examples": {
"application/json": {
"imdb_id": "tt1480055",
"freebase_mid": "/m/0gmc6ph",
"freebase_id": "/en/winter_is_coming",
"tvdb_id": 3254641,
"tvrage_id": 1065008299,
"id": 63056
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/images": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-images",
"summary": "Get Images",
"tags": [
"TV Episodes"
],
"description": "Get the images that belong to a TV episode.\n\nQuerying images with a `language` parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the `include_image_language` parameter. This should be a comma seperated value like so: `include_image_language=en,null`.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:include_image_language"
},
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/images"
},
"examples": {
"application/json": {
"id": 63056,
"stills": [
{
"aspect_ratio": 1.77777777777778,
"file_path": "/wrGWeW4WKxnaeA8sxJb2T9O6ryo.jpg",
"height": 1080,
"iso_639_1": null,
"vote_average": 5.30505952380952,
"vote_count": 1,
"width": 1920
},
{
"aspect_ratio": 1.77777777777778,
"file_path": "/9o3HXUmWaZq14tIAbBrn7e34NRZ.jpg",
"height": 1080,
"iso_639_1": "en",
"vote_average": 0,
"vote_count": 0,
"width": 1920
},
{
"aspect_ratio": 1.77777777777778,
"file_path": "/xIfvIM7YgkADTrqp23rm3CLaOVQ.jpg",
"height": 1080,
"iso_639_1": null,
"vote_average": 0,
"vote_count": 0,
"width": 1920
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/translations": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-translations-list",
"summary": "Get Translations",
"tags": [
"TV Episodes"
],
"description": "Get the translation data for an episode.",
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/translations-list"
},
"examples": {
"application/json": {
"id": 479529,
"translations": [
{
"iso_3166_1": "DE",
"iso_639_1": "de",
"name": "Deutsch",
"english_name": "German",
"data": {
"name": "",
"overview": ""
}
},
{
"iso_3166_1": "US",
"iso_639_1": "en",
"name": "English",
"english_name": "English",
"data": {
"name": "One Herring's Not Enough",
"overview": "When a man confesses to the double murder of his wife and her lover it seems an open and shut case; but as one part after another of the man's story doesn't check out, van der Valk realizes he is dealing with something far more complicated."
}
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/rating": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"post": {
"operationId": "post-tv-season-episode-rating",
"summary": "Rate TV Episode",
"tags": [
"TV Episodes"
],
"description": "Rate a TV episode.\n\nA valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/trait:ratingBody"
},
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"201": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
},
"delete": {
"operationId": "delete-tv-season-episode-rating",
"summary": "Delete Rating",
"tags": [
"TV Episodes"
],
"description": "Remove your rating for a TV episode.\n\nA valid session or guest session ID is required. You can read more about how this works [here](#docTextSection:NSZtgz7zptsiLYxXZ).",
"parameters": [
{
"$ref": "#/parameters/trait:jsonContentType:Content-Type"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:guest_session_id"
},
{
"$ref": "#/parameters/trait:sessionOrGuestSession:session_id"
}
],
"responses": {
"200": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/{tv_id}/season/{season_number}/episode/{episode_number}/videos": {
"parameters": [
{
"name": "tv_id",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "season_number",
"in": "path",
"required": true,
"type": "integer"
},
{
"name": "episode_number",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-episode-videos-list",
"summary": "Get Videos",
"tags": [
"TV Episodes"
],
"description": "Get the videos that have been added to a TV episode.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/videos-list"
},
"examples": {
"application/json": {
"id": 63057,
"results": [
{
"id": "5349285f0e0a266b4a00153e",
"iso_639_1": "en",
"iso_3166_1": "US",
"key": "kPrW3Swrp4E",
"name": "Clip #1",
"site": "YouTube",
"size": 720,
"type": "Clip"
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/airing_today": {
"get": {
"operationId": "get-tv-airing-today-paginated",
"summary": "Get TV Airing Today",
"tags": [
"TV"
],
"description": "Get a list of TV shows that are airing today. This query is purely day based as we do not currently support airing times.\n\nYou can specify a [timezone](endpoint:KQ4CDdEoWKJYLkrhS) to offset the day calculation. Without a specified timezone, this query defaults to EST (Eastern Time UTC-05:00).",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/zra8NrzxaEeunRWJmUm3HZOL4sd.jpg",
"popularity": 11.520271,
"id": 67419,
"backdrop_path": "/b0BckgEovxYLBbIk5xXyWYQpmlT.jpg",
"vote_average": 1.39,
"overview": "The early life of Queen Victoria, from her accession to the throne at the tender age of 18 through to her courtship and marriage to Prince Albert. Victoria went on to rule for 63 years, and was the longest-serving monarch until she was overtaken by Elizabeth II on 9th September 2016. Rufus Sewell was Victoria’s first prime minister; the two immediately connected and their intimate friendship became a popular source of gossip that threatened to destabilise the Government – angering both Tory and Whigs alike.",
"first_air_date": "2016-08-28",
"origin_country": [
"GB"
],
"genre_ids": [
18
],
"original_language": "en",
"vote_count": 9,
"name": "Victoria",
"original_name": "Victoria"
},
{
"poster_path": "/sdB3AQqUsgjrDb7qTBqYOp6VwAG.jpg",
"popularity": 9.699399,
"id": 66433,
"backdrop_path": null,
"vote_average": 9,
"overview": "Scarlet Heart: Ryeo is the remake of Chinese drama Bu Bu Jing Xin that stars IU as a woman who gets time-warped back to the Goryeo dynasty, and becomes involved with a very large family of princes, some of whom are vying for the throne, or her affections, or both.",
"first_air_date": "2016-08-29",
"origin_country": [
"KR"
],
"genre_ids": [
18
],
"original_language": "ko",
"vote_count": 2,
"name": "Moon Lovers: Scarlet Heart Ryeo",
"original_name": "달의 연인-보보경심 려"
}
],
"total_results": 43,
"total_pages": 3
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/changes": {
"get": {
"operationId": "get-tv-changes-paginated",
"summary": "Get TV Change List",
"tags": [
"Changes"
],
"description": "Get a list of all of the TV show ids that have been changed in the past 24 hours.\n\nYou can query it for up to 14 days worth of changed IDs at a time with the `start_date` and `end_date` query parameters. 100 items are returned per page.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/changes-paginated"
},
"examples": {
"application/json": {
"results": [
{
"id": 67563,
"adult": false
},
{
"id": 55169,
"adult": false
},
{
"id": 63279,
"adult": false
}
],
"page": 1,
"total_pages": 2,
"total_results": 122
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/episode/{episode_id}/changes": {
"parameters": [
{
"name": "episode_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-episode-changes",
"summary": "Get Changes",
"tags": [
"TV Episodes"
],
"description": "Get the changes for a TV episode. By default only the last 24 hours are returned.\n\nYou can query up to 14 days in a single query by using the `start_date` and `end_date` query parameters.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/change-details"
},
"examples": {
"application/json": {
"changes": [
{
"key": "production_code",
"items": [
{
"id": "54bd9ed7c3a3686c6b00da66",
"action": "added",
"time": "2015-01-20 00:18:31 UTC",
"value": "101"
}
]
},
{
"key": "overview",
"items": [
{
"id": "54bd9ed7c3a3686c6b00da67",
"action": "updated",
"time": "2015-01-20 00:18:31 UTC",
"iso_639_1": "fr",
"value": "Sur le continent de Westeros, un jeune patrouilleur de la Garde de Nuit, chargée de veiller sur le Mur, est condamné à mort pour désertion par Eddard Stark, seigneur de Winterfell et Gardien du Nord. Mais de sombres nouvelles arrivent de Port-Réal, la capitale des Sept Couronnes : Jon Arryn, ami intime d'Eddard et Main du roi Robert Baratheon, vient de mourir. Le roi Robert et sa cour entreprennent alors un voyage vers Winterfell, pour gratifier son ami Eddard de la charge de Main du roi. Pendant ce temps, les descendants des rois Targaryen en exil, renversés par Robert, fomentent leur retour en Westeros par un jeu d'alliance avec les Dothrakis, une tribu de guerriers nomades.\nAlors qu'à Winterfell les festivités vont bon train durant le séjour du roi, Brandon, l'un des fils d'Eddard Stark, fait une découverte qui lui attire les foudres de la famille royale…",
"original_value": "Sur le continent de Westeros, un jeune patrouilleur de la Garde de Nuit, chargée de veiller sur le Mur, est condamné à mort pour désertion par Eddard Stark, seigneur de Winterfell et Gardien du Nord. Mais de sombres nouvelles arrivent de Port-Réal, la capitale des Sept Couronnes : Jon Arryn, ami intime d'Eddard et Main du roi Robert Baratheon, vient de mourir. Le roi Robert et sa cour entreprennent alors un voyage vers Winterfell, pour gratifier son ami Eddard de la charge de Main du roi. Pendant ce temps, les descendants des rois Targaryen en exil, renversés par Robert, fomentent leur retour en Westeros par un jeu d'alliance avec les Dothrakis, une tribu de guerriers nomades.\n\nAlors qu'à Winterfell les festivités vont bon train durant le séjour du roi, Brandon, l'un des fils d'Eddard Stark, fait une découverte qui lui attire les foudres de la famille royale..."
},
{
"id": "54c53255c3a36814210141d0",
"action": "added",
"time": "2015-01-25 18:13:41 UTC",
"iso_639_1": "es",
"value": "Ned Stark, Señor de Invernalia se entera de que su mentor, Jon Arryn, ha muerto y por esto el Rey Robert se dirige hacia el norte para ofrecerle ser la Mano del Rey. Al otro lado del Mar en Pentos, Viserys Targaryen planea casar a su hermana Daenerys con el lider de los guerreros de la tribu Dothraki, Khal Drogo con el objetivo de forjar una alianza que le permita reclamar el trono."
}
]
},
{
"key": "tvrage_id",
"items": [
{
"id": "54bd9ed89251416e9b005079",
"action": "added",
"time": "2015-01-20 00:18:32 UTC",
"value": "1065008299"
}
]
},
{
"key": "name",
"items": [
{
"id": "54c53255c3a36814210141cf",
"action": "added",
"time": "2015-01-25 18:13:41 UTC",
"iso_639_1": "es",
"value": "Se acerca el invierno"
}
]
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/episode_group/{episode_group_id}": {
"parameters": [
{
"name": "episode_group_id",
"in": "path",
"required": true,
"type": "string"
}
],
"get": {
"operationId": "get-episode-group-details",
"summary": "Get Details",
"tags": [
"TV Episode Groups"
],
"description": "Get the details of a TV episode group. Groups support 7 different types which are enumerated as the following:\n1. Original air date\n2. Absolute\n3. DVD\n4. Digital\n5. Story arc\n6. Production\n7. TV.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/episode-group-details"
},
"examples": {
"application/json": {
"description": "Comedians in Cars organized in Netflix's collections.",
"episode_count": 71,
"group_count": 5,
"groups": [
{
"id": "5acf93efc3a368739a0000a9",
"name": "First Cup",
"order": 1,
"episodes": [
{
"air_date": "2015-06-17",
"episode_number": 3,
"id": 1078262,
"name": "Jim Carrey: We Love Breathing What You're Burning, Baby",
"overview": "Jerry’s full of testosterone as he steps into a ‘76 Lamborghini Countach with Jim Carrey, who’s between a three-week cleanse and a five-day silent retreat. After coffee, it’s off to Carrey’s studio to study a portrait of a gorilla with a machine gun. Wow.",
"production_code": null,
"season_number": 6,
"show_id": 59717,
"still_path": "/aOyE420zuFq9zWtEWjIccAiTrzU.jpg",
"vote_average": 0,
"vote_count": 0,
"order": 0
},
{
"air_date": "2014-12-18",
"episode_number": 7,
"id": 1033379,
"name": "Jimmy Fallon: The Unsinkable Legend: Part 1",
"overview": "Jerry and his special guest Jimmy Fallon cruise over to Jerry's actual car in a 1956 Chevy Corvette convertible to hop aboard yet another vehicle to enjoy some comedic sailing out at sea.",
"production_code": null,
"season_number": 5,
"show_id": 59717,
"still_path": "/m9wwqDv6mPMcIpGrh7nkR4zQp3s.jpg",
"vote_average": 0,
"vote_count": 0,
"order": 1
}
],
"locked": true
},
{
"id": "5acf93f69251413b390000dd",
"name": "Light & Sweet",
"order": 2,
"episodes": [
{
"air_date": "2015-12-30",
"episode_number": 1,
"id": 1149915,
"name": "President Barack Obama: Just Tell Him You’re the President",
"overview": "For the premiere episode of Season 7, Jerry takes President Barack Obama for a spin in a 1963 Corvette Stingray Split Window Coupe but finds it hard to spirit the leader of the free world off the White House grounds.",
"production_code": null,
"season_number": 7,
"show_id": 59717,
"still_path": "/zKkizD50quQHzlOGl54zMc4DNlM.jpg",
"vote_average": 0,
"vote_count": 0,
"order": 0
},
{
"air_date": "2014-11-06",
"episode_number": 1,
"id": 1021931,
"name": "Kevin Hart: You Look Amazing in the Wind",
"overview": "Jerry Seinfeld and his special guest Kevin Hart stylishly cruise around town in a 1959 Porsche RSK Spyder for their \"weird male date.\" Plus special extra feature: \"Dick Corcoran\"",
"production_code": null,
"season_number": 5,
"show_id": 59717,
"still_path": "/4VwK7ceYcVtYqqivXR0DhNEhYXJ.jpg",
"vote_average": 0,
"vote_count": 0,
"order": 1
}
],
"locked": true
},
{
"id": "5acf93fdc3a36873920000b9",
"name": "Just Made a Fresh Pot",
"order": 3,
"episodes": [
{
"air_date": "2014-11-13",
"episode_number": 2,
"id": 1021932,
"name": "Amy Schumer: I'm Wondering What It's Like to Date Me",
"overview": "Jerry Seinfeld and his special guest Amy Schumer check out “cute bongs” as they walk to a local diner for some coffee after their 1971 Ferrari Daytona breaks down.",
"production_code": null,
"season_number": 5,
"show_id": 59717,
"still_path": "/y4u7S6qtWXeDLxCS7lhSDQ52QOn.jpg",
"vote_average": 0,
"vote_count": 0,
"order": 0
},
{
"air_date": "2015-06-10",
"episode_number": 2,
"id": 1074965,
"name": "Steve Harvey: Always Do the Banana Joke First",
"overview": "Jerry and Steve Harvey prowl Chicago in a ‘57 Chevy Bel Air convertible, enjoy some fine cigars and muse about offensive jokes and the futility of comedy class.",
"production_code": null,
"season_number": 6,
"show_id": 59717,
"still_path": "/52QtVCQpRyyYgm6nKuHilcfcpUj.jpg",
"vote_average": 0,
"vote_count": 0,
"order": 1
}
],
"locked": true
}
],
"id": "5acf93e60e0a26346d0000ce",
"name": "Netflix Collections",
"network": {
"id": 213,
"logo_path": "/wwemzKWzjKYJFfCeiB57q3r4Bcm.png",
"name": "Netflix",
"origin_country": ""
},
"type": 4
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/latest": {
"get": {
"operationId": "get-tv-latest-details",
"summary": "Get Latest",
"tags": [
"TV"
],
"description": "Get the most newly created TV show. This is a live response and will continuously change.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-details"
},
"examples": {
"application/json": {
"backdrop_path": null,
"created_by": [],
"episode_run_time": [
30
],
"first_air_date": "2016-08-23",
"genres": [
{
"id": 35,
"name": "Comedy"
},
{
"id": 10764,
"name": "Reality"
}
],
"homepage": "http://www.trutv.com/shows/you-can-do-better",
"id": 67625,
"in_production": true,
"languages": [
"en"
],
"last_air_date": "2016-08-30",
"name": "You Can Do Better",
"networks": [
{
"id": 364,
"name": "truTV"
}
],
"number_of_episodes": 1,
"number_of_seasons": 1,
"origin_country": [
"US"
],
"original_language": "en",
"original_name": "You Can Do Better",
"overview": null,
"popularity": 0,
"poster_path": null,
"production_companies": [],
"seasons": [
{
"air_date": "2016-08-23",
"episode_count": 2,
"id": 79695,
"poster_path": null,
"season_number": 1
}
],
"status": "Returning Series",
"type": "Reality",
"vote_average": 10,
"vote_count": 1
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/popular": {
"get": {
"operationId": "get-tv-popular-paginated",
"summary": "Get Popular",
"tags": [
"TV"
],
"description": "Get a list of the current popular TV shows on TMDb. This list updates daily.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/vC324sdfcS313vh9QXwijLIHPJp.jpg",
"popularity": 47.432451,
"id": 31917,
"backdrop_path": "/rQGBjWNveVeF8f2PGRtS85w9o9r.jpg",
"vote_average": 5.04,
"overview": "Based on the Pretty Little Liars series of young adult novels by Sara Shepard, the series follows the lives of four girls — Spencer, Hanna, Aria, and Emily — whose clique falls apart after the disappearance of their queen bee, Alison. One year later, they begin receiving messages from someone using the name \"A\" who threatens to expose their secrets — including long-hidden ones they thought only Alison knew.",
"first_air_date": "2010-06-08",
"origin_country": [
"US"
],
"genre_ids": [
18,
9648
],
"original_language": "en",
"vote_count": 133,
"name": "Pretty Little Liars",
"original_name": "Pretty Little Liars"
},
{
"poster_path": "/esN3gWb1P091xExLddD2nh4zmi3.jpg",
"popularity": 37.882356,
"id": 62560,
"backdrop_path": "/v8Y9yurHuI7MujWQMd8iL3Gy4B5.jpg",
"vote_average": 7.5,
"overview": "A contemporary and culturally resonant drama about a young programmer, Elliot, who suffers from a debilitating anti-social disorder and decides that he can only connect to people by hacking them. He wields his skills as a weapon to protect the people that he cares about. Elliot will find himself in the intersection between a cybersecurity firm he works for and the underworld organizations that are recruiting him to bring down corporate America.",
"first_air_date": "2015-05-27",
"origin_country": [
"US"
],
"genre_ids": [
80,
18
],
"original_language": "en",
"vote_count": 287,
"name": "Mr. Robot",
"original_name": "Mr. Robot"
}
],
"total_results": 20000,
"total_pages": 1000
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/on_the_air": {
"get": {
"operationId": "get-tv-on-the-air-paginated",
"summary": "Get TV On The Air",
"tags": [
"TV"
],
"description": "Get a list of shows that are currently on the air.\n\nThis query looks for any TV show that has an episode with an air date in the next 7 days.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/vC324sdfcS313vh9QXwijLIHPJp.jpg",
"popularity": 47.432451,
"id": 31917,
"backdrop_path": "/rQGBjWNveVeF8f2PGRtS85w9o9r.jpg",
"vote_average": 5.04,
"overview": "Based on the Pretty Little Liars series of young adult novels by Sara Shepard, the series follows the lives of four girls — Spencer, Hanna, Aria, and Emily — whose clique falls apart after the disappearance of their queen bee, Alison. One year later, they begin receiving messages from someone using the name \"A\" who threatens to expose their secrets — including long-hidden ones they thought only Alison knew.",
"first_air_date": "2010-06-08",
"origin_country": [
"US"
],
"genre_ids": [
18,
9648
],
"original_language": "en",
"vote_count": 133,
"name": "Pretty Little Liars",
"original_name": "Pretty Little Liars"
},
{
"poster_path": "/esN3gWb1P091xExLddD2nh4zmi3.jpg",
"popularity": 37.882356,
"id": 62560,
"backdrop_path": "/v8Y9yurHuI7MujWQMd8iL3Gy4B5.jpg",
"vote_average": 7.5,
"overview": "A contemporary and culturally resonant drama about a young programmer, Elliot, who suffers from a debilitating anti-social disorder and decides that he can only connect to people by hacking them. He wields his skills as a weapon to protect the people that he cares about. Elliot will find himself in the intersection between a cybersecurity firm he works for and the underworld organizations that are recruiting him to bring down corporate America.",
"first_air_date": "2015-05-27",
"origin_country": [
"US"
],
"genre_ids": [
80,
18
],
"original_language": "en",
"vote_count": 287,
"name": "Mr. Robot",
"original_name": "Mr. Robot"
}
],
"total_results": 192,
"total_pages": 10
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/season/{season_id}/changes": {
"parameters": [
{
"name": "season_id",
"in": "path",
"required": true,
"type": "integer"
}
],
"get": {
"operationId": "get-tv-season-changes",
"summary": "Get Changes",
"tags": [
"TV Seasons"
],
"description": "Get the changes for a TV season. By default only the last 24 hours are returned.\n\nYou can query up to 14 days in a single query by using the `start_date` and `end_date` query parameters.",
"parameters": [
{
"$ref": "#/parameters/trait:startDateParam:start_date"
},
{
"$ref": "#/parameters/trait:endDateParam:end_date"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/change-details"
},
"examples": {
"application/json": {
"changes": [
{
"key": "episode",
"items": [
{
"id": "5717c8c69251414cfd00250f",
"action": "updated",
"time": "2016-04-20 18:21:58 UTC",
"value": {
"episode_id": 63056,
"episode_number": 1
}
},
{
"id": "5717c90dc3a3686cb7001dd5",
"action": "updated",
"time": "2016-04-20 18:23:09 UTC",
"value": {
"episode_id": 63057,
"episode_number": 2
}
},
{
"id": "5717c917c3a3686c83001bb4",
"action": "updated",
"time": "2016-04-20 18:23:19 UTC",
"value": {
"episode_id": 63058,
"episode_number": 3
}
}
]
},
{
"key": "air_date",
"items": [
{
"id": "5717cfefc3a3686c83001cb1",
"action": "updated",
"time": "2016-04-20 18:52:31 UTC",
"value": "2011-04-16",
"original_value": "2011-04-17"
},
{
"id": "5717cffa9251413d3000345d",
"action": "updated",
"time": "2016-04-20 18:52:42 UTC",
"value": "2011-04-16",
"original_value": "2011-04-17"
}
]
},
{
"key": "name",
"items": [
{
"id": "5717cfefc3a3686c83001cb2",
"action": "added",
"time": "2016-04-20 18:52:31 UTC",
"iso_639_1": "pt",
"value": "Season 1"
},
{
"id": "5717cffa9251413d3000345e",
"action": "deleted",
"time": "2016-04-20 18:52:42 UTC",
"iso_639_1": "pt",
"original_value": "Season 1"
}
]
},
{
"key": "overview",
"items": [
{
"id": "5717cfefc3a3686c83001cb3",
"action": "added",
"time": "2016-04-20 18:52:31 UTC",
"iso_639_1": "pt",
"value": "A nobre Casa Stark, liderada pelo lorde Eddard Stark se vê em meio de um esquema de traição ao rei Robert Baratheon quando a mão do rei, Jon Arryn, morre misteriosamente."
},
{
"id": "571f26aac3a368352f001db4",
"action": "updated",
"time": "2016-04-26 08:28:26 UTC",
"iso_639_1": "zh",
"value": "本剧第一季内容主要聚焦于冰与火之歌系列小说第一部《权力的游戏》。\n\n故事从维斯特洛大陆边境处发现远古传说中早已灭绝的生物开始，预示着危险即将到来。而这片大陆的临冬城主暨北境统领艾德史塔克家族也迎来了老友兼国王劳勃·拜拉席恩的来访。国王希望艾德·史塔克（肖恩·宾 Sean Bean 饰）能担任首相一职，对抗企图夺取铁王座的叛军。危情一触即发，整个王国看似平和的表面下却是波涛暗涌。权高位重的拜拉席恩家族、勇敢善良的史塔克家族、企图谋取王位的坦格利安家族、有着不可告人秘密的兰尼斯特家族。这些家族各怀鬼胎，国王的意外身亡，使国家马上陷入无尽的战乱之中。",
"original_value": "本剧第一季内容主要聚焦于冰与火之歌系列小说第一部《权力的游戏》。\n\n故事从维斯特洛大陆边境处发现远古传说中早已灭绝的生物开始，预示着危险即将到来。而这片大陆的临冬城主暨北境统领艾德史塔克家族也迎来了老友兼国王劳勃·拜拉席恩的来访。国王希望艾德·史塔克（肖恩·宾 Sean Bean 饰）能担任首相一职，对抗企图夺取铁王座的叛军。危情一触即发，整个王国看似平和的表面下却是波涛暗涌。权高位重的拜拉席恩家族、勇敢善良的史塔克家族、企图谋取王位的坦格利安家族、有着不可告人秘密的兰尼斯特家族。这些家族各怀鬼胎，国王的意外身亡，使国家马上陷入无尽的战乱之中……"
}
]
}
]
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
},
"/tv/top_rated": {
"get": {
"operationId": "get-tv-top-rated-paginated",
"summary": "Get Top Rated",
"tags": [
"TV"
],
"description": "Get a list of the top rated TV shows on TMDb.",
"parameters": [
{
"$ref": "#/parameters/trait:languageParam:language"
},
{
"$ref": "#/parameters/trait:pageParam:page"
}
],
"responses": {
"200": {
"description": "",
"schema": {
"$ref": "#/definitions/tv-paginated"
},
"examples": {
"application/json": {
"page": 1,
"results": [
{
"poster_path": "/tfdiVvJkYMbUOXDWibPjzu5dY6S.jpg",
"popularity": 1.722162,
"id": 604,
"backdrop_path": "/hHwEptckXUwZM7XO2lxZ8w8upuU.jpg",
"vote_average": 8.17,
"overview": "Teen Titans is an American animated television series based on the DC Comics characters of the same name, primarily the run of stories by Marv Wolfman and George Pérez in the early-1980s The New Teen Titans comic book series. The show was created by Glen Murakami, developed by David Slack, and produced by Warner Bros. Animation. It premiered on Cartoon Network on July 19, 2003 with the episode \"Divide and Conquer\" and the final episode \"Things Change\" aired on January 16, 2006, with the film Teen Titans: Trouble in Tokyo serving as the series finale. A comic book series, Teen Titans Go!, was based on the TV series. On June 8, 2012, it was announced that the series would be revived as Teen Titans Go! in April 23, 2013 and air on the DC Nation block.IT now airs on the Boomerang channel. ",
"first_air_date": "2003-07-19",
"origin_country": [
"US"
],
"genre_ids": [
16,
10759
],
"original_language": "en",
"vote_count": 12,
"name": "Teen Titans",
"original_name": "Teen Titans"
},
{
"poster_path": "/utOLkQhxuhwN3PN0UEPnfhJnkrf.jpg",
"popularity": 1.530522,
"id": 2085,
"backdrop_path": "/mzpeRh7Wu9mP3s9EdsbNMaGsykP.jpg",
"vote_average": 8.16,
"overview": "Courage the Cowardly Dog is an American comedy horror animated television series created by John R. Dilworth for Cartoon Network. Its central plot revolves around a somewhat anthropomorphic pink/purple dog named Courage who lives with his owners, Muriel and Eustace Bagge, an elderly, married farming couple in the \"Middle of Nowhere\". Courage and his owners are frequently thrown into bizarre misadventures, often involving the paranormal/supernatural and various villains. The show is known for its surreal, often disquieting humor and bizarre plot twists. The series combines elements of comedy horror, science fantasy, and drama.\n\nThe program originated from a short on Cartoon Network's animation showcase series created by Hanna-Barbera president Fred Seibert, \"What a Cartoon!\" titled \"The Chicken from Outer Space\". The segment was nominated for an Academy Award in 1996, and Cartoon Network commissioned a series based on the short. The series, which premiered on November 12, 1999, ran for four seasons, ending on November 22, 2002 with a total of 52 episodes produced. The series was the sixth and final series to be spun off from World Premiere Toons, and it was the eighth series to fall under the Cartoon Cartoons label.",
"first_air_date": "1999-11-12",
"origin_country": [
"US"
],
"genre_ids": [
10765,
16,
9648,
35
],
"original_language": "en",
"vote_count": 19,
"name": "Coraje, El Perro Cobarde",
"original_name": "Coraje, El Perro Cobarde"
}
],
"total_results": 747,
"total_pages": 38
}
}
},
"401": {
"$ref": "#/responses/StatusCodeMsgResponse"
},
"404": {
"$ref": "#/responses/StatusCodeMsgResponse"
}
},
"security": [
{
"api_key": []
}
]
}
}
},
"parameters": {
"trait:accountSortByParam:sort_by": {
"name": "sort_by",
"in": "query",
"description": "Sort the results.",
"type": "string",
"enum": [
"created_at.asc",
"created_at.desc"
]
},
"trait:endDateParam:end_date": {
"name": "end_date",
"in": "query",
"description": "Filter the results with a end date.",
"type": "string",
"format": "date"
},
"trait:appendToResponseParam:append_to_response": {
"name": "append_to_response",
"in": "query",
"description": "Append requests within the same namespace to the response.",
"type": "string",
"pattern": "([\\w]+)"
},
"trait:includeAdultParam:include_adult": {
"name": "include_adult",
"in": "query",
"description": "Choose whether to inlcude adult (pornography) content in the results.",
"type": "boolean",
"default": false
},
"trait:jsonContentType:Content-Type": {
"name": "Content-Type",
"in": "header",
"required": true,
"type": "string",
"default": "application/json;charset=utf-8"
},
"trait:languageParam:include_image_language": {
"name": "include_image_language",
"in": "query",
"description": "Pass a ISO 639-1 value to get additional images (cf. https://developers.themoviedb.org/3/getting-started/image-languages).",
"type": "string",
"minLength": 2,
"pattern": "([a-z]{2})"
},
"trait:languageParam:language": {
"name": "language",
"in": "query",
"description": "Pass a ISO 639-1 value to display translated data for the fields that support it.",
"type": "string",
"minLength": 2,
"pattern": "([a-z]{2})-([A-Z]{2})",
"default": "<<language>>"
},
"trait:listBody": {
"name": "body",
"in": "body",
"schema": {
"$ref": "#/definitions/list-body"
}
},
"trait:mediaFavoriteBody": {
"name": "body",
"in": "body",
"schema": {
"$ref": "#/definitions/media-favorite-body"
}
},
"trait:mediaIdBody": {
"name": "body",
"in": "body",
"schema": {
"$ref": "#/definitions/media-id-body"
}
},
"trait:mediaWatchlistBody": {
"name": "body",
"in": "body",
"schema": {
"$ref": "#/definitions/media-watchlist-body"
}
},
"trait:pageParam:page": {
"name": "page",
"in": "query",
"description": "Specify which page to query.",
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 1
},
"trait:queryParam:query": {
"name": "query",
"in": "query",
"description": "Pass a text query to search. This value should be URI encoded.",
"required": true,
"type": "string",
"minLength": 1
},
"trait:ratingBody": {
"name": "body",
"in": "body",
"schema": {
"$ref": "#/definitions/value-body"
}
},
"trait:regionParam:region": {
"name": "region",
"in": "query",
"description": "Specify a ISO 3166-1 code to filter release dates.",
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"trait:session:session_id": {
"name": "session_id",
"in": "query",
"required": true,
"type": "string",
"default": ""
},
"trait:sessionOrGuestSession:guest_session_id": {
"name": "guest_session_id",
"in": "query",
"type": "string"
},
"trait:sessionOrGuestSession:session_id": {
"name": "session_id",
"in": "query",
"type": "string"
},
"trait:startDateParam:start_date": {
"name": "start_date",
"in": "query",
"description": "Filter the results with a start date.",
"type": "string",
"format": "date"
},
"trait:tokenBody": {
"name": "body",
"in": "body",
"schema": {
"$ref": "#/definitions/access-token-body"
}
}
},
"responses": {
"StatusCodeMsgResponse": {
"description": "",
"schema": {
"$ref": "#/definitions/status-code-message"
},
"examples": {
"application/json": {
"status_code": 200,
"status_message": "The item/record was updated successfully."
}
}
}
},
"definitions": {
"access-token-body": {
"type": "object",
"properties": {
"access_token": {
"type": "string"
}
},
"required": [
"access_token"
],
"example": {
"access_token": "eyK0eXAiOiJAV1QiLCJhbGciOiUIUzI1NiJ9.eyJhdWQiOiI0Ozc2YzA1ZTg4YTY1Yzk0MjFjZDI1NmBiYzRiNGE0NyIsInN1YiI6IjRiYzg4OTJhMDE3YTNjMGY5MjAwMDAwMiIsInNjb3BlayI6WyJhcGlfcmVhZCJdLCL2ZXJzaW9uIjoxfQ.Bn660W0Vi-_AI5HvwIEqtc2s5mAXDknBnTrUREZYH7A"
}
},
"account-details": {
"type": "object",
"properties": {
"avatar": {
"type": "object",
"properties": {
"gravatar": {
"type": "object",
"properties": {
"hash": {
"type": "string"
}
}
}
}
},
"id": {
"type": "integer"
},
"iso_639_1": {
"type": "string"
},
"iso_3166_1": {
"type": "string"
},
"name": {
"type": "string"
},
"include_adult": {
"type": "boolean"
},
"username": {
"type": "string"
}
}
},
"account-states": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"favorite": {
"type": "boolean"
},
"rated": {
"type": [
"object",
"boolean"
]
},
"watchlist": {
"type": "boolean"
}
}
},
"alternative-names-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
},
"alternative-titles-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"titles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"iso_3166_1": {
"type": "string"
},
"title": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
}
}
},
"certification": {
"type": "object",
"properties": {
"certification": {
"type": "string"
},
"meaning": {
"type": "string"
},
"order": {
"type": "integer"
}
}
},
"certifications": {
"type": "object",
"properties": {
"certifications": {
"type": "object",
"properties": {
"US": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"CA": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"DE": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"GB": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"AU": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"BR": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"FR": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"NZ": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
},
"IN": {
"type": "array",
"items": {
"$ref": "#/definitions/certification"
}
}
}
}
}
},
"change-details": {
"type": "object",
"properties": {
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"action": {
"type": "string"
},
"time": {
"type": "string"
},
"iso_639_1": {
"type": "string"
},
"value": {
"type": "string"
},
"original_value": {
"type": "string"
}
}
}
}
}
}
}
}
},
"changes-object": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"adult": {
"type": "boolean"
}
}
},
"changes-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/changes-object"
}
}
}
}
]
},
"collection-part": {
"type": "object",
"properties": {
"adult": {
"type": "boolean"
},
"backdrop_path": {
"$ref": "#/definitions/image-path"
},
"genre_ids": {
"type": "array",
"items": {
"type": "integer"
}
},
"id": {
"type": "integer"
},
"original_language": {
"type": "string"
},
"original_title": {
"type": "string"
},
"overview": {
"type": "string"
},
"release_date": {
"type": "string"
},
"poster_path": {
"type": "string"
},
"popularity": {
"type": "number"
},
"title": {
"type": "string"
},
"video": {
"type": "boolean"
},
"vote_average": {
"type": "number"
},
"vote_count": {
"type": "integer"
}
}
},
"collection-object": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"overview": {
"type": "string"
},
"poster_path": {
"$ref": "#/definitions/image-path"
},
"backdrop_path": {
"type": "string"
},
"parts": {
"type": "array",
"items": {
"$ref": "#/definitions/collection-part"
}
}
}
},
"collection-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/collection-object"
}
}
}
}
]
},
"company-details": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"headquarters": {
"type": "string"
},
"homepage": {
"type": "string"
},
"id": {
"type": "integer"
},
"logo_path": {
"type": "string"
},
"name": {
"type": "string"
},
"origin_country": {
"type": "string"
},
"parent_company": {
"$ref": "#/definitions/company-object"
}
}
},
"company-object": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"id": {
"type": "integer"
},
"logo_path": {
"type": "string"
}
}
},
"company-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/company-object"
}
}
}
}
]
},
"configuration": {
"type": "object",
"properties": {
"images": {
"type": "object",
"properties": {
"base_url": {
"type": "string"
},
"secure_base_url": {
"type": "string"
},
"backdrop_sizes": {
"type": "array",
"items": {
"type": "string"
}
},
"logo_sizes": {
"type": "array",
"items": {
"type": "string"
}
},
"poster_sizes": {
"type": "array",
"items": {
"type": "string"
}
},
"profile_sizes": {
"type": "array",
"items": {
"type": "string"
}
},
"still_sizes": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"change_keys": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"cast": {
"type": "object",
"properties": {
"cast_id": {
"type": "integer"
},
"character": {
"type": "string"
},
"credit_id": {
"type": "string"
},
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"order": {
"type": "integer"
},
"profile_path": {
"$ref": "#/definitions/image-path"
}
}
},
"cast-details": {
"type": "object",
"properties": {
"adult": {
"type": "boolean"
},
"character": {
"type": "string"
},
"credit_id": {
"type": "string"
},
"id": {
"type": "integer"
},
"original_title": {
"type": "string"
},
"poster_path": {
"$ref": "#/definitions/image-path"
},
"release_date": {
"type": "string"
},
"title": {
"type": "string"
},
"media_type": {
"type": "string"
},
"episode_count": {
"type": "integer"
},
"first_air_date": {
"type": "string"
},
"name": {
"type": "string"
},
"original_name": {
"type": "string"
}
}
},
"creator": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"profile_path": {
"$ref": "#/definitions/image-path"
}
}
},
"credit": {
"type": "object",
"properties": {
"credit_type": {
"type": "string"
},
"department": {
"type": "string"
},
"job": {
"type": "string"
},
"media": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"original_name": {
"type": "string"
},
"character": {
"type": "string"
},
"episodes": {
"type": "array",
"items": {
"type": "object"
}
},
"seasons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"air_date": {
"type": "string"
},
"poster_path": {
"type": "string"
},
"season_number": {
"type": "integer"
}
}
}
}
}
},
"media_type": {
"type": "string"
},
"id": {
"type": "string"
},
"person": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"id": {
"type": "integer"
}
}
}
}
},
"credits": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"cast": {
"type": "array",
"items": {
"$ref": "#/definitions/cast"
}
},
"crew": {
"type": "array",
"items": {
"$ref": "#/definitions/crew"
}
},
"guest_stars": {
"type": "array",
"items": {
"$ref": "#/definitions/guest-star"
}
}
}
},
"crew": {
"type": "object",
"properties": {
"credit_id": {
"type": "string"
},
"department": {
"type": "string"
},
"id": {
"type": "integer"
},
"job": {
"type": "string"
},
"name": {
"type": "string"
},
"profile_path": {
"$ref": "#/definitions/image-path"
}
}
},
"crew-details": {
"type": "object",
"properties": {
"adult": {
"type": "boolean"
},
"credit_id": {
"type": "string"
},
"department": {
"type": "string"
},
"id": {
"type": "integer"
},
"job": {
"type": "string"
},
"original_title": {
"type": "string"
},
"poster_path": {
"$ref": "#/definitions/image-path"
},
"release_date": {
"type": "string"
},
"title": {
"type": "string"
},
"media_type": {
"type": "string"
},
"episode_count": {
"type": "integer"
},
"first_air_date": {
"type": "string"
},
"name": {
"type": "string"
},
"original_name": {
"type": "string"
}
}
},
"episode-details": {
"type": "object",
"properties": {
"air_date": {
"type": "string"
},
"crew": {
"type": "array",
"items": {
"$ref": "#/definitions/crew"
}
},
"episode_number": {
"type": "integer"
},
"guest_stars": {
"type": "array",
"items": {
"$ref": "#/definitions/guest-star"
}
},
"name": {
"type": "string"
},
"overview": {
"type": "string"
},
"id": {
"type": "integer"
},
"production_code": {
"type": "string"
},
"season_number": {
"type": "integer"
},
"still_path": {
"$ref": "#/definitions/image-path"
},
"vote_average": {
"type": "number"
},
"vote_count": {
"type": "integer"
},
"changes": {
"$ref": "#/definitions/change-details"
},
"credits": {
"$ref": "#/definitions/credits"
},
"external_ids": {
"$ref": "#/definitions/external-ids"
},
"images": {
"$ref": "#/definitions/images"
},
"translations": {
"$ref": "#/definitions/translations-list"
},
"videos": {
"$ref": "#/definitions/videos-list"
}
}
},
"episode-group-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/episode-group-object"
}
}
}
},
"episode-group-object": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"episode_count": {
"type": "integer"
},
"group_count": {
"type": "integer"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"network": {
"$ref": "#/definitions/network"
},
"type": {
"type": "integer"
}
}
},
"episode-group-details": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"episode_count": {
"type": "integer"
},
"group_count": {
"type": "integer"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"network": {
"$ref": "#/definitions/network"
},
"type": {
"type": "integer"
},
"groups": {
"type": "array",
"items": {
"$ref": "#/definitions/episode-group-group"
}
}
}
},
"episode-group-group": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"order": {
"type": "integer"
},
"locked": {
"type": "boolean"
},
"episodes": {
"type": "array",
"items": {
"$ref": "#/definitions/tv-episode-object"
}
}
}
},
"episode-rating-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"episode_number": {
"type": "integer"
},
"rated": {
"type": [
"boolean",
"object"
],
"properties": {
"value": {
"type": "integer"
}
}
}
}
}
}
}
},
"external-ids": {
"type": "object",
"properties": {
"imdb_id": {
"type": "string"
},
"facebook_id": {
"type": "string"
},
"freebase_mid": {
"type": "string"
},
"freebase_id": {
"type": "string"
},
"tvrage_id": {
"type": "integer"
},
"twitter_id": {
"type": "string"
},
"instagram_id": {
"type": "string"
},
"id": {
"type": "integer"
}
}
},
"find-by-external-id-results": {
"type": "object",
"properties": {
"movie_results": {
"type": "array",
"items": {
"$ref": "#/definitions/movie-object"
}
},
"person_results": {
"type": "array",
"items": {
"$ref": "#/definitions/person-object"
}
},
"tv_results": {
"type": "array",
"items": {
"$ref": "#/definitions/tv-object"
}
},
"tv_episode_results": {
"type": "array",
"items": {
"$ref": "#/definitions/tv-episode-object"
}
},
"tv_season_results": {
"type": "array",
"items": {
"$ref": "#/definitions/season-object"
}
}
}
},
"genre": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
},
"genres-list": {
"type": "object",
"properties": {
"genres": {
"type": "array",
"items": {
"$ref": "#/definitions/genre"
}
}
}
},
"guest-session-response": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"guest_session_id": {
"type": "string"
},
"expires_at": {
"type": "string"
}
}
},
"guest-star": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"credit_id": {
"type": "string"
},
"character": {
"type": "string"
},
"order": {
"type": "integer"
},
"profile_path": {
"$ref": "#/definitions/image-path"
}
}
},
"image": {
"type": "object",
"properties": {
"aspect_ratio": {
"type": "number"
},
"file_path": {
"type": "string"
},
"height": {
"type": "integer"
},
"iso_639_1": {
"type": "string"
},
"vote_average": {
"type": "number"
},
"vote_count": {
"type": "integer"
},
"width": {
"type": "integer"
},
"file_type": {
"type": "string"
}
}
},
"image-path": {
"title": "Image Path",
"type": "string",
"pattern": "^/[A-Za-z0-9]+\\.[A-Za-z0-9]+"
},
"images": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"backdrops": {
"type": "array",
"items": {
"$ref": "#/definitions/image"
}
},
"posters": {
"type": "array",
"items": {
"$ref": "#/definitions/image"
}
},
"logos": {
"type": "array",
"items": {
"$ref": "#/definitions/image"
}
},
"profiles": {
"type": "array",
"items": {
"$ref": "#/definitions/image"
}
}
}
},
"item-status": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"item_present": {
"type": "boolean"
}
}
},
"jobs": {
"type": "object",
"properties": {
"department": {
"type": "string"
},
"jobs": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"keyword": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
}
},
"keyword-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/keyword"
}
}
}
}
]
},
"keywords-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"keywords": {
"type": "array",
"items": {
"$ref": "#/definitions/keyword"
}
}
}
},
"list-body": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"language": {
"type": "string"
}
},
"example": {
"name": "This is my awesome test list.",
"description": "Just an awesome list dawg.",
"language": "en"
}
},
"list-details": {
"type": "object",
"properties": {
"created_by": {
"type": "string"
},
"description": {
"type": "string"
},
"favorite_count": {
"type": "integer"
},
"id": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"$ref": "#/definitions/movie-object"
}
},
"item_count": {
"type": "integer"
},
"iso_639_1": {
"type": "string"
},
"name": {
"type": "string"
},
"poster_path": {
"$ref": "#/definitions/image-path"
}
}
},
"list-object": {
"type": "object",
"properties": {
"description": {
"type": "string"
},
"favorite_count": {
"type": "integer"
},
"id": {
"type": "string"
},
"item_count": {
"type": "integer"
},
"iso_639_1": {
"type": "string"
},
"list_type": {
"type": "string"
},
"name": {
"type": "string"
},
"poster_path": {
"$ref": "#/definitions/image-path"
}
}
},
"list-status-response": {
"type": "object",
"properties": {
"status_message": {
"type": "string"
},
"success": {
"type": "boolean"
},
"status_code": {
"type": "integer"
},
"list_id": {
"type": "integer"
}
}
},
"lists-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/list-object"
}
}
}
},
{
"$ref": "#/definitions/trait:id"
}
]
},
"media-favorite-body": {
"type": "object",
"properties": {
"media_type": {
"$ref": "#/definitions/media-type"
},
"media_id": {
"type": "integer"
},
"favorite": {
"type": "boolean"
}
},
"required": [
"media_type",
"media_id",
"favorite"
],
"example": {
"media_type": "movie",
"media_id": 550,
"favorite": true
}
},
"media-id-body": {
"type": "object",
"properties": {
"media_id": {
"type": "integer",
"minimum": 1
}
},
"required": [
"media_id"
],
"example": {
"media_id": 18
}
},
"media-type": {
"type": "string",
"enum": [
"movie",
"tv",
"person"
]
},
"media-watchlist-body": {
"type": "object",
"properties": {
"media_type": {
"$ref": "#/definitions/media-type"
},
"media_id": {
"type": "integer"
},
"watchlist": {
"type": "boolean"
}
},
"required": [
"media_type",
"media_id",
"watchlist"
],
"example": {
"media_type": "movie",
"media_id": 11,
"watchlist": true
}
},
"movie-details": {
"type": "object",
"properties": {
"adult": {
"type": "boolean"
},
"backdrop_path": {
"$ref": "#/definitions/image-path"
},
"belongs_to_collection": {
"type": "object"
},
"budget": {
"type": "integer"
},
"genres": {
"type": "array",
"items": {
"$ref": "#/definitions/genre"
}
},
"homepage": {
"type": "string"
},
"id": {
"type": "integer"
},
"imdb_id": {
"type": "string",
"minLength": 9,
"maxLength": 9,
"pattern": "^tt[0-9]{7}"
},
"original_language": {
"type": "string"
},
"original_title": {
"type": "string"
},
"overview": {
"type": "string"
},
"popularity": {
"type": "number"
},
"poster_path": {
"$ref": "#/definitions/image-path"
},
"production_companies": {
"type": "array",
"items": {
"$ref": "#/definitions/company-object"
}
},
"production_countries": {
"type": "array",
"items": {
"$ref": "#/definitions/translation"
}
},
"release_date": {
"type": "string",
"format": "date"
},
"revenue": {
"type": "integer"
},
"runtime": {
"type": "integer"
},
"spoken_languages": {
"type": "array",
"items": {
"$ref": "#/definitions/translation"
}
},
"status": {
"type": "string"
},
"tagline": {
"type": "string"
},
"title": {
"type": "string"
},
"video": {
"type": "boolean"
},
"vote_average": {
"type": "number"
},
"vote_count": {
"type": "integer"
},
"alternative_titles": {
"$ref": "#/definitions/alternative-titles-list"
},
"changes": {
"$ref": "#/definitions/change-details"
},
"credits": {
"$ref": "#/definitions/credits"
},
"external_ids": {
"$ref": "#/definitions/external-ids"
},
"images": {
"$ref": "#/definitions/images"
},
"keywords": {
"$ref": "#/definitions/keywords-list"
},
"lists": {
"$ref": "#/definitions/lists-paginated"
},
"recommendations": {
"$ref": "#/definitions/movie-paginated"
},
"release_dates": {
"$ref": "#/definitions/release-dates-list"
},
"reviews": {
"$ref": "#/definitions/reviews-paginated"
},
"similar": {
"$ref": "#/definitions/movie-paginated"
},
"translations": {
"$ref": "#/definitions/translations-list"
},
"videos": {
"$ref": "#/definitions/videos-list"
}
}
},
"movie-paginated": {
"title": "Movie List",
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/movie-object"
}
}
}
},
{
"$ref": "#/definitions/trait:id"
}
]
},
"movie-object": {
"title": "Movie List Result Object",
"type": "object",
"properties": {
"poster_path": {
"$ref": "#/definitions/image-path"
},
"adult": {
"type": "boolean"
},
"overview": {
"type": "string"
},
"release_date": {
"type": "string"
},
"genre_ids": {
"type": "array",
"items": {
"type": "integer"
}
},
"id": {
"type": "integer"
},
"original_title": {
"type": "string"
},
"original_language": {
"type": "string"
},
"title": {
"type": "string"
},
"backdrop_path": {
"$ref": "#/definitions/image-path"
},
"popularity": {
"type": "number"
},
"vote_count": {
"type": "integer"
},
"video": {
"type": "boolean"
},
"vote_average": {
"type": "number"
},
"rating": {
"type": "integer"
},
"media_type": {
"type": "string",
"enum": [
"movie"
]
},
"dates": {
"type": "object",
"properties": {
"maximum": {
"type": "string",
"format": "date"
},
"minimum": {
"type": "string",
"format": "date"
}
}
}
},
"required": [
"media_type"
]
},
"network": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"logo_path": {
"type": "string"
},
"origin_country": {
"type": "string"
}
}
},
"person-credits": {
"type": "object",
"properties": {
"cast": {
"type": "array",
"items": {
"$ref": "#/definitions/cast-details"
}
},
"crew": {
"type": "array",
"items": {
"$ref": "#/definitions/crew-details"
}
},
"id": {
"type": "integer"
}
}
},
"person-details": {
"type": "object",
"properties": {
"adult": {
"type": "boolean"
},
"also_known_as": {
"type": "array",
"items": {
"type": "object"
}
},
"biography": {
"type": "string"
},
"birthday": {
"type": "string"
},
"deathday": {
"type": "string"
},
"gender": {
"type": "integer"
},
"homepage": {
"type": "string"
},
"id": {
"type": "integer"
},
"imdb_id": {
"type": "string"
},
"name": {
"type": "string"
},
"place_of_birth": {
"type": "string"
},
"popularity": {
"type": "number"
},
"profile_path": {
"$ref": "#/definitions/image-path"
},
"changes": {
"$ref": "#/definitions/change-details"
},
"combined_credits": {
"$ref": "#/definitions/person-credits"
},
"external_ids": {
"$ref": "#/definitions/external-ids"
},
"images": {
"$ref": "#/definitions/images"
},
"movie_credits": {
"$ref": "#/definitions/person-credits"
},
"tagged_images": {
"$ref": "#/definitions/person-tagged-images-paginated"
},
"translations": {
"$ref": "#/definitions/translations-list"
},
"tv_credits": {
"$ref": "#/definitions/person-credits"
}
}
},
"person-object": {
"title": "Person List Results Object",
"type": "object",
"properties": {
"profile_path": {
"$ref": "#/definitions/image-path"
},
"adult": {
"type": "boolean"
},
"id": {
"type": "integer"
},
"known_for": {
"type": "array",
"items": {
"oneOf": [
{
"$ref": "#/definitions/movie-object"
},
{
"$ref": "#/definitions/tv-object"
}
]
}
},
"name": {
"type": "string"
},
"popularity": {
"type": "number"
},
"media_type": {
"type": "string",
"enum": [
"person"
]
}
},
"required": [
"media_type"
]
},
"person-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/person-object"
}
}
}
}
]
},
"person-tagged-images-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/tagged-image"
}
}
}
},
{
"$ref": "#/definitions/trait:id"
}
]
},
"ratings-list": {
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"iso_3166_1": {
"type": "string"
},
"rating": {
"type": "string"
}
}
}
},
"id": {
"type": "integer"
}
}
},
"release-date": {
"type": "object",
"properties": {
"certification": {
"type": "string"
},
"iso_639_1": {
"type": "string"
},
"note": {
"type": "string"
},
"release_date": {
"type": "string"
},
"type": {
"type": "integer"
}
}
},
"release-dates-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"iso_3166_1": {
"type": "string"
},
"release_dates": {
"type": "array",
"items": {
"$ref": "#/definitions/release-date"
}
}
}
}
}
}
},
"review": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"author": {
"type": "string"
},
"content": {
"type": "string"
},
"iso_639_1": {
"type": "string"
},
"media_id": {
"type": "integer"
},
"media_title": {
"type": "string"
},
"media_type": {
"type": "string"
},
"url": {
"type": "string"
}
}
},
"review-object": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"author": {
"type": "string"
},
"content": {
"type": "string"
},
"url": {
"type": "string"
}
}
},
"reviews-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/review-object"
}
}
}
},
{
"$ref": "#/definitions/trait:id"
}
]
},
"search-multi-results-paginated": {
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"oneOf": [
{
"$ref": "#/definitions/movie-object"
},
{
"$ref": "#/definitions/tv-object"
},
{
"$ref": "#/definitions/person-object"
}
]
}
}
}
}
]
},
"season-details": {
"type": "object",
"properties": {
"_id": {
"type": "string"
},
"air_date": {
"type": "string"
},
"episodes": {
"type": "array",
"items": {
"$ref": "#/definitions/episode-details"
}
},
"name": {
"type": "string"
},
"overview": {
"type": "string"
},
"id": {
"type": "integer"
},
"poster_path": {
"$ref": "#/definitions/image-path"
},
"season_number": {
"type": "integer"
},
"changes": {
"$ref": "#/definitions/change-details"
},
"credits": {
"$ref": "#/definitions/credits"
},
"external_ids": {
"$ref": "#/definitions/external-ids"
},
"images": {
"$ref": "#/definitions/images"
},
"videos": {
"$ref": "#/definitions/videos-list"
}
}
},
"season-episode-ids": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"season_id": {
"type": "integer"
},
"episode_id": {
"type": "integer"
}
}
},
"season-episode-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/season-episode-ids"
}
}
}
},
"season-object": {
"type": "object",
"properties": {
"air_date": {
"type": "string"
},
"episode_count": {
"type": "integer"
},
"id": {
"type": "integer"
},
"poster_path": {
"type": "string"
},
"season_number": {
"type": "integer"
}
}
},
"session-response": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"session_id": {
"type": "string"
}
}
},
"status-code-message": {
"type": "object",
"properties": {
"status_code": {
"type": "integer"
},
"status_message": {
"type": "string"
}
}
},
"success-response": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
}
}
},
"tagged-image": {
"allOf": [
{
"$ref": "#/definitions/image"
},
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"image_type": {
"type": "string"
},
"media": {
"oneOf": [
{
"$ref": "#/definitions/movie-object"
},
{
"$ref": "#/definitions/tv-object"
}
]
},
"media_type": {
"type": "string"
}
}
}
]
},
"timezones": {
"type": "object",
"properties": {
"iso_3166_1": {
"type": "string"
},
"zones": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"token-response-with-expiration": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"expires_at": {
"type": "string"
},
"request_token": {
"type": "string"
}
}
},
"token-response": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"request_token": {
"type": "string"
}
}
},
"trait:id": {
"type": "object",
"properties": {
"id": {
"type": "integer"
}
}
},
"trait:paginated": {
"type": "object",
"properties": {
"page": {
"type": "integer"
},
"total_pages": {
"type": "integer"
},
"total_results": {
"type": "integer"
}
}
},
"translation": {
"type": "object",
"properties": {
"iso_639_1": {
"type": "string"
},
"iso_3166_1": {
"type": "string"
},
"name": {
"type": "string"
},
"english_name": {
"type": "string"
},
"data": {
"$ref": "#/definitions/translation-data"
}
}
},
"translation-data": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"name": {
"type": "string"
},
"overview": {
"type": "string"
},
"homepage": {
"type": "string"
}
}
},
"translations-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"translations": {
"type": "array",
"items": {
"$ref": "#/definitions/translation"
}
}
}
},
"tv-details": {
"type": "object",
"properties": {
"backdrop_path": {
"$ref": "#/definitions/image-path"
},
"created_by": {
"type": "array",
"items": {
"$ref": "#/definitions/creator"
}
},
"episode_run_time": {
"type": "array",
"items": {
"type": "integer"
}
},
"first_air_date": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"$ref": "#/definitions/genre"
}
},
"homepage": {
"type": "string"
},
"id": {
"type": "integer"
},
"in_production": {
"type": "boolean"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"last_air_date": {
"type": "string"
},
"name": {
"type": "string"
},
"networks": {
"type": "array",
"items": {
"$ref": "#/definitions/network"
}
},
"number_of_episodes": {
"type": "integer"
},
"number_of_seasons": {
"type": "integer"
},
"origin_country": {
"type": "array",
"items": {
"type": "string"
}
},
"original_language": {
"type": "string"
},
"original_name": {
"type": "string"
},
"overview": {
"type": "string"
},
"popularity": {
"type": "number"
},
"poster_path": {
"$ref": "#/definitions/image-path"
},
"production_companies": {
"type": "array",
"items": {
"$ref": "#/definitions/company-object"
}
},
"seasons": {
"type": "array",
"items": {
"$ref": "#/definitions/season-object"
}
},
"status": {
"type": "string"
},
"type": {
"type": "string"
},
"vote_average": {
"type": "number"
},
"vote_count": {
"type": "integer"
},
"alternative_titles": {
"$ref": "#/definitions/alternative-titles-list"
},
"changes": {
"$ref": "#/definitions/change-details"
},
"content_ratings": {
"$ref": "#/definitions/ratings-list"
},
"credits": {
"$ref": "#/definitions/credits"
},
"episode_groups": {
"$ref": "#/definitions/episode-group-list"
},
"external_ids": {
"$ref": "#/definitions/external-ids"
},
"images": {
"$ref": "#/definitions/images"
},
"keywords": {
"$ref": "#/definitions/keywords-list"
},
"lists": {
"$ref": "#/definitions/lists-paginated"
},
"recommendations": {
"$ref": "#/definitions/tv-paginated"
},
"release_dates": {
"$ref": "#/definitions/release-dates-list"
},
"reviews": {
"$ref": "#/definitions/reviews-paginated"
},
"screened_theatrically": {
"$ref": "#/definitions/season-episode-list"
},
"similar": {
"$ref": "#/definitions/tv-paginated"
},
"translations": {
"$ref": "#/definitions/translations-list"
},
"videos": {
"$ref": "#/definitions/videos-list"
}
}
},
"tv-episodes-paginated": {
"title": "Account rated TV episodes",
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/tv-episode-object"
}
}
}
}
]
},
"tv-episode-object": {
"type": "object",
"properties": {
"_id": {
"type": "string"
},
"air_date": {
"type": "string"
},
"episode_number": {
"type": "integer"
},
"name": {
"type": "string"
},
"id": {
"type": "integer"
},
"season_number": {
"type": "integer"
},
"still_path": {
"type": "string"
},
"show_id": {
"type": "integer"
},
"vote_average": {
"type": "number"
},
"vote_count": {
"type": "integer"
},
"rating": {
"type": "integer"
}
}
},
"tv-paginated": {
"title": "TV List paginated result",
"allOf": [
{
"$ref": "#/definitions/trait:paginated"
},
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/tv-object"
}
}
}
},
{
"$ref": "#/definitions/trait:id"
}
]
},
"tv-object": {
"title": "TV List Result Object",
"type": "object",
"properties": {
"poster_path": {
"$ref": "#/definitions/image-path"
},
"popularity": {
"type": "number"
},
"id": {
"type": "integer"
},
"backdrop_path": {
"$ref": "#/definitions/image-path"
},
"vote_average": {
"type": "number"
},
"overview": {
"type": "string"
},
"first_air_date": {
"type": "string"
},
"origin_country": {
"type": "array",
"items": {
"type": "string"
}
},
"genre_ids": {
"type": "array",
"items": {
"type": "integer"
}
},
"original_language": {
"type": "string"
},
"vote_count": {
"type": "integer"
},
"name": {
"type": "string"
},
"original_name": {
"type": "string"
},
"rating": {
"type": "integer"
},
"media_type": {
"type": "string",
"enum": [
"tv"
]
}
},
"required": [
"media_type"
]
},
"value-body": {
"type": "object",
"properties": {
"value": {
"type": "number",
"minimum": 0.5,
"maximum": 10,
"description": "This is the value of the rating you want to submit. The value is expected to be between 0.5 and 10.0."
}
},
"required": [
"value"
],
"example": {
"value": 8.5
}
},
"video": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"iso_639_1": {
"type": "string"
},
"iso_3166_1": {
"type": "string"
},
"key": {
"type": "string"
},
"name": {
"type": "string"
},
"site": {
"type": "string"
},
"size": {
"type": "integer"
},
"type": {
"type": "string",
"enum": [
"Trailer",
"Teaser",
"Clip",
"Featurette",
"Opening Credits"
]
}
}
},
"videos-list": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/video"
}
}
}
}
}
}