Watch Widget

The Watch Widget allows site owners or administrators to add a list of the latest free episodes from almost any tv show on the web. Watch.io gathers information from numerous sites so site owners don't have to.

Live Example: Gleefansite.com

MediaWiki Extension

The Watch Widget is also available as a MediaWiki extension. Click the link for download and installation instructions.

Watch Widget Generator (iFrame)

How-To: Add a Widget to the Wordpress Sidebar

Note: this iframe embed code will work on most sites that can include html content. For Joomla, Jumi is recommended.

Log in to the wp-admin portion of the site and click on Appearance->Widgets from the menu on the left of the admin portal.
Click and drag the Text widget from the Available Widgets and release it on the sidebar.
Click the down arrow on the Text widget and then copy and paste the text in the next step into the text area of the Text widget.
Enter parameters, click Generate and preview above

Show:

Size:

Exact:

<iframe src="http://watch.io/api/widget.php?show=glee&size=300x250&exact=true" marginwidth="0" marginheight="0" width="300" height="250" border="0" frameborder="0" style="border:none;" scrolling="no" > </iframe>

Parameters

Parameter	Description
size	Determines the size of the widget. Valid valus are 300x250 or 225x250
show	Any show name
exact	Optional. Valid values are true or false. This determines if the show name will only return exact matches or similar matches. For example, Glee could return both Glee and the Glee Project if exact=false.

API

A full api that returns results in the JSON format is available for developers who would like to make their own widgets or applications.

The api parameters are nearly identical to the widget parameters above, with a few additions.

Terms of Use

Watch.io MUST be credited somewhere on the site on which the results are used, using a link.
The API MUST NOT BE used to provide services in competition with Watch.io. In other words, fan sites are great, but video search engines are not.
The API is free for up to 100 requests per day and a maximum of 10 results per query. For those who need more than that, please use the contact form to submit inquiries. For most uses, with a resonable amount of caching, this level should be sufficient.
There are no guarantees on the service availability. If there is a change in the availability, every effort will be made to notify registered users (see Update Notification below).

Customization

Customization of the API is available if needed, at reasonable rates. For those who need a custom widget or API response, please use the contact form to submit inquiries.

Update Notification

Developers are strongly encouraged to subscribe to the developer mailing list to recieve notifications of changes.

API Parameters

Base API Url	http://watch.io/api/query.php
Parameter	Required	Default Value	Valid Values	Notes
show	Optional	All shows	Any show name	Case insensitive
max	Optional	5	1 - 10	Determines the maximum number of results
domain	Required	NA	NA	The domain the content will be used on. (i.e. gleefansite.com)
format	Optional	json	json	Xml, html and others will be added in the future.

Return Values

Value	Notes
result	The result of the query, either success or error. Note that an error is returned if no results are found or the request is missing required parameters.
message	If result is 'error', message will contain the error reason
episodes	The container for all episodes in the result

showname	The name of the show
title	The title of the episode
season	The numeric season, if available
episode	The numeric episode, if available
thumb	The thumbnail for the episode
synopsis	The synopsis of the episode, truncated to no more than 250 characters.

API Example in PHP

<?php

error_reporting(0);

$cachetime = 2 * 60 * 60;  //2 hours measured in seconds
$cachedir = "cache";
$cachefile = $cachedir ."/watchiocache.php";			
if (file_exists($cachefile) && filesize($cachefile) > 0 && (time() - $cachetime < filemtime($cachefile))) 
{
	$html = file_get_contents($cachefile);
	exit;
}
						
$baseurl = "http://watch.io/api/query.php?";
$credit = "http://watch.io";

$params = array(
	'show' => 'mister ed',
	'exact' => 'true',
	'max' => '5',
	'domain' => 'example.com',
	'format' => 'json'
	);

$query = http_build_query($params);
$url = $baseurl .$query;

$result = file_get_contents($url);
$show = json_decode($result, TRUE);

$html = "";

if(!empty($show) && $show['result'] == 'success')
{
	foreach($show['episodes'] as $e)
	{
		$html .= '<a href="' .htmlentities($e['watchurl']) .'"><img src="' .htmlentities($e['thumb']) .'"></a>';
		$html .= '<a href="' .htmlentities($e['watchurl']) .'">' .htmlentities($e['showname']) .' : ' .htmlentities($e['title']) .'</a>';
		$html .= '<p>' .sprintf("S%02sE%02s", $e['season'], $e['episode']) .'</p>';
		$html .= '<p>' .$e['synopsis'] .'</p>';
	}

if(!empty($html))
	{
		$html .= '<br>';
		$html .='<p>Powered by: <a href="' .htmlentities($credit) .'">Watch.io</a></p>';
		
		if(file_exists($cachedir))	//make sure the cache directory exists
		{
			$fp = fopen($cachefile, 'w');
			fwrite($fp, $html);
			fclose($fp);
		}
	}
}

echo $html;

Copyright (c) 2011, Lance Ward
To the extent possible under law, Lance has waived all copyright and related or neighboring rights to Watch.io API Example. This work is published from: United States.

http://creativecommons.org/publicdomain/zero/1.0/

*/	
?>


Show:
Size:
Exact: