What's on? API to retrieve movies and tv shows information
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"18186487","collectionId":"31fb401b-ec70-42ba-828d-60f0aeab1afa","publishedId":"2s9Ykhg4MB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"28A745"},"publishDate":"2024-08-22T14:17:14.000Z"},"item":[{"name":"GET /","item":[{"name":"Retrieve movies or tv shows information","id":"0b8537c4-c567-409d-82bc-7e00ce6d21e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://whatson-api.onrender.com/?ratings_filters=allocine_critics,allocine_users,betaseries_users,imdb_users,metacritic_critics,metacritic_users,rottentomatoes_critics,rottentomatoes_users,letterboxd_users,senscritique_users,tmdb_users,trakt_users,tvtime_users&popularity_filters=allocine_popularity,imdb_popularity,tmdb_popularity&item_type=movie,tvshow&is_active=true,false&append_to_response=awards,critics_rating_details,directors,episodes_details,genres,highest_episode,last_episode,lowest_episode,networks,next_episode,platforms_links,production_companies,certification_variants,image_variants,title_variants,parents_guide&page=This endpoint retrieves detailed information about either a movie or a tv show based on the provided query parameters
\n","urlObject":{"path":[""],"host":["https://whatson-api.onrender.com"],"query":[{"description":{"content":"Ratings filters source (or all for every values)
\n","type":"text/plain"},"key":"ratings_filters","value":"allocine_critics,allocine_users,betaseries_users,imdb_users,metacritic_critics,metacritic_users,rottentomatoes_critics,rottentomatoes_users,letterboxd_users,senscritique_users,tmdb_users,trakt_users,tvtime_users"},{"description":{"content":"Popularity filters source (use all for all values, none to disable)
\n","type":"text/plain"},"key":"popularity_filters","value":"allocine_popularity,imdb_popularity,tmdb_popularity"},{"description":{"content":"The type of the item (movie, tvshow or both)
\n","type":"text/plain"},"key":"item_type","value":"movie,tvshow"},{"description":{"content":"Is the item currently on screens (true, false or both)
\n","type":"text/plain"},"key":"is_active","value":"true,false"},{"description":{"content":"Should we return specific keys in the response
\n","type":"text/plain"},"key":"append_to_response","value":"awards,critics_rating_details,directors,episodes_details,genres,highest_episode,last_episode,lowest_episode,networks,next_episode,platforms_links,production_companies,certification_variants,image_variants,title_variants,parents_guide"},{"description":{"content":"Page number
\n","type":"text/plain"},"key":"page","value":"Page items limit
\n","type":"text/plain"},"key":"limit","value":"Is the item marked as adult content (true, false or both)
\n","type":"text/plain"},"key":"is_adult","value":"true,false"},{"disabled":true,"description":{"content":"Is the item a Metacritic must see (true, false or both)
\n","type":"text/plain"},"key":"must_see","value":"true,false"},{"disabled":true,"description":{"content":"Has the item received the Rotten Tomatoes \"Verified Audience\" certification (true, false or both)
\n","type":"text/plain"},"key":"users_certified","value":"true,false"},{"disabled":true,"description":{"content":"Has the item received the Rotten Tomatoes \"Certified Fresh\" status from critics (true, false or both)
\n","type":"text/plain"},"key":"critics_certified","value":"true,false"},{"disabled":true,"description":{"content":"Minimum ratings to return
\n","type":"text/plain"},"key":"minimum_ratings","value":"Use new for recent items or from:/to: with yyyy-mm-dd to set an inclusive date range
Filter items by runtime in seconds (one value for exact match or two values for an inclusive range)
\n","type":"text/plain"},"key":"runtime","value":"1800,5400"},{"disabled":true,"description":{"content":"Number of seasons (5 means 5+) (only valid for tvshows)
\n","type":"text/plain"},"key":"seasons_number","value":"1,2,3,4,5"},{"disabled":true,"description":{"content":"TV show's status (only valid for tvshows)
\n","type":"text/plain"},"key":"status","value":"canceled,ended,ongoing,pilot,unknown"},{"disabled":true,"description":{"content":"Directors (or all for every value)
\n","type":"text/plain"},"key":"directors","value":"Genres (or all for every value)
\n","type":"text/plain"},"key":"genres","value":"Platforms links (or all for every value)
\n","type":"text/plain"},"key":"platforms","value":"Networks (or all for every value)
\n","type":"text/plain"},"key":"networks","value":"Production companies (or all for every value)
\n","type":"text/plain"},"key":"production_companies","value":"Filter episodes by one or more seasons
\n","type":"text/plain"},"key":"filtered_seasons","value":"Sort by IMDb top ranking. asc shows #1 first, desc shows #1 last; only ranked items.
Sort by Box Office Mojo rank. asc shows #1 first, desc shows #1 last; only ranked items.
The query parameters provided below are solely for item search purposes and must be unique.
\n","urlObject":{"path":[""],"host":["https://whatson-api.onrender.com"],"query":[{"description":{"content":"The Movie Database ID of the movie or tvshow
\n","type":"text/plain"},"key":"tmdbId","value":"249042"},{"description":{"content":"Should we return specific keys in the response
\n","type":"text/plain"},"key":"append_to_response","value":"awards,critics_rating_details,directors,episodes_details,genres,highest_episode,last_episode,lowest_episode,networks,next_episode,platforms_links,production_companies,certification_variants,image_variants,title_variants,parents_guide"},{"disabled":true,"description":{"content":"Title of the movie or tvshow (also matches original_title and localized title_variants)
AlloCiné ID of the movie or tvshow
\n","type":"text/plain"},"key":"allocineId","value":"BetaSeries ID of the movie or tvshow
\n","type":"text/plain"},"key":"betaseriesId","value":"IMDb ID of the movie or tvshow
\n","type":"text/plain"},"key":"imdbId","value":"Letterboxd ID of the movie
\n","type":"text/plain"},"key":"letterboxdId","value":"Metacritic ID of the movie or tvshow
\n","type":"text/plain"},"key":"metacriticId","value":"Rotten Tomatoes ID of the movie or tvshow
\n","type":"text/plain"},"key":"rottentomatoesId","value":"SensCritique ID of the movie or tvshow
\n","type":"text/plain"},"key":"senscritiqueId","value":"Trakt ID of the movie or tvshow
\n","type":"text/plain"},"key":"traktId","value":"TV Time ID of the tvshow
\n","type":"text/plain"},"key":"tvtimeId","value":"TheTVDB ID of the movie or tvshow
\n","type":"text/plain"},"key":"thetvdbId","value":"Filter episodes by one or more seasons
\n","type":"text/plain"},"key":"filtered_seasons","value":"Browse items with filters or search for a single unique item through query parameters.
\n","_postman_id":"0ab5e6ca-839f-4d63-99e4-66b5b9b410ba"},{"name":"GET /episodes/rated","item":[{"name":"Retrieve rated episodes","id":"4b49b6e5-984a-4963-97cf-d584747f4570","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://whatson-api.onrender.com/episodes/rated?order=asc,desc&minimum_ratings=Returns the highest or lowest rated episodes across all tvshows combined.
\n","urlObject":{"path":["episodes","rated"],"host":["https://whatson-api.onrender.com"],"query":[{"description":{"content":"desc returns top rated episodes, asc returns lowest rated episodes
Minimum IMDb users rating to return on episodes
\n","type":"text/plain"},"key":"minimum_ratings","value":"Minimum number of IMDb users ratings required for each episode. Defaults to 100 when omitted
Requested page number
\n","type":"text/plain"},"key":"page","value":"Number of rated episodes to return
\n","type":"text/plain"},"key":"limit","value":"Is the tvshow currently active (true, false or both)
Is the tvshow marked as adult content (true, false or both)
Is the tvshow a Metacritic must see (true, false or both)
Has the tvshow received Rotten Tomatoes user certification
\n","type":"text/plain"},"key":"users_certified","value":"true,false"},{"disabled":true,"description":{"content":"Has the tvshow received Rotten Tomatoes critics certification
\n","type":"text/plain"},"key":"critics_certified","value":"true,false"},{"disabled":true,"description":{"content":"Use from:/to: with yyyy-mm-dd to set an inclusive date range
Filter episodes by one or more seasons
\n","type":"text/plain"},"key":"filtered_seasons","value":"Filter tvshows by directors, or use all for every value
Filter tvshows by genres, or use all for every value
Filter tvshows by streaming platforms, or use all for every value
Filter tvshows by networks, or use all for every value
Filter tvshows by production companies, or use all for every value
Filter tvshows by status
\n","type":"text/plain"},"key":"status","value":"canceled,ended,ongoing,pilot,unknown"},{"disabled":true,"description":{"content":"Search across the tvshow title, episode title, or tvshow networks
\n","type":"text/plain"},"key":"title","value":"Browse the rated episodes feed with episode-level sorting and tvshow-level filters.
\n","_postman_id":"b090769b-e2c4-4ad2-94e5-6cb643a89b90"},{"name":"GET /{item_type}/{id}","item":[{"name":"{id}","id":"3558da06-4b40-45ea-8b17-5cc3cc379026","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://whatson-api.onrender.com/tvshow/249042?ratings_filters=allocine_critics,allocine_users,betaseries_users,imdb_users,metacritic_critics,metacritic_users,rottentomatoes_critics,rottentomatoes_users,letterboxd_users,senscritique_users,tmdb_users,trakt_users,tvtime_users&append_to_response=awards,critics_rating_details,directors,episodes_details,genres,highest_episode,last_episode,lowest_episode,networks,next_episode,platforms_links,production_companies,certification_variants,image_variants,title_variants,parents_guide","description":"This endpoint provides detailed information about specific item (movie or tv show) by its unique identifier and type
\n","urlObject":{"path":["tvshow","249042"],"host":["https://whatson-api.onrender.com"],"query":[{"description":{"content":"Ratings filters source
\n","type":"text/plain"},"key":"ratings_filters","value":"allocine_critics,allocine_users,betaseries_users,imdb_users,metacritic_critics,metacritic_users,rottentomatoes_critics,rottentomatoes_users,letterboxd_users,senscritique_users,tmdb_users,trakt_users,tvtime_users"},{"description":{"content":"Should we return specific keys in the response
\n","type":"text/plain"},"key":"append_to_response","value":"awards,critics_rating_details,directors,episodes_details,genres,highest_episode,last_episode,lowest_episode,networks,next_episode,platforms_links,production_companies,certification_variants,image_variants,title_variants,parents_guide"}],"variable":[{"id":"3ae815cf-e50d-429f-a76f-d2d5f62c8fdd","description":{"content":"The type of the item (movie or tvshow)
\n","type":"text/plain"},"type":"any","value":"tvshow","key":"item_type"},{"id":"a6cdc593-2af1-43bc-84df-a670f0db4280","description":{"content":"TMDB ID of the item
\n","type":"text/plain"},"type":"any","value":"249042","key":"id"}]}},"response":[],"_postman_id":"3558da06-4b40-45ea-8b17-5cc3cc379026"}],"id":"81283463-9dab-4a52-a67a-6310e9fcdfc6","_postman_id":"81283463-9dab-4a52-a67a-6310e9fcdfc6","description":""},{"name":"GET /tvshow/{id}/seasons","item":[{"name":"Get seasons metadata","id":"22acb8e5-bc09-4770-90b1-1e97af62696a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://whatson-api.onrender.com/tvshow/249042/seasons?append_to_response=highest_episode,last_episode,lowest_episode,next_episode,rating_distribution,rating_distribution_episodes","description":"Returns season-level metadata for a tvshow.
\n","urlObject":{"path":["tvshow","249042","seasons"],"host":["https://whatson-api.onrender.com"],"query":[{"description":{"content":"Should we return specific keys in the response
\n","type":"text/plain"},"key":"append_to_response","value":"highest_episode,last_episode,lowest_episode,next_episode,rating_distribution,rating_distribution_episodes"}],"variable":[{"id":"9bfaeea9-80ec-4c93-95cf-512865d40138","description":{"content":"TMDB ID of the tvshow.
\n","type":"text/plain"},"type":"any","value":"249042","key":"id"}]}},"response":[],"_postman_id":"22acb8e5-bc09-4770-90b1-1e97af62696a"}],"id":"7c08eb2d-3a06-4f6a-bded-4b09799ea85b","_postman_id":"7c08eb2d-3a06-4f6a-bded-4b09799ea85b","description":""},{"name":"GET /tvshow/{id}/seasons/{season_number}/episodes","item":[{"name":"List season episodes","id":"eef49e32-162b-43af-ab62-733af7c76214","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://whatson-api.onrender.com/tvshow/249042/seasons/1/episodes","description":"Returns the list of episodes for a specific season, with optional episode-level filters.
\n","urlObject":{"path":["tvshow","249042","seasons","1","episodes"],"host":["https://whatson-api.onrender.com"],"query":[{"disabled":true,"description":{"content":"Minimum ratings to return
\n","type":"text/plain"},"key":"minimum_ratings","value":"Use from:/to: with yyyy-mm-dd to set an inclusive date range
TMDB ID of the tvshow.
\n","type":"text/plain"},"type":"any","value":"249042","key":"id"},{"id":"42123dae-3616-4ef1-83b1-10c6479b1056","description":{"content":"Season number to inspect.
\n","type":"text/plain"},"type":"any","value":"1","key":"season_number"}]}},"response":[],"_postman_id":"eef49e32-162b-43af-ab62-733af7c76214"}],"id":"c705c257-a2da-4bab-b524-1c2f4ab15edc","_postman_id":"c705c257-a2da-4bab-b524-1c2f4ab15edc","description":""},{"name":"GET /tvshow/{id}/seasons/{season_number}/episodes/{episode_number}","item":[{"name":"Get episode details","id":"57705eb2-3fa3-483d-838b-6b4c8d1eb3f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://whatson-api.onrender.com/tvshow/249042/seasons/1/episodes/1","description":"Returns details for a specific episode inside a specific season.
\n","urlObject":{"path":["tvshow","249042","seasons","1","episodes","1"],"host":["https://whatson-api.onrender.com"],"query":[],"variable":[{"id":"522456ed-5b9e-481f-a29e-777ec7f53d19","description":{"content":"TMDB ID of the tvshow.
\n","type":"text/plain"},"type":"any","value":"249042","key":"id"},{"id":"4c0117a3-8e8a-480f-a8f3-da45d5c74738","description":{"content":"Season number to inspect.
\n","type":"text/plain"},"type":"any","value":"1","key":"season_number"},{"id":"ad593731-f78f-4a46-b24f-461f02dab9f3","description":{"content":"Episode number inside the selected season.
\n","type":"text/plain"},"type":"any","value":"1","key":"episode_number"}]}},"response":[],"_postman_id":"57705eb2-3fa3-483d-838b-6b4c8d1eb3f7"}],"id":"d35457b1-48bc-47e0-b819-704033b321b0","_postman_id":"d35457b1-48bc-47e0-b819-704033b321b0","description":""}],"variable":[{"id":"324a9ee4-e5f2-4aa0-824f-11bd333eb49e","key":"baseUrl","value":"https://whatson-api.onrender.com"},{"id":"837139e1-f1d4-4428-8b84-3445bf1bff6f","key":"item_type","value":"tvshow"},{"id":"2263a8e6-4648-4c91-ad0f-d6569f9a5d7b","key":"id","value":"249042"},{"id":"9c35419c-13d8-4336-a3a3-613dfeea0c6c","key":"season_number","value":"1"},{"id":"254cea16-5115-4dd7-a97f-33accef27ac6","key":"episode_number","value":"1"}]}