{"id":18514205,"url":"https://github.com/tizz98/netflix_roulette","last_synced_at":"2025-04-09T06:34:06.462Z","repository":{"id":57445639,"uuid":"48257906","full_name":"tizz98/netflix_roulette","owner":"tizz98","description":"A simple python wrapper for the Netflix Roulette API","archived":false,"fork":false,"pushed_at":"2019-11-04T00:27:39.000Z","size":58,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-29T06:20:46.643Z","etag":null,"topics":["netflix","netflix-roulette","python-wrapper"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tizz98.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-18T21:46:17.000Z","updated_at":"2023-09-08T17:04:50.000Z","dependencies_parsed_at":"2022-09-26T17:30:23.242Z","dependency_job_id":null,"html_url":"https://github.com/tizz98/netflix_roulette","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizz98%2Fnetflix_roulette","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizz98%2Fnetflix_roulette/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizz98%2Fnetflix_roulette/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizz98%2Fnetflix_roulette/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tizz98","download_url":"https://codeload.github.com/tizz98/netflix_roulette/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247993599,"owners_count":21030043,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["netflix","netflix-roulette","python-wrapper"],"created_at":"2024-11-06T15:42:24.161Z","updated_at":"2025-04-09T06:34:01.449Z","avatar_url":"https://github.com/tizz98.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Netflix Roulette\nThis is a simple python wrapper for the [Netflix Roulette API](http://netflixroulette.net/api/).\n\n[![Build Status](https://travis-ci.org/tizz98/netflix_roulette.svg?branch=master)](https://travis-ci.org/tizz98/netflix_roulette)\n[![PyPI version](https://img.shields.io/pypi/v/netflix_roulette.svg)](https://pypi.python.org/pypi/netflix_roulette)\n[![Python Versions](https://img.shields.io/pypi/pyversions/netflix_roulette.svg)](https://pypi.python.org/pypi/netflix_roulette)\n[![License](https://img.shields.io/pypi/l/netflix_roulette.svg)](https://github.com/tizz98/netflix_roulette/blob/master/LICENSE.md)\n[![Code Climate](https://codeclimate.com/github/tizz98/netflix_roulette/badges/gpa.svg)](https://codeclimate.com/github/tizz98/netflix_roulette)\n\n## Installation\n#### Pip\n- `pip install netflix_roulette`\n\n#### From Source\n- `git clone git@github.com:tizz98/netflix_roulette.git`\n- `cd netflix_roulette`\n- `python setup.py install`\n\n## Usage\n#### Simple Query\n```python\n\u003e\u003e\u003e import netflix_roulette\n\u003e\u003e\u003e media = netflix_roulette.NetflixMedia('Attack on titan')\n\u003e\u003e\u003e media\n\u003cNetflixMedia(title='Attack on titan', year='None')\u003e\n\u003e\u003e\u003e media.show_id\n70299043\n\u003e\u003e\u003e media.summary\nu'For over a century, people have been living behind barricades to block out the giant Titans that threaten to destroy the human race. When a Titan destroys his hometown, young Eren Yeager becomes determined to fight back.'\n\u003e\u003e\u003e media.is_on_netflix\nTrue\n\u003e\u003e\u003e media.get_readable_mediatype()\n'TV Show'\n```\n\n#### Query with year\n```python\n\u003e\u003e\u003e import netflix_roulette\n\u003e\u003e\u003e media = netflix_roulette.NetflixMedia('The Boondocks', year=2005)\n\u003e\u003e\u003e media\n\u003cNetflixMedia(title='The Boondocks', year='2005')\u003e\n\u003e\u003e\u003e media.show_id\n70153391\n\u003e\u003e\u003e media.summary\nu'Based on the comic strip by Aaron McGruder, this satirical animated series follows the socially conscious misadventures of Huey Freeman, a preternaturally smart 10-year-old who relocates from inner-city Chicago to the suburbs.'\n\u003e\u003e\u003e media.is_on_netflix\nTrue\n\u003e\u003e\u003e media.get_readable_mediatype()\n'TV Show'\n```\n\n## `class NetflixMedia`\n\n#### Parameters\n- `title`: Title of the media you are searching for.\n- `year`: (Optional) Year of the media you are searching for.\n\n#### Attributes\n- `title`: User supplied title of the media you are searching for.\n- `year`: User supplied year of the media you are searching for.\n- `rating`: How high the media is rated, max is 5.\n- `poster`: The poster for the media, right from the Netflix CDN.\n- `mediatype`: 0 means movie, 1 means TV Show. See also `get_readable_mediatype()`.\n- `release_year`: The media's release date.\n- `show_cast`: The cast of a given title.\n- `category`: A title's given category.\n- `summary`: A plot summary.\n- `director`: The name(s) of the director(s) of a given title.\n- `show_id`: The Netflix id of the title.\n- `is_on_netflix`: A boolean, whether or not the show is on Netflix.\n\n#### Methods\n- `get_readable_mediatype()`: Returns `TV Show` or `Movie` instead of `1` or `0`.\n- `is_movie()`: Returns `True` if the media is a Movie.\n- `is_tv_show()`: Returns `True` if the media is a TV Show.\n\n\n## `class NetflixDirector`\n\n#### Parameters\n- `name`: Name of the director you are searching for.\n\n#### Attributes\n- `name`: User supplied name.\n- `media`: List of `NetflixMedia` that the person has directed.\n\n\n## `class NetflixActor`\n\n#### Parameters\n- `name`: Name of the actor you are searching for.\n\n#### Attributes\n- `name`: User supplied name.\n- `media`: List of `NetflixMedia` that the person has been in.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftizz98%2Fnetflix_roulette","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftizz98%2Fnetflix_roulette","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftizz98%2Fnetflix_roulette/lists"}