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

Release history Release notifications

Download files

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

Files for hulu, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size hulu-0.1.0.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page