Rotten Tomatoes CLI

• Introduction
• Install
• Search
  • Harry Potter Example
  • Master of None Example
• TV
  • Browse Popular TV Shows Example
• Movies
  • Streaming
    • Upcoming movies on Netflix or Amazon Prime with a minimum rating of 90
  • Theaters
    • Action movies in theaters with a minimum rating of 90

Introduction

• Search for movies and tv shows on Rotten Tomatoes from the command line
• Browse movies in theaters or on various streaming platforms like Netflix and Amazon Prime

Install

pip install rotten_tomatoes_cli

Search

rotten search {term}

Harry Potter Example

rotten search "Harry Potter"

Master of None Example

rotten search "Master of None"

TV

rotten tv {category}

Category Argument

• new (default)
• popular
• fresh

Browse Popular TV Shows Example

rotten tv popular

Movies

Options:

• --minimum_rating / -l
  • Minimum allowable Rotten Tomatoes score
  • Default: 70
• --maximum_rating / -h
  • Maximum allowable Rotten Tomatoes score
  • Default: 100
• --certified_fresh / -f
  • Boolean flag that represents whether or not to only show "Certified Fresh" movies
  • Default: True
• --service / -s
  • Filter by specified streaming services
  • Default: All services
  • Can specify multiple services
  • Values:
    • amazon
    • prime
    • hbo
    • itunes
    • netflix
    • vudu
    • fandango
• --genre / -g
  • Filter by specified genres
  • Default: All genres
  • Can specify multiple genres
  • Values:
    • action
    • animation
    • art_and_foreign
    • classics
    • comedy
    • documentary
    • drama
    • horror
    • family
    • mystery
    • romance
    • scifi
• --sort_by
  • Sort results by specified value
  • Default: popularity
  • Values:
    • popularity
    • release

Streaming

rotten movies streaming {category}

Category Argument

• new (default)
• all
• top
• upcoming
• fresh

Upcoming movies on Netflix or Amazon Prime with a minimum rating of 90

rotten movies streaming upcoming -l 90 -s netflix -s prime

Theaters

rotten movies theaters {category}

Category Argument

• opening (default)
• playing
• upcoming
• fresh

Action movies in theaters with a minimum rating of 90

rotten movies theaters playing -l 90 -g action