Channel Search

From Medioh Wiki

medioh.tv exposes an API for performing searches of channels. Channels refer to RSS Channel or feed, each containing many videos from a discrete publisher. Where as the Video Search API searches individual videos, Channel Search searches entire feeds of videos. The base URL for all requests is:

http://medioh.tv/channels.rss

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. /channels.rss?param1=value1&param2=value2). An example of a RSS result can be found here, Channel RSS Example

Alternatively, a JSON representation is available at:

http://medioh.tv/channels.json

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

The following parameters are supported:

1 key
2 query
3 tags
4 page
5 per_page
6 language
7 sites, exclude_sites
8 explicit
9 video_format

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/channels.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/channels.rss?key=12345&query==dog

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

exact phrase: http://medioh.tv/channels.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/channels.rss?key=12345&page=1

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

per_page

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

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

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

language

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

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

both Russian and English: http://medioh.tv/channels.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 channels from either site. Visit Video Sites for a more complete list.

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

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

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

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

explicit

If set to “true” / “false”, only content marked as explicit / non-explicit is returned. If not specified both result types are returned. Video 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/channels.rss?key=12345&explicit=false

only content marked explicit: http://medioh.tv/channels.rss?key=12345&explicit=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/channels.rss?key=12345&video_format=avc1

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

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