Skip to main content

Rotten Tomatoes Command Line Tool

Project description

Rotten Tomatoes CLI

Build Status PyPI version codecov


  • 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


pip install rotten_tomatoes_cli


rotten search {term}

Harry Potter Example

rotten search "Harry Potter"


Master of None Example

rotten search "Master of None"



rotten tv {category}

Category Argument

  • new (default)
  • popular
  • fresh

Browse Popular TV Shows Example

rotten tv popular




  • --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


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



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


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rotten_tomatoes_cli-0.0.3.tar.gz (7.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page