Main Page
From Justin.tv API Wiki
Are you building an app that connects with Twitch? Use the Twitch API Instead!
Welcome to the Justin.tv API wiki. You can use the Justin.tv APIs to build your own live video apps quickly and easily. There are tools available that allow you to build an entirely custom experience, from a video player on up. We're constantly improving the API, so feel free to suggest something new!
Contents |
Getting Started
- Guide to Getting Started: A walk through for setting up your developer account, etc.
Documentation
- REST API: Create Justin.tv users, make clips out of previously broadcast streams, list currently live streams, register callbacks, and more.
- IFrame Chat Embed: Add JTV chat to your site with an IFrame embed.
- VLC Broadcasting API: Use VLC to broadcast from Linux, Windows, and Mac OSX.
Tools
- Developer Account Activator - Make your Justin.tv account a developer account here.
- Client Application List - Review and edit client application settings.
- Application Creator - After activating your dev account, get your OAuth application credentials here.
- Request Form (User/Channel) - Fill out this form to apply for the ability to create Justin.tv users and channels.
- Request Form (Video) - Fill out this form to apply for a higher video stream rate limit.
Community
- Justin.tv API Group - This group is closely monitored by the JTV API developers, and enabled you to get fast responses to your API related questions. You can also suggest new features here; we're always receptive to new ideas!
Examples
- JTV Explorer git repo - An open source example application on the REST API built in Ruby on Rails. You can see a hosted version of this app at http://explorer.justin.tv:3000
- Application Gallery - A list of applications and code built on top of the API
Libraries
- Justin.tv Ruby Client Library - A client library wrapping the OAuth gem you can use to access the REST API from Ruby
- Justin.tv Python Client Library - A client library wrapping the OAuth library you can use to access the REST API from Python
- Justin.tv PHP Client Library - A client library wrapping the OAuth library you can use to access the REST API from PHP
- Examples in other languages:
- Authenticating with .NET - http://www.markerstudio.com/miscellaneous/2009/09/net-oauth-sample-working-with-justintv/
Help
- OAuth Ruby Tutorial - A tutorial demonstrating how to use OAuth authentication with Ruby
- OAuth PHP Tutorial - A PHP OAuth tutorial
API Keys
Some features require API keys which are tied to applications. To get a key, make your account a developer and then create an application. Non-whitelisted keys are rate limited to 45 REST API requests every 5 minutes, and 1,000 video plays every 5 minutes. You can apply to be on the white list, which will raise your limit to 300 REST requests every 5 minutes and 100,000 video plays every 5 minutes. If your app requires higher limits, please contact us.
