Skip to main content

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

Project description

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.


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


$ pip install hulu

Example Usage

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

except HuluError as e:
    print e


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! :)


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


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

hulu-0.1.0.tar.gz (3.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page