Video Search

From Medioh Wiki

medioh.tv exposes an API for performing searches against our vast video directory. The base URL for all requests is:

In all cases, results are returned in RSS 2.0 syndication format with Media RSS extensions. Queries should be made as HTTP GET requests with all parameters passed via the query string (e.g. /videos.rss?param1=value1&param2=value2). An example of a RSS result can be found here, RSS Example

Alternatively, a JSON representation is available at:

http://medioh.tv/videos.json

An example of a JSON result can be found here, JSON Example

The following parameters are supported, and may be mixed and matched in any combination you desire (with a few noted caveats):

key

Your API key, provided by us. This field is need for all API requests. If you don’t already have one, please visit http://medioh.com/api to obtain one.

example: http://medioh.tv/videos.rss?key=12345

query

Perform a search query. The value passed to this parameter should be a word or phrase to search for.

single term: http://medioh.tv/videos.rss?key=12345&query==dog

two terms: http://medioh.tv/videos.rss?key=12345&query==dog+cat

exact phrase: http://medioh.tv/videos.rss?key=12345&query=%22dog+cat%22

page

Retrieve results for the given page number. The first page is 1.

page 1: http://medioh.tv/videos.rss?key=12345&page=1

page 2: http://medioh.tv/videos.rss?key=12345&page=2

per_page

Return the specified number of results per page. The maximum is 100.

5 results: http://medioh.tv/videos.rss?key=12345&per_page=5

100 results: http://medioh.tv/videos.rss?key=12345&per_page=100

order

Specify the order results should be returned in. The value must be one of the following:

relevance – Relevance of the result to the given search term (must specify a query) http://medioh.tv/videos.rss?key=12345&order=relevance

date – Ordered from newest to oldest http://medioh.tv/videos.rss?key=12345&order=date

quality – Ordered by video bitrate from highest to lowest http://medioh.tv/videos.rss?key=12345&order=quality

resolution – Ordered by video resolution from highest to lowest http://medioh.tv/videos.rss?key=12345&order=resolution

duration – Ordered by the duration of the content from longest to shortest http://medioh.tv/videos.rss?key=12345&order=duration

length – Ordered by the length (size) of the content in bytes from longest to shortest http://medioh.tv/videos.rss?key=12345&order=length

views – Ordered by total number of views from highest to lowest http://medioh.tv/videos.rss?key=12345&order=views

ranking – Ordered by user ranking from highest to lowest http://medioh.tv/videos.rss?key=12345&order=ranking

ascending

If the value for this parameter is “true”, invert the order in which results are returned (e.g. oldest to newest, lowest bitrate to highest, etc.) This works for all ordering parameters above.

normal ordering: http://medioh.tv/videos.rss?key=12345&order=date

reversed ordering: http://medioh.tv/videos.rss?key=12345&order=date&ascending=true

normal ordering again: http://medioh.tv/videos.rss?key=12345&order=date&ascending=false

explicit

If set to “true” / “false”, only content marked as explicit / non-explicit is returned. If not specified both result types are returned. RSS results will always mark explicit content with the <media:rating scheme="urn:simple">adult</media:rating> tag.

no content marked explicit: http://medioh.tv/videos.rss?key=12345&explicit=false

only content marked explicit: http://medioh.tv/videos.rss?key=12345&explicit=true

copyrighted

If set to “true”, only content with known copyright information is returned.

known copyright results: http://medioh.tv/videos.rss?key=12345&copyrighted=true

video_format

A comma separated list of video codecs (i.e. FOURCC codes) that results should include. Videos which do not match the specified codecs will be omitted. For a complete list, see Video Codecs

only AVC videos: http://medioh.tv/videos.rss?key=12345&video_format=avc1

both AVC and MP4 videos: http://medioh.tv/videos.rss?key=12345&video_format=avc1,mp4v

audio_format

A comma separated list of audio codecs (i.e. FOURCC codes) that results should include. Videos which do not encode audio with the specified codecs will be omitted. For a complete list see Audio Codecs

only MP3 audio: http://medioh.tv/videos.rss?key=12345&audio_format=85

both MP3 and ACC audio: http://medioh.tv/videos.rss?key=12345&audio_format=85,alac

language

A comma separated list of two letter language codes (see ISO 639-1). Only videos in the specified languages will be returned. Leaving this field blank will return all languages. common video languages

only Russian: http://medioh.tv/videos.rss?key=12345&language=ru

both Russian and English: http://medioh.tv/videos.rss?key=12345&language=ru,en

sites, exclude_sites

A comma separated list of sites that are either required or excluded. For example, exclude_sites=youtube,dailymotion will not return videos from either site. Visit Video Sites for a more complete list.

YouTube videos: http://medioh.tv/videos.rss?key=12345&sites=youtube

YouTube and DailyMotion videos: http://medioh.tv/videos.rss?key=12345&sites=youtube,dailymotion

everything but Youtube videos: http://medioh.tv/videos.rss?key=12345&exclude_sites=youtube

everything but Youtube and DailyMotion videos: http://medioh.tv/videos.rss?key=12345&exclude_sites=youtube,dailymotion

min_width, max_width, min_height, max_height

Specify the minimum and/or maximum dimensions of a video in pixels.

minimum 640x480 resolution: http://medioh.tv/videos.rss?key=12345&min_width=640&min_height=480

maximum 1280x720 resolution: http://medioh.tv/videos.rss?key=12345&max_width=1280&max_height=720

min and max resolution: http://medioh.tv/videos.rss?key=12345&min_width=640&min_height=480&max_width=1280&max_height=720

min_duration, max_duration

Specify a minimum and/or maximum duration of a video in seconds.

minimum 1 hour long: http://medioh.tv/videos.rss?key=12345&min_duration=3600

maximum 2 hours long: http://medioh.tv/videos.rss?key=12345&max_duration=7200

min_length, max_length

Specify a minimum and/or maximum length (size) of a video in bytes.

minimum 5mb in size: http://medioh.tv/videos.rss?key=12345&min_length=5000000

maximum 100mb in size: http://medioh.tv/videos.rss?key=12345&max_length=100000000

min_views, max_views

Specify the minimum and/or maximum number of user views.

minimum 10 views: http://medioh.tv/videos.rss?key=12345&min_views=10

maximum 100 views: http://medioh.tv/videos.rss?key=12345&max_views=100

min_ranking, max_ranking

Specify the minimum and/or maximum user ranking (ranges from 0.0 to 1.0).

minimum of 0.5 (average) ranking: http://medioh.tv/videos.rss?key=12345&min_ranking=0.5

maximum of 0.7 (good) ranking: http://medioh.tv/videos.rss?key=12345&max_ranking=0.7

highest ranked content: http://medioh.tv/videos.rss?key=12345&min_ranking=1

min_date, max_date

Specify the minimum and/or maximum publish date. Dates can be represented many different ways, see Time.parse for more.

published May 10th 2008 onwards: http://medioh.tv/videos.rss?key=12345&min_date=5/10/2008

published before 2008: http://medioh.tv/videos.rss?key=12345&max_date=12/31/2007

published between yesterday and today: http://medioh.tv/videos.rss?key=12345&min_date=yesterday&max_date=todate

min_bitrate, max_bitrate

Specify the minimum and/or maximum bitrate (bits/second).

minimum 1kb/s: http://medioh.tv/videos.rss?key=12345&min_bitrate=1000

maximum 10kb/s: http://medioh.tv/videos.rss?key=12345&max_bitrate=10000

protocol

There are two supported protocols videos distributed via HTTP and TORRENT. If left blank it will return results in HTTP protocol, which is sufficient for most use cases.

HTTP results: http://medioh.tv/videos.rss?key=12345&protocol=http

TORRENT results: http://medioh.tv/videos.rss?key=12345&protocol=torrent

Retrieved from "http://wiki.medioh.com/index.php/Video_Search"