{ "swagger": "2.0", "info": { "title": "Rotten Tomatoes", "version": "1.0", "contact": { "name": "Mike Ralphson", "email": "mike.ralphson@gmail.com", "url": "https://github.com/mermade/mashery2openapi" }, "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" }, "description": "Test our API services using I/O Docs.", "x-mashery-id": "1217" }, "schemes": [ "http" ], "host": "api.rottentomatoes.com", "basePath": "/api/public/v1.0", "externalDocs": { "description": "You can also view our written documentation.", "url": "http://developer.rottentomatoes.com/io-docs/docs" }, "consumes": [ "application/json" ], "produces": [ "application/json" ], "securityDefinitions": { "key": { "type": "apiKey", "name": "apikey", "in": "query" } }, "security": [ { "key": [] } ], "tags": [ { "name": "Movie Lists" }, { "name": "DVD Lists" }, { "name": "Detailed Info" }, { "name": "Search" }, { "name": "Top Level Lists" } ], "paths": { "/lists/movies/box_office.json": { "get": { "operationId": "BoxOfficeMovieLists", "summary": "", "tags": [ "Movie Lists" ], "parameters": [ { "name": "limit", "type": "string", "description": "Limits the number of movies returned", "in": "query", "required": false, "default": "16" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/movies/in_theaters.json": { "get": { "operationId": "InTheatersMovieLists", "summary": "", "tags": [ "Movie Lists" ], "parameters": [ { "name": "page_limit", "type": "string", "description": "The amount of movies in theaters to show per page", "in": "query", "required": false, "default": "16" }, { "name": "page", "type": "string", "description": "The selected page of in theaters movies", "in": "query", "required": false, "default": "1" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/movies/opening.json": { "get": { "operationId": "OpeningMoviesMovieLists", "summary": "", "tags": [ "Movie Lists" ], "parameters": [ { "name": "limit", "type": "string", "description": "Limits the number of opening movies returned", "in": "query", "required": false, "default": "16" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/movies/upcoming.json": { "get": { "operationId": "UpcomingMoviesMovieLists", "summary": "", "tags": [ "Movie Lists" ], "parameters": [ { "name": "page_limit", "type": "string", "description": "The amount of upcoming movies to show per page", "in": "query", "required": false, "default": "16" }, { "name": "page", "type": "string", "description": "The selected page of upcoming movies", "in": "query", "required": false, "default": "1" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/dvds/top_rentals.json": { "get": { "operationId": "TopRentalsDVDLists", "summary": "", "tags": [ "DVD Lists" ], "parameters": [ { "name": "limit", "type": "string", "description": "Limits the number of top rentals returned", "in": "query", "required": false, "default": "10" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/dvds/current_releases.json": { "get": { "operationId": "CurrentReleaseDVDsDVDLists", "summary": "", "tags": [ "DVD Lists" ], "parameters": [ { "name": "page_limit", "type": "string", "description": "The amount of new release dvds to show per page", "in": "query", "required": false, "default": "16" }, { "name": "page", "type": "string", "description": "The selected page of current DVD releases", "in": "query", "required": false, "default": "1" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/dvds/new_releases.json": { "get": { "operationId": "NewReleaseDVDsDVDLists", "summary": "", "tags": [ "DVD Lists" ], "parameters": [ { "name": "page_limit", "type": "string", "description": "The amount of new release dvds to show per page", "in": "query", "required": false, "default": "16" }, { "name": "page", "type": "string", "description": "The selected page of new release DVDs", "in": "query", "required": false, "default": "1" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/dvds/upcoming.json": { "get": { "operationId": "UpcomingDVDsDVDLists", "summary": "", "tags": [ "DVD Lists" ], "parameters": [ { "name": "page_limit", "type": "string", "description": "The amount of upcoming dvds to show per page", "in": "query", "required": false, "default": "16" }, { "name": "page", "type": "string", "description": "The selected page of upcoming DVDs", "in": "query", "required": false, "default": "1" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movies/{id}.json": { "get": { "operationId": "MoviesInfoDetailedInfo", "summary": "", "tags": [ "Detailed Info" ], "parameters": [ { "name": "id", "type": "string", "description": "Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID", "in": "path", "required": true, "default": "770672122" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movies/{id}/cast.json": { "get": { "operationId": "CastInfoDetailedInfo", "summary": "", "tags": [ "Detailed Info" ], "parameters": [ { "name": "id", "type": "string", "description": "Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID", "in": "path", "required": true, "default": "770672122" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movies/{id}/clips.json": { "get": { "operationId": "MovieClipsDetailedInfo", "summary": "", "tags": [ "Detailed Info" ], "parameters": [ { "name": "id", "type": "string", "description": "Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID", "in": "path", "required": true, "default": "770672122" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movies/{id}/reviews.json": { "get": { "operationId": "MoviesReviewsDetailedInfo", "summary": "", "tags": [ "Detailed Info" ], "parameters": [ { "name": "id", "type": "string", "description": "Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID", "in": "path", "required": true, "default": "770672122" }, { "name": "review_type", "type": "string", "description": "3 different review types are possible: 'all', 'top_critic' and 'dvd'. 'top_critic' shows all the Rotten Tomatoes designated top critics. 'dvd' pulls the reviews given on the DVD of the movie. 'all' as the name implies retrieves all reviews.", "in": "query", "required": false, "default": "top_critic" }, { "name": "page_limit", "type": "string", "description": "The number of reviews to show per page", "in": "query", "required": false, "default": "20" }, { "name": "page", "type": "string", "description": "The selected page of reviews", "in": "query", "required": false, "default": "1" }, { "name": "country", "type": "string", "description": "Provides localized data for the selected country (ISO 3166-1 alpha-2) if available. Otherwise, returns US data.", "in": "query", "required": false, "default": "us" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movies/{id}/similar.json": { "get": { "operationId": "MoviesSimilarDetailedInfo", "summary": "", "tags": [ "Detailed Info" ], "parameters": [ { "name": "id", "type": "string", "description": "Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID", "in": "path", "required": true, "default": "770672122" }, { "name": "limit", "type": "string", "description": "Limit the number of similar movies to show", "in": "query", "required": false, "default": "5" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movie_alias.json": { "get": { "operationId": "MoviesAliasDetailedInfo", "summary": "", "tags": [ "Detailed Info" ], "parameters": [ { "name": "id", "type": "string", "description": "Movie ID. You can use the movies search endpoint or peruse the lists of movies/dvds to get the Movie ID", "in": "query", "required": false, "default": "0031381" }, { "name": "type", "type": "string", "description": "Only supports imdb lookup at this time", "in": "query", "required": false, "default": "imdb" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/movies.json": { "get": { "operationId": "MoviesSearchSearch", "summary": "", "tags": [ "Search" ], "parameters": [ { "name": "q", "type": "string", "description": "The plain text search query to search for a movie. Remember to URI encode this!", "in": "query", "required": false }, { "name": "page_limit", "type": "string", "description": "The amount of movie search results to show per page", "in": "query", "required": false, "default": "10" }, { "name": "page", "type": "string", "description": "The selected page of movie search results", "in": "query", "required": false, "default": "1" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists.json": { "get": { "operationId": "ListsDirectoryTopLevelLists", "summary": "", "tags": [ "Top Level Lists" ], "parameters": [], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/movies.json": { "get": { "operationId": "MovieListsDirectoryTopLevelLists", "summary": "", "tags": [ "Top Level Lists" ], "parameters": [], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } }, "/lists/dvds.json": { "get": { "operationId": "DVDListsDirectoryTopLevelLists", "summary": "", "tags": [ "Top Level Lists" ], "parameters": [], "responses": { "200": { "description": "Success" }, "400": { "description": "Bad Request" }, "403": { "description": "Forbidden" } } } } }, "definitions": {} }