|Your one-stop shop for instructional videos and DIY projects

Home Videos Studios Upload About Solutions

Got 5min?

API

Making a Studio Request

To access the data for a specific user you simply request a URL from 5min.com and let us know what you want. The URLs are simple and they can be built with the following format:

Making the URL

http://api.5min.com/studio/member_name/request.format[?extra]

member_name	Member name.
request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
extra	Optional. More parameters to sort/filter results. The different extra types are listed below.

Requests you can make

info	Member info for the specified member.
videos	Videos created by member.
favorites	Videos the user has marked as favorites.
subscriptions	Studios the member is subscribed to.
subscribers	Studios that are subscribed to this member's studio.

Extras you can use (only for videos request)

num_of_videos	The number of videos in the current page.	25(default). Max size is 50.
page	If limited by num_of_videos to x page y will bring the next x results if exists.	page=y.
restriction	Restrict HTML in result (excluding CDATA).	no_html html(default)
sort	The sorting method.	featured most_viewed top_rated most_discussed most_favorite most_recent(default).
sid	The syndicator id.
auto_start	The video starts playing automatically.	false(default) true.
overlay	Show sidebars as overlay on the video.	false true(default).
transcript	Include/exclude transcript for video.	false(default) true.
add_ons	Include/exclude add-ons for video.	false(default) true.
thumbnail_sizes	Include/exclude thumbnails sizes extracted for video.	false(default) true.
multiple_thumbnails	Include/exclude all thumbnails for video.	false(default) true.
width	Embed width value.	480(default).
height	Embed height value.	401(default).
video_language	Filter by language (Default is English).	en(English)(default). cn(Chinese) fr(French) jp(Japanese) es(Spanish) de(German/Deutch)
return_num_items	Total number of results for pagination.	false(default) true.
num_related_return	Number of related videos to return per video.	0(default). Max number is 20.
return_category_id	Add ID of category per video.	false(default) true.
question	Get Videos with title questions only.	false(default) true.

Example Request

To get a list of the videos created by AOL news now, you would make this request:

http://api.5min.com/studio/aolnewsnow/info.xml

Example Response

Here's an example of the XML response from a info call:

<?xml version="1.0" encoding="UTF-8"?>

<display_name>AOL News Now</display_name>

<created_on>3/2/2011 4:14:59 PM</created_on>

<bio>Welcome to AOL News Now studios at 5min.com.</bio>

<studio_url>http://www.5min.com/AolNewsNow </studio_url>

<total_videos_shared>1169</total_videos_shared>

<total_subscribers>0</total_subscribers>

<thumbnail_url>http://pShared.5min.com/Graphics/defaults/MaleAvatarBig.gif </thumbnail_url>

</Studio>

</Studios>

Making a Studios Request

To access the data for all users you simply request a URL from 5min.com and let us know what you want. The URLs are simple and they can be built with the following format:

Making the URL

http://api.5min.com/studios/request.format[?extra]

member_name	Member name.
request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
extra	Optional. More parameters to sort/filter results. The different extra types are listed below.

Requests you can make

info	Member info for the specified member.

Extras you can use (only for videos request)

page	If limited by num_of_videos to x page y will bring the next x results if exists.	page=y.
sort	The sorting method.	most_viewed most_favorite most_recent(default).
sid	The syndicator id.
Categories_list	Restrict the results to studios containing videos in these categories (comma separated)	false(default) true.

Example Request

To get a list of the studios available in 5min.com:

http://api.5min.com/studios/info.xml

Example Response

Here's an example of the XML response from a info call:

<?xml version="1.0" encoding="UTF-8"?>

<display_name>PPCGeeks Dot Com</display_name>

<created_on>5/24/2011 9:25:35 PM</created_on>

<url>http://www.PPCGeeks.com</url>

<bio>We are a source for all things mobile! Check us out for the latest news and information on Mobile Phones, Rooting, and more!</bio>

<studio_url>http://www.5min.com/ppcgeeks </studio_url>

<total_videos_shared>1</total_videos_shared>

<total_subscribers>0</total_subscribers>

<thumbnail_url>http://files.5min.com/images/517074/517073198.gif </thumbnail_url>

</Studio>

<display_name>Curse</display_name>

<created_on>5/17/2011 4:04:23 PM</created_on>

<url>http://www.curse.com</url>

<bio>Curse is the largest online gaming information property worldwide. Don’t miss the opportunity to reach 14 million+ core PC and console gamers, movie buffs, technology & car enthusiasts. A male 18-34</bio>

<studio_url>http://www.5min.com/curse </studio_url>

<total_videos_shared>1</total_videos_shared>

<total_subscribers>0</total_subscribers>

<thumbnail_url>http://files.5min.com/images/517071/517070182.png </thumbnail_url>

</Studio>

<display_name>HipHollywood</display_name>

<created_on>5/9/2011 10:14:22 PM</created_on>

<url>http://www.HipHollywood.com</url>

<bio> Created by The Insider Host and Correspondent, Kevin Frazier, HipHollywood.com features the latest videos, photos, news, and interviews coming out of Black Hollywood. Additionally, the site offers viewers exclusive access to the red carpet and behind- the- scenes footage of Hollywood's hottest parties, award shows and events. "We Don't Talk ABOUT Stars, We Talk WITH Them" is the motto of the site. The HipHollywood.com web site may be accessed via the World Wide Web at www.HipHollywood.com </bio>

<studio_url>http://www.5min.com/HipHollywood </studio_url>

<total_videos_shared>32</total_videos_shared>

<total_subscribers>0</total_subscribers>

<categories>Music,People</categories>

<thumbnail_url>http://files.5min.com/images/517063/517062414.jpg </thumbnail_url>

</Studio>

</Studios>

Making a Video Request

To access the data for a specific video, you simply request a URL from 5min.com and let us know what you want. The URLs are simple and they can be built with the following format:

Making the URL

http://api.5min.com/video/video_id/request.format[?extra]

video_id	Can be retrieved from the end of the video URL.
request	The data you want. The different request types are listed below.

Requests you can make

info	Video info for the specified video_id
list/info	Video info for the specified video_ids

Required parameter (only for list/info request)

video_ids

Comma separated video list.

Extras you can use

sid	The syndicator id.
auto_start	The video starts playing automatically.	false(default) true.
overlay	Show sidebars as overlay on the video.	false true(default).
transcript	Include/exclude transcript for video.	false(default) true.
add_ons	Include/exclude add-ons for video.	false(default) true.
thumbnail_sizes	Include/exclude thumbnails sizes extracted for video.	false(default) true.
multiple_thumbnails	Include/exclude all thumbnails for video.	false(default) true.
width	Embed width value.	480(default).
height	Embed height value.	401(default).
num_related_return	Number of related videos to return per video.	0(default). Max number is 20.
return_category_id	Add ID of category per video.	false(default) true.
video_group_id	The ID of the collection of videos you are requesting
External_data	Get external video identification	false(default) true.

Example Request

To get a video info, you would make this request:

http://api.5min.com/video/25153871/info.xml?multiple_thumbnails=true

Example Response

Here's an example of the MRSS response from a info call:

<?xml version="1.0" encoding="UTF-8"?>

<title>Video's "How to Buy a Business Suit" info</title>

<description>This feed contains the video's "How to Buy a Business Suit" info API</description>

<image>

<url>http://lshared.5min.com/Graphics/Logos/5min_logo.JPG</url>

</image>

<docs>http://backend.userland.com/rss</docs>

<item>

<title>How to Buy a Business Suit</title>

<description><a href="http://www.5min.com/Video/How-to-Buy-a-Business-Suit-25153871"><img height='100px' width = '150px' alt='' src="http://pThumbnails.5min.com/503078/25153871_11.jpg"></a><p>Everyday business attire may have become more casual, but the suit is still the anchor of any man's formal wardrobe. Learn how to put together a suit that will impress.</p></description>

<media:content url="http://lvideos.5min.com/251539/25153871.flv" type="video/x-flv" expression="sample" duration="445" bitrate="600" />

<media:title type="plain">How to Buy a Business Suit</media:title>

<media:description type="html">Everyday business attire may have become more casual, but the suit is still the anchor of any man's formal wardrobe. Learn how to put together a suit that will impress.</media:description>

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_11.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_1.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_2.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_3.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_4.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_5.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_6.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_7.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_8.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_9.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_10.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_12.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_13.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_14.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_15.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_16.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_17.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_18.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_19.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_20.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_21.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_22.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_23.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_24.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_25.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_26.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_27.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_28.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_29.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_30.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_31.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_32.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_33.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_34.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_35.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_36.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_37.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_38.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_39.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_40.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_41.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_42.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_43.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_44.jpg" height="105" width="140" />

<media:thumbnail url="http://pthumbnails.5min.com/503078/25153871_45.jpg" height="105" width="140" />

<media:category label="Fashion/Men">Fashion/Men</media:category>

<media:credit role="author">Style4Men</media:credit>

<media:rating>nonadult</media:rating>

<media:keywords>Business,dress,pants,shoes,suit,tie</media:keywords>

<media:player url="http://www.5min.com/Embeded/25153871/" height="325" width="400"><![CDATA[<div style='text-align:center'><object width='480' height='401' id='FiveminPlayer'><param name='allowfullscreen' value='true'/><param name='allowScriptAccess' value='always'/><param name='movie' value='http://www.5min.com/Embeded/25153871/'/><embed src='http://www.5min.com/Embeded/25153871/' type='application/x-shockwave-flash' width='480' height='401' allowfullscreen='true' allowScriptAccess='always'></embed></object><br/><a href='http://www.5min.com/Video/How-to-Buy-a-Business-Suit-25153871' style='font-family: Verdana;font-size: 10px;' target='_blank'>How to Buy a Business Suit</a></div>]]></media:player>

<image>

<title>How to Buy a Business Suit</title>

<url>http://pthumbnails.5min.com/503078/25153871_11.jpg</url>

<description>Everyday business attire may have become more casual, but the suit is still the anchor of any man's formal wardrobe. Learn how to put together a suit that will impress.</description>

</image>

</item>

</channel>

</rss>

Making a Category Request

To access the data for a specific category, you simply request a URL from 5min.com and let us know what you want. Mapping of 5min Categories can be found here. The URLs are simple and can be built with the following format:

Making the URL

http://api.5min.com/category/category_id/request.format[?extra]

category_id	The category_id can either be the category name, or the Id of the category. e.g. Arts e.g. Knowledge/History e.g. 1 e.g. 83
request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
extra	Optional. More parameters to sort/filter results. The different extra types are listed below.

Requests you can make

info	Info for the specified category_id
videos	Videos related to the specified category_id
rejected	Videos related to the specified category_id which were deleted
updates	Videos related to the specified category_id which were updated

Extras you can use (only for info request)

include_children

Include all sub categories info in current format.

true
false(default).

Extras you can use (only for videos request)

num_of_videos	The number of videos in the current page.	25(default). Max size is 50.
page	If limited by num_of_videos to x page y will bring the next x results if exists.	page=y.
restriction	Restrict HTML in result (excluding CDATA).	no_html html(default)
allow_flagged	Include/exclude flagged videos.	true false(default)
sort	The sorting method.	featured most_viewed top_rated most_discussed most_favorite most_recent(default).
time	The time frame of the sort parameter.	today week month ever(default).
sid	The syndicator id.
auto_start	The video starts playing automatically.	false(default) true.
overlay	Show sidebars as overlay on the video.	false true(default).
transcript	Include/exclude transcript for video.	false(default) true.
add_ons	Include/exclude add-ons for video.	false(default) true.
thumbnail_sizes	Include/exclude thumbnails sizes extracted for video.	false(default) true.
multiple_thumbnails	Include/exclude all thumbnails for video.	false(default) true.
width	Embed width value.	480(default).
height	Embed height value.	401(default).
video_language	Filter by language (Default is English).	en(English)(default). cn(Chinese) fr(French) jp(Japanese) es(Spanish) de(German/Deutch)
semantic_tag	Allows getting videos for a specific semantic object.	Currently supported only for category "Video Games" (223), Does not support "Featured" sorting.
return_num_items	Total number of results for pagination.	false(default) true.
num_related_return	Number of related videos to return per video.	0(default). Max number is 20.
External_data	Get external video identification	false(default) true.
return_category_id	Add ID of category per video.	false(default) true.
start_date	Return only videos that were added/updated/rejected from a specific date&time. (in videos request – the parameter is relevant only for sort=most_recent)	Date only format: yyyymmdd DateTime format: yyyymmddhhmmss

Example Request

To get a list of the videos related to Arts category, you would make this request:

http://api.5min.com/category/Arts/videos.xml?num_of_videos=5&restriction=no_html

http://api.5min.com/category/1/videos.xml?num_of_videos=5&restriction=no_html

This is an example for Video Games request with semantic tag

http://api.5min.com/category/223/videos.xml?num_of_videos=5&semantic_tag=gta 3

Example Response

Here's an example of the MRSS response from a videos call:

<?xml version="1.0" encoding="UTF-8"?>

<title>5min Arts: recently added </title>

<description>In this feed you can find howto videos related to Arts: recently added </description>

<docs>http://backend.userland.com/rss</docs>

<item>

<title>Penn & Teller on how the buzzsaw trick works</title>

<description>Learn how the pros pull off this cool trick.</description>

<media:content url="http://fivemin.vo.llnwd.net/o15/305937/30593635.flv" type="video/flash" expression="sample" duration="138" bitrate="600" />

<media:title type="plain">Penn & Teller on how the buzzsaw trick works</media:title>

<media:description type="html">Learn how the pros pull off this cool trick.</media:description>

<media:thumbnail url="http://files.5min.com/Thumbnails/611873/30593635_7.jpg" height="100" width="150" />

<media:category label="Arts/Magic">Arts/Magic</media:category>

<media:credit role="author">IzabelGuila</media:credit>

<media:keywords>buzz,buzzsaw,magic,penn,saw,teller,trick</media:keywords>

<media:player url="http://www.5min.com/Embeded/30593635/" height="325" width="400"><![CDATA[<div style='text-align:center'><object width='480' height='401' id='FiveminPlayer'><param name='allowfullscreen' value='true'/><param name='allowScriptAccess' value='always'/><param name='movie' value='http://www.5min.com/Embeded/30593635/'/><embed src='http://www.5min.com/Embeded/30593635/' type='application/x-shockwave-flash' width='480' height='401' allowfullscreen='true' allowScriptAccess='always'></embed></object><br/><span style='font-family: Verdana; font-size: 10px;'> <a href='http://www.5min.com/Category/Arts/Magic' target='_blank'>Magic Tricks</a> revealed at 5min.com</span></div>]]></media:player>

<image>

<title>Penn & Teller on how the buzzsaw trick works</title>

<url>http://files.5min.com/Thumbnails/611873/30593635_7.jpg</url>

<description>Learn how the pros pull off this cool trick.</description>

</image>

</item>

<item>

<title>How Bees Dance When They Find Food</title>

<description>Bee-Boy dance crew drops dead. It is a fact of nature: When a honey bee returns to the hive after finding a good source of nectar, it will perform a unique dance for its hive mates, detailing the distance, quality and quantity of the new food supply</description>

<media:content url="http://fivemin.vo.llnwd.net/o15/297376/29737577.flv" type="video/flash" expression="sample" duration="117" bitrate="600" />

<media:title type="plain">How Bees Dance When They Find Food</media:title>

<media:description type="html">Bee-Boy dance crew drops dead. It is a fact of nature: When a honey bee returns to the hive after finding a good source of nectar, it will perform a unique dance for its hive mates, detailing the distance, quality and quantity of the new food supply</media:description>

<media:thumbnail url="http://files.5min.com/Thumbnails/594752/29737577_2.jpg" height="100" width="150" />

<media:category label="Arts/Dance">Arts/Dance</media:category>

<media:credit role="author">helpthehoneybees</media:credit>

<media:keywords>bees, Break, ccd, collapse, colony, cream, dance, dazs, disorder, environment, green, haagen, help, hip, hive, honey, hop, ice</media:keywords>

<media:player url="http://www.5min.com/Embeded/29737577/" height="325" width="400"><![CDATA[<div style='text-align:center'><object width='480' height='401' id='Object1'><param name='allowfullscreen' value='true'/><param name='allowScriptAccess' value='always'/><param name='movie' value='http://www.5min.com/Embeded/29737577/'/><embed src='http://www.5min.com/Embeded/29737577/' type='application/x-shockwave-flash' width='480' height='401' allowfullscreen='true' allowScriptAccess='always'></embed></object><br/><a href='http://www.5min.com/Video/How-Bees-Dance-When-They-Find-Food-29737577' style='font-family: Verdana;font-size: 10px;' target='_blank'>How Bees Dance When They Find Food</a></div>]]></media:player>

<image>

<title>How Bees Dance When They Find Food</title>

<url>http://files.5min.com/Thumbnails/594752/29737577_2.jpg</url>

</image>

</item>

</channel>

</rss>

Example Request

http://api.5min.com/category/1/info.xml

Example Response

<?xml version="1.0" encoding="UTF-8" ?>

<full_name>Arts</full_name>

<explanation>Indulge your artistic streak with some fabulously fun ideas! Hone your drawing and sketching skills, master the art of illusion and trickery, go digital or get crafty with these Do It Yourself videos!</explanation>

<title_tag>Discover DIY crafts, origami, magic, dance videos and more in 5min's Arts category.</title_tag>

<content_title>Get creative with how-to magic tricks and art and craft videos on 5min</content_title>

<content_description>Indulge your artistic streak with some fabulously fun ideas. From quick crafting ideas to performing magic tricks to becoming a digital art pro, find videos for any creative occasion. Watch and learn how to make amazing balloon art, create cool photography effects and much more.</content_description>

<meta_description>Find videos on how to make jewelry and craft projects, learn photography tricks, study digital art programs and more. Learn how to be creative and bring out your artistic side. Find great art videos on all topics from balloon art, party favors and crafts to dance and magic.</meta_description>

<meta_keywords>art, origami, dance, magic, tricks, party, balloon art, photography tricks, design gifts, cool experiments, create jewelry, party-tricks</meta_keywords>

</Category>

</Categories>

Making a Search Request

To access the data for a specific search, you simply request a URL from 5min.com and let us know what you want. The URLs are simple and can be built with the following format:

Making the URL

http://api.5min.com/search/search_term/request.format[?extra]

search_term	The search_term can either be free text, or 3 words separated by spaces for density search.
request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
extra	Optional. More parameters to sort/filter results. The different extra types are listed below.

Requests you can make

videos

Videos related to the specified search_term

Extras you can use (only for videos request)

num_of_videos	The number of videos in the current page.	25(default). Max size is 50.
page	If limited by num_of_videos to x page y will bring the next x results if exists.	page=y.
category_id	The name or id of the category to be searched.
categories_list	Comma separated category ids.
restriction	Restrict HTML in result (excluding CDATA).	no_html html(default)
allow_flagged	Include/exclude flagged videos.	true false(default)
search_type	In case of using a deeper search for 3 words only, use density	density normal(default).
sid	The syndicator id.
auto_start	The video starts playing automatically.	false(default) true.
overlay	Show sidebars as overlay on the video.	false true(default).
transcript	Include/exclude transcript for video.	false(default) true.
add_ons	Include/exclude add-ons for video.	false(default) true.
thumbnail_sizes	Include/exclude thumbnails sizes extracted for video.	false(default) true.
multiple_thumbnails	Include/exclude all thumbnails for video.	false(default) true.
width	Embed width value.	480(default).
height	Embed height value.	401(default).
video_language	Filter by language (Default is English).	en(English)(default). cn(Chinese) fr(French) jp(Japanese) es(Spanish) de(German/Deutch)
return_num_items	Total number of results for pagination..	false(default) true.
num_related_return	Number of related videos to return per video.	0(default). Max number is 20.
External_data	Get external video identification	false(default) true.
return_category_id	Add ID of category per video.	false(default) true.
start_date	Return only videos that were added from a specific date & time.	Date only format: yyyymmdd DateTime format: yyyymmddhhmmss
sort	The sorting method.	relevance (default) most_recent most_viewed

Example Request

To get a list of the videos related to "how to make a chocolate cake", you would make this request:

http://api.5min.com/search/how to make a chocolate cake/videos.xml

Example Response

Here's an example of the MRSS response from a videos call:

<?xml version="1.0" encoding=" UTF-8"?>

<title>Search results for "how to make a chocolate cake"</title>

<description>This feed contains the search results API for "how to make a chocolate cake"</description>

<image>

<url>http://shared.5min.com/Graphics/Logos/5min_logo.JPG</url>

</image>

<docs>http://backend.userland.com/rss</docs>

<item>

<title>How to Make a Chocolate Cake.</title>

<description>an easy guide for making a chocolate cake.</description>

<media:content url="http://5min.panthercustomer.com/69/6872.flv" type="video/flash" expression="sample" duration="275" bitrate="600" />

<media:title type="plain">How to Make a Chocolate Cake.</media:title>

<media:description type="html">an easy guide for making a chocolate cake.</media:description>

<media:thumbnail url="http://files.5min.com/Thumbnails/138/6872_13.jpg" height="100" width="150" />

<media:category label="Food/Desserts">Food/Desserts</media:category>

<media:credit role="author">RonJ</media:credit>

<media:keywords>Chocolate Cake,cake,chocolate,cooking,dessert,food<![CDATA[Chocolate Cake]]></media:keywords>

<media:player url="http://www.5min.com/Embeded/6872/" height="325" width="400"><![CDATA[<div style='text-align:center'><object width='480' height='401' id='FiveminPlayer'><param name='allowfullscreen' value='true'/><param name='allowScriptAccess' value='always'/><param name='movie' value='http://www.5min.com/Embeded/6872/'/><embed src='http://www.5min.com/Embeded/6872/' type='application/x-shockwave-flash' width='480' height='401' allowfullscreen='true' allowScriptAccess='always'></embed></object><br/><a href='http://www.5min.com/Video/How-to-Make-a-Chocolate-Cake-6872' style='font-family: Verdana;font-size: 10px;' target='_blank'>Chocolate Cake</a></div>]]></media:player>

<image>

<<title>How to Make a Chocolate Cake.</title>

<url>http://files.5min.com/Thumbnails/138/6872_13.jpg</url>

<description>an easy guide for making a chocolate cake.</description>

</image>

</item>

<item>

<title>How to bake a delicious chocolate cake</title>

<media:content url="http://5min.panthercustomer.com/53/5278.flv" type="video/flash" expression="sample" duration="285" bitrate="600" />

<media:title type="plain">How to bake a delicious chocolate cake</media:title>

<media:description type="html">So easy and you can even lick the bowl!</media:description>

<media:thumbnail url="http://files.5min.com/Thumbnails/106/5278_25.jpg" height="100" width="150" />

<media:category label="Food/Desserts">Food/Desserts</media:category>

<media:credit role="author">D-sert</media:credit>

<media:keywords>How to bake a chocolate cake,cake,chocolate,desserts,food,oven,sugar,water<![CDATA[How to bake a chocolate cake]]></media:keywords>

<media:player url="http://www.5min.com/Embeded/5278/" height="325" width="400"><![CDATA[<div style='text-align:center'><object width='480' height='401' id='Object1'><param name='allowfullscreen' value='true'/><param name='allowScriptAccess' value='always'/><param name='movie' value='http://www.5min.com/Embeded/5278/'/><embed src='http://www.5min.com/Embeded/5278/' type='application/x-shockwave-flash' width='480' height='401' allowfullscreen='true' allowScriptAccess='always'></embed></object><br/><a href='http://www.5min.com/Video/How-to-bake-a-delicious-chocolate-cake-5278' style='font-family: Verdana;font-size: 10px;' target='_blank'>How to bake a chocolate cake</a></div>]]></media:player>

<image>

<title>How to bake a delicious chocolate cake</title>

<url>http://files.5min.com/Thumbnails/106/5278_25.jpg</url>

</image>

</item>

</channel>

</rss>

Making a VideoSeed Request

To access the videoseed for a specific URL, you simply request a URL from 5min.com and let us know what you want. The URLs are simple and can be built with the following format:

Making the URL

http://api.5min.com/videoseed/request.format?url=site_url[&extra]

request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
site_url	The site URL.
extra	Optional. The different extra types are listed below.

Requests you can make

videos	Videos related to the specific URL
bulk	Bulk API call URL (for more details click here)

Extras you can use (only for videos request)

num_of_videos	The number of videos.	10(default). Max size is 10.
categories_list	The names or ids of categories to return, separated by commas
restriction	Restrict HTML in result (excluding CDATA).	no_html html(default)
sid	The syndicator id.
auto_start	The video starts playing automatically.	false(default) true.
overlay	Show sidebars as overlay on the video.	false true(default).
transcript	Include/exclude transcript for video.	false(default) true.
add_ons	Include/exclude add-ons for video.	false(default) true.
thumbnail_sizes	Include/exclude thumbnails sizes extracted for video.	false(default) true.
multiple_thumbnails	Include/exclude all thumbnails for video.	false(default) true.
width	Embed width value.	480(default).
height	Embed height value.	401(default).
video_language	Filter by language (Default is English).	en(English)(default). cn(Chinese) fr(French) jp(Japanese) es(Spanish) de(German/Deutch)
return_num_items	Total number of results for pagination.	false(default) true.
num_related_return	Number of related videos to return per video.	0(default). Max number is 20.
External_data	Get external video identification	false(default) true.
return_category_id	Add ID of category per video.	false(default) true.
fallback	In case there are no video results for the requested URL - Get video results from featured of the requested category (first).	false(default) true.

Example Request

To get the videoseed related to "http://www.google.com", you would make this request:

http://api.5min.com/VideoSeed/videos.xml?url=http://www.google.com&num_of_videos=1

Example Response

Here's an example of the MRSS response from a videos call:

<?xml version="1.0" encoding="utf-8"?>

<description>This feed contains the videos list API</description>

<image>

<url>http://localhost/Shared/Graphics/Logos/5min_logo.JPG</url>

</image>

<docs>http://backend.userland.com/rss</docs>

<item>

<title>Learn About the History of Google</title>

<description><a href="http://api.5min.com/Video/Learn-About-the-History-of-Google-38355573"><img height='100px' width = '150px' alt='' src="http://Files.5min.com/Thumbnails/767112/38355573_8.jpg"></a><p>This short video tells the history of Google, the leading search engine on the web, founded by Sergey Brin, and Larry Page.</p></description>

<media:content url="http://fivemin.vo.llnwd.net/o15/383556/38355573.flv" type="video/x-flv" expression="sample" duration="264" bitrate="600" />

<media:title type="plain">Learn About the History of Google</media:title>

<media:description type="html"><a href="http://api.5min.com/Video/Learn-About-the-History-of-Google-38355573"><img height='100px' width = '150px' alt='' src="http://Files.5min.com/Thumbnails/767112/38355573_8.jpg"></a><p>This short video tells the history of Google, the leading search engine on the web, founded by Sergey Brin, and Larry Page.</p></media:description>

<media:thumbnail url="http://files.5min.com/Thumbnails/767112/38355573_8.jpg" height="105" width="140" />

<media:category label="Tech/Web"<Tech/Web</media:category>

<media:credit role="author"><a href="http://api.5min.com/WatchMojo">WatchMojo</a></media:credit>

<media:rating>nonadult</media:rating>

<media:keywords>google,larry page,search engine,search results,sergey brin,watchmojo</media:keywords>

<media:player url="http://api.5min.com/Video/Learn-About-the-History-of-Google-38355573"><![CDATA[<div style='text-align:center'><object width='480' height='401' id='FiveminPlayer' classid='clsid:d27cdb6e-ae6d-11cf-96b8-444553540000'><param name='allowfullscreen' value='true'/><param name='allowScriptAccess' value='always'/><param name='movie' value='http://api.5min.com/Embeded/38355573/'/><embed src='http://api.5min.com/Embeded/38355573/' type='application/x-shockwave-flash' width='480' height='401' allowfullscreen='true' allowScriptAccess='always'></embed></object><br/><a href='http://api.5min.com/Video/Learn-About-the-History-of-Google-38355573' style='font-family: Verdana;font-size: 10px;' target='_blank'>Learn About the History of Google</a></div>]]></media:player>

<image>

<title>Learn About the History of Google</title>

<url>http://files.5min.com/Thumbnails/767112/38355573_8.jpg</url>

</image>

</item>

</channel>

</rss>

Making a MonthlyStats Request

To access the monthlyStats for your account, you simply request a URL from 5min.com and let us know what you want. The URLs are simple and can be built with the following format:

Making the URL

http://api.5min.com/monthlystats/partner_type/request.format[&extra]

partner_type	ContentOwner or SitePublisher
request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
extra	Optional. The different extra types are listed below.

Requests you can make

info	monthly statistic for current sid

Extras you must use

sid	The syndicator id.
token	your own token.
username	all - for administrative token holders username - for a specific user	all username
domain	all - for administrative token holders domain - for a specific domain	all domain
date (optional)	date format - yyyyMMdd	current month (default)

Example Request

To get your acount monthlyStats you would make this request:

http://api.5min.com/MonthlyStats/ContentOwner/info.xml?sid=your_sid&username=acount_name&token=your_token

Example Response

Here's an example of the XML response from a info call:

<?xml version="1.0" encoding="UTF-8"?>

<Video>

<VideoTitle>Download a ringtone with Boost Mobile</VideoTitle>

</Video>

</MonthlyStats>

Making a DailyStats Request

To access the dailyStats for your account, you simply request a URL from 5min.com and let us know what you want. The URLs are simple and can be built with the following format:

Making the URL

http://api.5min.com/dailystats/partner_type/request.format[&extra]

partner_type	ContentOwner or SitePublisher
request	The data you want. The different request types are listed below.
format	The data will be retrieved in the relevant format, for now XML only.
extra	Optional. The different extra types are listed below.

Requests you can make

info	monthly statistic for current sid

Extras you must use

sid	The syndicator id.
token	your own token.
username	all - for administrative token holders username - for a specific user	all username
domain	all - for administrative token holders domain - for a specific domain	all domain
start_date (optional)	date format - yyyyMMdd	30 days back(default)
end_date (optional)	date format - yyyyMMdd	yesterday(default)

Example Request

To get your acount dailyStats you would make this request:

http://api.5min.com/DailyStats/SitePublisher/info.xml?sid=your_sid&domain=your_domain.com&token=your_token

Example Response

Here's an example of the XML response from a info call:

this XML file does not appear to have any style information associated with it. The document tree is shown below.

<?xml version="1.0" encoding="UTF-8"?>

<Day>

</Day>

<Day>

</Day>

</DailyStats>