MRSS Importer Specifications

About this document

Purpose

This document is a specification of Dailymotion MRSS Importer and introduces how Dailymotion gets content and metadata from content provider.

Reference Documents

Reference	URL
XML 1.0 specification	http://www.w3.org/TR/REC-xml/
RSS 2.0 specification	http://www.rssboard.org/rss-specification
Media RSS specification	http://www.rssboard.org/media-rss
Dublin Core specification	http://dublincore.org/documents/dc-xml-guidelines/

Definitions

RSS format

Really Simple Syndication (RSS) is a Web content syndication format. It is a dialect of XML and all RSS files must conform to the XML 1.0 specification, as published on the World Wide Web Consortium (W3C) website.

MRSS format

Media RSS (MRSS) is an RSS extension used for syndicating multimedia files (audio, video, image) in RSS feeds. The format is used by content publishers to feed media files into distribution platforms.

Introduction

How does it work ?

The Dailymotion MRSS Importer allows a partner to upload (and update) their videos, making them viewable and searchable on Dailymotion.com without any manual intervention.
The partner must provide :

a feed structured in the Media RSS format (with or without login/password)
access to the repository hosting their videos (with or without login/password)
the associated Dailymotion account name

Once a partner has submitted his video feed to Dailymotion, we will periodically retrieve the feed to identify changes and merge them into our platform (update of the content already on line and upload of the new content). The frequency should be defined by the partner and the imports will occur preferably overnight (Central European Time). The feed provided can contain all items for each import or only new or updated items.

Preliminary steps for providers

The partner must :

create an account on Dailymotion.com
upload a video to test the encoding compatibility

In return, the Dailymotion technical team will :

test the compliance of the technical elements (mapping of the MRSS feed elements, access to the servers)
configure the import for the partner
launch the first import with a limited number of videos for partner testing and validation
schedule the import : timing and frequency will be decided with the partner and the content manager, some technical considerations must be taken in account to avoid issues :
- average file size of the source video (bigger = more time to download)
- bandwidth available for download
- average duration of the video (longer = more time to encode)
- number of new media per import

Architecture

Dailymotion supports multiple input formats and this specification introduces how to use the MRSS format.

Server should be accessible through :

HTTP(S) or
FTP(S) or
SFTP (you must add the port in each URL)

Import description (FTP Push/Pull - polling etc.)

Pull mode :

188.65.121.0/24 (dailymotion ip)

Dailymotion MRSS Tags

XML declaration

XML

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

Namespace declaration

Media RSS

<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">

DCMI

<rss version="2.0" xmlns:dcterms="http://purl.org/dc/terms/">

Dailymotion RSS

<rss version="2.0" xmlns:dm="http://www.dailymotion.com/dmrss/">

XML CDATA section

The term CDATA is used about text data that should not be parsed by the XML parser. A CDATA section starts with "<![CDATA[" and ends with "]]>".

CDATA (http://www.w3.org/TR/REC-xml/#sec-cdata-sect)

<description><![CDATA[Description of the video can be up to 2000 characters long and can contain html tags]]></description>

Channel tags

Dailymotion RSS Tag	Description	Value type	Example value
title	Name of the content provider	string	Universal Pictures
link	Website of the content provider	URL string	http://www.universalpictures.com/
description	Description of the content provider	string	Universal Pictures is an American motion picture studio
lastBuildDate	Last time the content of the feed changed	RFC 2822	Wed, 10 Jul 2013 11:00:00 -0400

Item tags

Dailymotion RSS Tag	Attribute	Description	Value type	Multiple	Example value	Required
title		Title of the video	string		Back to the Future	*
description		Description of the video	string		Back to the Future is a 1985 American science fiction film...
category	scheme="urn:dm:channel"	Dailymotion channel (list of values available)	string		shortfilms	*
guid	isPermaLink="false"	Unique and persistent identifier for the video that should be the primary key in the content provider database	string		12345_back_to_the_future	*
dcterms:valid		Date (or range) of validity of the video	ISO 8601		start=2013-07-10T12:35+00:00;end=2013-12-21T12:35+00:00;scheme=W3C-DTF
media:content	url	Direct link to the video	URL string		http://www.example.com/video/12345_back_to_the_future.mp4 ftp://login:password@server.com/video/12345_back_to_the_future.mp4	*
	width	Width of the video (px)	digit		1280
	height	Height of the video (px)	digit		720
	bitrate	Video bitrate in bytes	digit		3317
	filesize	Video filesize in bytes	digit		1326739508
	duration	Video duration in seconds	digit		6960
	type	MIME type of the video	string		video/quicktime
	lang	Language of the video ("en" by default)	ISO 3166		en
media:thumbnail	url	Direct link to the thumbnail (max filesize: 5Mo)	URL string		http://www.example.com/img/12345_back_to_the_future.jpg
	width	Width of the thumbnail (px)	digit		1280
	height	Height of the thumbnail (px)	digit		720
dm:poster	url	Direct link to the poster image	URL string		http://www.example.com/poster/12345_back_to_the_future.jpg
media:keywords	value	Relevant keyword or a list of keywords comma-delimited describing the video	string	x	DeLorean, Time Machine, Back to the Future
media:subTitle	href	Direct link to the subtitle file (.srt)	URL string	x	http://www.example.com/subtitles/12345_back_to_the_future.srt
	lang	Language of the subtitles	RFC 3066	x	en-us
	type="text/plain"	Subtitle type	string	x	text/plain
dm:content	type	Content type of the video (list of values available)	string		movie
media:category	scheme="urn:dm:genre"	Genre of the video (list of values available)	string	x	Science Fiction
media:category	value	ID (xid) of the Dailymotion playlist OR desired playlist name	string	x	x2qsde
	scheme="urn:dm:playlist"	URI that identifies the playlist scheme	URI		urn:dm:playlist
dm:show	value	Show name	string		Game of Thrones
	season	Season number/name	string		1
	episode	Episode number/name	string		2
media:copyright	value	Copyright information for the video	string		Copyright Universal Pictures
media:copyright	url	Copyright URL for the video	URL string		http://www.universalpictures.com/
media:restriction	value	Country codes (space-separated) For all countries : all	ISO 3166		us fr
	relationship	Indicates the type of relationship (allow \| deny)	string		allow
	type="country"	Allows restrictions to be placed based on country code	string		country
media:rating	value	Permissible audience to be declared (adult \| nonadult)	string		nonadult
	scheme	URI that identifies the rating scheme	URI		urn:simple
dm:visa	number	Visa number	string		60261
dm:original	value	Original title of the video	string		Back to the Future
	language	Original language of the video	ISO 3166		en
	country	Country code of the video	ISO 3166		us
dm:released	year	Date of release or production	RFC 2822		Wed, 03 Jul 1985 04:00:01 -0400
Music Metadatas
dm:music_artist		The name of the artist	string		Ellie Goulding
dm:music_artist_id		The ID of the artist given by the label	string		id323234343
dm:music_album		The name of the music album	string		Holcyon Days
dm:music_album_id		Identify the album from where the music comes from	string		1234-32131
dm:music_isrc		The International Standard Recording Code of the soundtrack associated to this video	string ISRC		FR-6V8-21-83311
dm:music_iswc		The International Standard Musical Work Code of the soundtrack associated to this video	string ISWC		T-034.524.680-1
dm:music_upc		The Universal Product Code of the soundtrack	string UPC		3610154759952
dm:music_genre		The genre of the soundtrack	string		Pop
dm:music_label		The name of the record label	string		Sony
dm:music_muyap		The MUYAP ID (Turkish Phonographic Industry Society Identifier) of the soundtrack	string		BXjVm33LBNCIGfS6GBNw4A==
dm:music_track_id		The ID of the track/clip given by the label	string		4234234-23
dm:music_itunes_id		The ID provided by itunes for this soundtrack	string		id483555052
Roles
media:credit	value	First name and last name of the actor	string	x	Michael J. Fox
	role=actor	Specify the role the entity played	string		actor
media:credit	value	First name and last name of the director	string	x	Robert Zemeckis
	role=director	Specify the role the entity played	string		director
media:credit	value	First name and last name of the producer	string	x	Neil Canton
	role=producer	Specify the role the entity played	string		producer
media:credit	value	First name and last name of the writer	string	x	Robert Zemeckis
	role=writer	Specify the role the entity played	string		writer
Dailymotion.com specific data
dm:private	value	Status if video is private or not	boolean		false
dm:advertising_instream_blocked	value	True if the owner blocked instream ads on this video.	boolean		true
dm:delete	value	Delete the video (source + encoded assets)	boolean		true

Content management

Update content

guid

<item>
  ...
  <guid isPermaLink="false">12345_back_to_the_future</guid>
  ...
</item>

Delete content

dm:delete

<item>
  ...
  <dm:delete>true</dm:delete>
  ...
</item>

Adding this field to your feed will automatically delete the video from your Dailymotion account on the next update of the injector. You can add the field anywhere in the <item> section of the video you wish to delete. The rest of the feed can remain the same.

Examples

Basic

<?xml version="1.0" encoding="UTF-8"?>
        <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dm="http://www.dailymotion.com/dmrss/">
            <channel>
                <title><![CDATA[Universal Pictures]]></title>
                <link>http://www.universalpictures.com/</link>
                <description><![CDATA[Universal Pictures is an American motion picture studio]]></description>
                <lastBuildDate>Wed, 10 Jul 2013 11:00:00 -0400</lastBuildDate>
                <item>
                    <title><![CDATA[Back to the Future]]></title>
                    <description><![CDATA[Back to the Future is a 1985 American science fiction film...]]></description>
                    <media:category scheme="urn:dm:channel">shortfilms</media:category>
                    <guid isPermaLink="false">12345_back_to_the_future</guid>
                    <media:content url="http://www.example.com/video/12345_back_to_the_future.mp4" width="1280" height="720" bitrate="3317" filesize="1326739508" duration="6960" type="video/quicktime" lang="en" />
                    <media:keywords><![CDATA[DeLorean, Time Machine, Back to the Future]]></media:keywords>
                </item>
            </channel>
        </rss>

Music Metadatas

<?xml version="1.0" encoding="UTF-8"?>
        <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dm="http://www.dailymotion.com/dmrss/">
            <channel>
                <title><![CDATA[Music channel]]></title>
                <link>http://www.dailymotion.com/</link>
                <description><![CDATA[Dailymotion Music Channel]]></description>
                <lastBuildDate>Wed, 10 Jul 2013 11:00:00 -0400</lastBuildDate>
                <item>
                    <title><![CDATA[Music title]]></title>
                    <description><![CDATA[Music description]]></description>
                    <media:category scheme="urn:dm:channel">music</media:category>
                    <guid isPermaLink="false">my_awesome_guid</guid>
                    <media:content url="http://www.example.com/video/my_awesome_video.mp4" width="1280" height="720" bitrate="3317" filesize="1326739508" duration="6960" type="video/quicktime" lang="en" />
                    <media:keywords><![CDATA[music, trending music, worldwide]]></media:keywords>
                    <dm:music_artist><![CDATA[artist_name]]></dm:music_artist>
                    <dm:music_artist_id><![CDATA[artist_id]]></dm:music_artist_id>
                    <dm:music_album><![CDATA[album_name]]></dm:music_album>
                    <dm:music_album_id><![CDATA[album_id]]></dm:music_album_id>
                    <dm:music_genre><![CDATA[genre_value]]></dm:music_genre>
                    <dm:music_isrc><![CDATA[isrc_value]]></dm:music_isrc>
                    <dm:music_upc><![CDATA[upc_value]]></dm:music_upc>
                    <dm:music_iswc><![CDATA[iswc_value]]></dm:music_iswc>
                    <dm:music_itunes_id><![CDATA[itunes_id]]></dm:music_itunes_id>
                    <dm:music_label><![CDATA[music label]]></dm:music_label>
                    <dm:music_muyap_id><![CDATA[muyap_value]]></dm:music_muyap>
                    <dm:music_track_id><![CDATA[track_id_value]]></dm:music_track_id>
                </item>
            </channel>
        </rss>

Movie

<?xml version="1.0" encoding="UTF-8"?>
        <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dm="http://www.dailymotion.com/dmrss/">
            <channel>
                <title><![CDATA[Universal Pictures]]></title>
                <link>http://www.universalpictures.com/</link>
                <description><![CDATA[Universal Pictures is an American motion picture studio]]></description>
                <lastBuildDate>Wed, 10 Jul 2013 11:00:00 -0400</lastBuildDate>
                <item>
                    <title><![CDATA[Back to the Future]]></title>
                    <description><![CDATA[Back to the Future is a 1985 American science fiction film...]]></description>
                    <media:category scheme="urn:dm:channel">shortfilms</media:category>
                    <guid isPermaLink="false">12345_back_to_the_future</guid>
                    <dcterms:valid>start=2013-07-10T12:35+00:00;end=2013-12-21T12:35+00:00;scheme=W3C-DTF</dcterms:valid>
                    <media:content url="http://www.example.com/video/12345_back_to_the_future.mp4" width="1280" height="720" bitrate="3317" filesize="1326739508" duration="6960" type="video/quicktime" lang="en" />
                    <media:thumbnail url="http://www.example.com/img/12345_back_to_the_future.jpg" width="1280" height="720" />
                    <dm:poster url="http://www.example.com/poster/12345_back_to_the_future.jpg" />
                    <media:subTitle type="text/plain" lang="en-us" href="http://www.example.com/subtitles/12345_back_to_the_future.srt" />
                    <media:category scheme="urn:dm:genre">Science Fiction</media:category>
                    <media:category scheme="urn:dm:genre">Adventure film</media:category>
                    <media:category scheme="urn:dm:genre">Comedy</media:category>
                    <media:keywords><![CDATA[DeLorean, Time Machine, Back to the Future]]></media:keywords>
                    <media:copyright url="http://www.universalpictures.com/"><![CDATA[Copyright Universal Pictures]]></media:copyright>
                    <media:restriction relationship="allow" type="country">us fr</media:restriction>
                    <media:rating scheme="urn:simple">nonadult</media:rating>
                    <dm:visa number="60261" />
                    <dm:original language="en" country="us"><![CDATA[Back to the Future]]></dm:original>
                    <dm:content type="movie" />
                    <dm:product id="universal_back_to_the_future" />
                    <media:credit role="actor"><![CDATA[Michael J. Fox]]></media:credit>
                    <media:credit role="actor"><![CDATA[Christopher Lloyd]]></media:credit>
                    <media:credit role="actor"><![CDATA[Lea Thompson]]></media:credit>
                    <media:credit role="actor"><![CDATA[Crispin Glover]]></media:credit>
                    <media:credit role="director"><![CDATA[Robert Zemeckis]]></media:credit>
                    <media:credit role="producer"><![CDATA[Neil Canton]]></media:credit>
                    <media:credit role="producer"><![CDATA[Bob Gale]]></media:credit>
                    <media:credit role="writer"><![CDATA[Robert Zemeckis]]></media:credit>
                    <media:credit role="writer"><![CDATA[Bob Gale]]></media:credit>
                    <dm:released year="1985" />
                    <media:category scheme="urn:dm:playlist">x2qsde</media:category>
                </item>
            </channel>
        </rss>

TV Show

<?xml version="1.0" encoding="UTF-8"?>
        <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dm="http://www.dailymotion.com/dmrss/">
            <channel>
                <title><![CDATA[HBO - Game of Thrones]]></title>
                <link>http://www.hbo.com/game-of-thrones/index.html</link>
                <description><![CDATA[It’s not TV. It’s HBO]]></description>
                <lastBuildDate>Wed, 10 Jul 2013 11:00:00 -0400</lastBuildDate>
                <item>
                    <title><![CDATA[Game of Thrones - Winter Is Coming]]></title>
                    <description><![CDATA[Robert Baratheon (King of the Seven Kingdoms of Westeros) and his Queen, Cersei Lannister...]]></description>
                    <media:category scheme="urn:dm:channel">tv</media:category>
                    <guid isPermaLink="false">12345_got_s01_e01</guid>
                    <dcterms:valid>start=2013-07-10T12:35+00:00;end=2013-12-21T12:35+00:00;scheme=W3C-DTF</dcterms:valid>
                    <media:content url="http://www.example.com/video/12345_got_s01_e01.mp4" width="1280" height="720" bitrate="3317" filesize="1326739508" duration="6960" type="video/quicktime" lang="en" />
                    <media:thumbnail url="http://www.example.com/img/12345_got_s01_e01.jpg" width="1280" height="720" />
                    <media:subTitle type="text/plain" lang="en-us" href="http://www.example.com/subtitles/12345_got_s01_e01.srt" />
                    <media:category scheme="urn:dm:genre">Fantasy</media:category>
                    <media:keywords><![CDATA[Winter Is Coming, Westeros, Ned Stark]]></media:keywords>
                    <media:copyright url="http://www.hbo.com/"><![CDATA[HBO]]></media:copyright>
                    <media:restriction relationship="allow" type="country">us fr</media:restriction>
                    <media:rating scheme="urn:simple">nonadult</media:rating>
                    <dm:visa number="89753" />
                    <dm:original language="en" country="us"><![CDATA[Game of Thrones - Winter Is Coming]]></dm:original>
                    <dm:content type="tvshow" />
                    <dm:show season="1" episode="2"><![CDATA[Game of Thrones]]></dm:show>
                    <dm:product id="hbo_got_s01_e01" />
                    <media:credit role="actor"><![CDATA[Sean Bean]]></media:credit>
                    <media:credit role="actor"><![CDATA[Michelle Fairley]]></media:credit>
                    <media:credit role="actor"><![CDATA[Peter Dinklage]]></media:credit>
                    <media:credit role="director"><![CDATA[Tim Van Patten]]></media:credit>
                    <media:credit role="producer"><![CDATA[Mark Huffam]]></media:credit>
                    <media:credit role="producer"><![CDATA[Frank Doelger]]></media:credit>
                    <media:credit role="writer"><![CDATA[David Benioff]]></media:credit>
                    <media:credit role="writer"><![CDATA[D. B. Weiss]]></media:credit>
                    <dm:released year="2011" />
                    <media:category scheme="urn:dm:playlist">x2qsde</media:category>
                </item>
            </channel>
        </rss>

Appendix

Video source settings

Standard Definition
Video codec	Video resolution	Video bitrate	Video framerate	Audio codec	Audio bitrate	Container
H.264, DivX, WMV9, progressive MPEG-2	640x480 (4:3) or 720x480 (16:9)	1,2 to 3Mbps	25fps	AAC, MP3, WMA9, MPEG Layer 2	256 Kbps AAC or 320 Kbps stereo MP3 (ideal), 128 Kbps stereo AAC or 192 Kbps stereo MP3 (minimum); 44100Hz	MP4, AVI, MOV

Video codec	Video resolution	Video bitrate	Video framerate	Audio codec	Audio bitrate	Container
High Definition
H.264 preferred, VC-1 acceptable	1280x720 (720p) or 1920x1080 (1080p)	2 Mbps minimum, 4 Mbps maximum	25fps	AAC, MP3, WMA9, MPEG Layer 2	256 Kbps AAC or 320 Kbps stereo MP3 (ideal), 128 Kbps stereo AAC or 192 Kbps stereo MP3 (minimum); 44100Hz	MP4, AVI, MOV

Content Type

Label	Movie	TV Show
Value	movie	tvshow

Dailymotion Categories

Label	Animals	Arts	Auto-Moto	Campus	Celeb	Funny	Gaming	Geek out	Kids	Lifestyle	Movies	Music	News	Sports	TV	Travel	Webcam
Value	animals	creation	auto	school	people	fun	videogames	tech	kids	lifestyle	shortfilms	music	news	sport	tv	travel	webcam

Dailymotion Genre for Movies

Label	Drama	Comedy	Short film	Documentary	Romance	Thriller	Action	Crime Fiction	Animation	Indie film	Horror	Black and white	Family	Music	Adventure	Musical	Sports	Mystery	Science Fiction	War film	Fantasy	Japanese movies	Western	History	Film noir
Value	drama	comedy	shortfilms	documentary	romance	thriller	action	crimefiction	animation	indie	horror	blackandwhite	family	music	adventure	musical	sports	mystery	sciencefiction	war	fantasy	japanese	western	history	filmnoir

Dailymotion Genre for TV Show

Label	Drama	Comedy	Reality television	Animation	Documentary	Sitcom	Game show	Science Fiction	Talk show	Fantasy	Action	Anime	Adventure	Soap opera	Miniseries	News	Crime Fiction	Romance	Sports	Variety show	Thriller	Music
Value	drama	comedy	realitytelevision	animation	documentary	sitcom	gameshow	sciencefiction	talkshow	fantasy	action	anime	adventure	soapopera	miniseries	news	crimefiction	romance	sports	variety	thriller	music

Dailymotion outgoing IP address blocks

The Dailymotion outgoing IP address blocks must be allowed on the remote server for HTTP/FTP:

For polling the MRSS feed
For downloading the files : video sources, thumbnails, subtitles etc.

Dailymotion outgoing IP address blocks:

188.65.120.0 / 21
195.8.214.0 / 23
198.54.200.0 / 23