Skip to content
A Python library to interact with Hulu's "hidden" 2.0 API
Python
Branch: master
Clone or download
Latest commit 943600f Aug 4, 2013
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
hulu Initial commit Apr 17, 2013
.gitignore Initial commit Apr 17, 2013
LICENSE Initial commit Apr 17, 2013
MANIFEST.in Initial commit Apr 17, 2013
README.rst Initial commit Apr 17, 2013
setup.py Update setup.py Aug 4, 2013

README.rst

Hulu

hulu attempts to make it easy for developers to interact with the Hulu "hidden" 2.0 API

The Story

A friend of mine, (@adammagana) created a PHP library (found here) to interact with the Hulu "hidden" 1.0 API. The 1.0 API only returns XML, but someone opened up an issue revealing some 2.0 endpoints that return JSON.

Since JSON is easier to work with in Python than XML is, I took it upon myself to try an open up their API to other developers.

Features

  • List companies that have shows/videos on Hulu
  • List videos from a specific show
  • List trailers available on Hulu
  • Find the position of a given video within the shows video list
  • (Kind of) Much more!

Installation

$ pip install hulu

Example Usage

from hulu import Hulu
h = HuluAPI()
try:
    h.get_companies()
except HuluError as e:
    print e

try:
    h.get_video_info(441295)
except HuluError as e:
    print e

Contribute

If anyone has additional information (such as; paramters taken to given API methods, extra API methods not yet found, etc.) please feel free to open a Pull Request! :)

TODO

  • Figure out authentication!

Some API methods require authentication, yet I haven't been able to figure out how to authenticate to make those API calls, these API calls include:

api/2.0/plus_upsell.json
api/2.0/favorited_show_ids
api/2.0/queued_video_ids
You can’t perform that action at this time.