https://github.com/michaelhelmick/hulu

A Python library to interact with Hulu's "hidden" 2.0 API
https://github.com/michaelhelmick/hulu

Last synced: about 1 month ago
JSON representation

A Python library to interact with Hulu's "hidden" 2.0 API

• Host: GitHub
• URL: https://github.com/michaelhelmick/hulu
• Owner: michaelhelmick
• License: bsd-2-clause
• Created: 2013-04-17T17:47:20.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-08-04T05:00:49.000Z (over 11 years ago)
• Last Synced: 2024-10-06T16:48:19.263Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 48.8 KB
• Stars: 7
• Watchers: 6
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
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

.. _Hulu: http://hulu.com/

.. _adammagana: https://github.com/adammagana