Import content via MRSS feed

Introduction

Dailymotion offers the possibility to migrate your existing video catalog to our platform using an MRSS feed.

MRSS feeds simplify the process of importing and updating video catalogs by providing Dailymotion with a structured and standardized way to communicate metadata and media links. This way, your video catalog can be migrated and updated while being available on multiple platforms without the need to manually upload content.

In this article, we’ll walk you through the process of preparing your MRSS feed for the migration with all required information.



Prerequisites

Make sure to complete the following requirements before moving forward with the other steps:



Migration steps


1. Prepare your server

In order for Dailymotion to access your video catalog, please make sure your server follows the below requirements:

Input formatsDailymotion supports the following input formats for content ingestion:
  • HTTP(S)
  • FTP(S)
  • SFTP (in this case, please add port information in each URL for proper access).
Content accessibilityDailymotion will actively pull the content from your server: if you have blockers in place preventing content accessibility from external IPs, make sure your server is configured to allow “Pull mode” requests, and that Dailymotion IPs are authorized:
  • 188.65.120.0 / 21
  • 195.8.214.0 / 23
  • 198.54.200.0 / 23

2. Prepare your MRSS feed

Declaration

Include the following declarations at the top of your MRSS feed to indicate the XML file format and namespace used.

XML declaration

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

Namespace declaration

<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
<rss version="2.0" xmlns:dcterms="http://purl.org/dc/terms/">
<rss version="2.0" xmlns:dm="http://www.dailymotion.com/dmrss/">

MRSS tags

MRSS feeds must include metadata about each video item, such as title, description, media URL and any other relevant information.

Your MRSS feed needs to include an <item>v entry for each video in your catalog, and to be structured in a way that aligns with MRSS requirements.

CDATA sections

If you need to include in the tags text that might contain characters or symbols that could be misinterpreted as XML markup, we recommend using CDATA sections.

A CDATA section starts with <![CDATA[ and ends with ]]>.

<description><![CDATA[Description of the video can be up to 2000 characters long and can contain line breaks using the <br> html tag]]></description>

Required items

Each MRSS feed must include the following item tags to be processed by our service:

  • <title> – Defines the video title displayed on Dailymotion.
  • <category> – Defines the video category (list of categories).
  • <guid> – A unique key set on your database to link the Dailymotion video and your video.
  • <media:content url=""> – Direct link to the video hosted on your properties.

Available tags

If you want to add more metadata about your content, the following tags can be defined. See an example of an MRSS feed here.

Channel tags
Dailymotion RSS tagDescriptionValue type
titleName of the content provider.
Ex: Universal Pictures
string
linkWebsite of the content provider.
Ex:http://www.universalpictures.com/
URL string
descriptionDescription of the content provider.
Ex: Universal Pictures is an American motion picture studio
string
lastBuildDateLast time the content of the feed changed.
Ex: Wed, 10 Jul 2013 11:00:00 -0400
RFC 2822

Item tags - General

*required tags

Dailymotion RSS tagAttributeDescriptionValue type
title*Title of the video.
Ex: Back to the Future
string
descriptionDescription of the video.
Ex: Back to the Future is a 1985 American science fiction film
string
category*scheme="urn:dm:channel"Dailymotion channel (list of categories).
Ex: news
string
guid*isPermaLink="false"Unique and persistent identifier for the video that should be the primary key in the content provider database.
Ex: 12345_back_to_the_future
string
dcterms:validDate (or range) of validity of the video.
Ex: start=2013-07-10T12:35+00:00;end=2013-12-21T12:35+00:00;scheme=W3C-DTF
ISO 8601
media:content*url*Direct link to the video
Ex:
http://www.example.com/video/12345_back_to_the_future.mp4
ftp\://login:[email protected]/video/12345\_back\_to\_the\_future.mp4
URL string
widthWidth of the video (px).
Ex: 1280
digit
heightHeight of the video (px).
Ex: 720
digit
bitrateVideo bitrate in bytes.
Ex: 3317
digit
filesizeVideo filesize in bytes.
Ex: 1326739508
digit
durationVideo duration in seconds.
Ex: 6960
digit
typeMIME type of the video.
Ex: video/quicktime
string
langLanguage of the video (“en” by default).
Ex: en
ISO 639-1
media:thumbnailurlDirect link to the thumbnail (max filesize: 5Mo).
Ex: http://www.example.com/img/12345_back_to_the_future.jpg
URL string
widthWidth of the thumbnail (px).
Ex: 1280
digit
heightHeight of the thumbnail (px).
Ex: 720
digit
dm:posterurlDirect link to the poster image.
Ex: http://www.example.com/poster/12345_back_to_the_future.jpg
URL string
media:keywordsvalueRelevant keyword or a list of keywords comma-delimited describing the video. Multiple values can be passed.
Ex: DeLorean, Time Machine, Back to the Future
string
media:subTitlehrefDirect link to the subtitle file (.srt). Multiple values can be passed.
Ex: http://www.example.com/subtitles/12345_back_to_the_future.srt
URL string
langLanguage of the subtitles. Multiple values can be passed.
Ex: en-us
RFC 3066
type="text/plain"Subtitle type. Multiple values can be passed.
Ex: text/plain
string
media:categoryvalueID (xid) of the Dailymotion playlist OR desired playlist name. Multiple values can be passed.
Ex: x2qsde
string
scheme="urn:dm:playlist"URI that identifies the playlist scheme.
Ex: urn:dm:playlist
URI
valueShow name.
Ex: Game of Thrones
string
seasonSeason number/name.
Ex: 1
string
episodeEpisode number/name.
Ex: 2
string
media:copyrightvalueCopyright information for the video.
Ex: Copyright Universal Pictures
string
urlCopyright URL for the video.
Ex: http://www.universalpictures.com/
URL string
media:restrictionvalueCountry codes (space-separated). For all countries : all
Ex: us fr
ISO 3166 Alpha-2
relationshipIndicates the type of relationship (allow | deny).
Ex: allow
string
type="country"Ex: type=”country”string
media:ratingvaluePermissible audience to be declared.
(adult | nonadult)
Ex: nonadult
string
schemeURI that identifies the rating scheme.
Ex: urn:simple
URI
numberVisa number.
Ex: 60261
string
valueOriginal title of the video.
Ex: Back to the Future
string
languageOriginal language of the video.
Ex: en
ISO 639-1
countryCountry code of the video.
Ex: us
ISO 3166 Alpha-2
dm:releasedyearDate of release or production.
Ex: Wed, 03 Jul 1985 04:00:01 -0400
RFC 2822

Item tags - Music
Dailymotion RSS tagDescriptionValue type
dm:music_artistThe name of the artist.
Ex: Ellie Goulding
string
dm:music_artist_idThe ID of the artist given by the label.
Ex: id323234343
string
dm:music_albumThe name of the music album.
Ex: Holcyon Days
string
dm:music_album_idIdentify the album from where the music comes from.
Ex: 1234-32131
string
dm:music_isrcThe International Standard Recording Code of the soundtrack associated to this video.
Ex: FR-6V8-21-83311
string
ISRC
dm:music_iswcThe International Standard Musical Work Code of the soundtrack associated to this video.
Ex: T-034.524.680-1
string
ISWC
dm:music_upcThe Universal Product Code of the soundtrack.
Ex: 3610154759952
string
UPC
dm:music_genreThe genre of the soundtrack.
Ex: Pop
string
dm:music_labelThe name of the record label.
Ex: Sony
string
dm:music_muyapThe MUYAP ID (Turkish Phonographic Industry Society Identifier) of the soundtrack.
Ex: BXjVm33LBNCIGfS6GBNw4A==
string
dm:music_track_idThe ID of the track/clip given by the label.
Ex: 4234234-23
string
dm:music_itunes_idThe ID provided by iTunes for this soundtrack.
Ex: id483555052
string

Item tags - Movie roles
Dailymotion RSS tagAttributeDescriptionValue type
media:creditvalueFirst name and last name of the actor. Multiple values can be passed.
Ex: Michael J. Fox
string
role=actorSpecify the role the entity played.
Ex: actor
string
valueFirst name and last name of the director. Multiple values can be passed.
Ex: Robert Zemeckis
string
role=directorSpecify the role the entity played.
Ex: director
string
media:creditvalueFirst name and last name of the producer. Multiple values can be passed.
Ex: Neil Canton
string
role=producerSpecify the role the entity played.
Ex: producer
string
media:creditvalueFirst name and last name of the writer. Multiple values can be passed.
Ex: Robert Zemeckis
string
role=writerSpecify the role the entity played.
Ex: writer
string

Dailymotion.com specific data
Dailymotion RSS tagDescriptionValue type
dm:privateStatus if video is private or not.
Ex: false
boolean
dm:advertising\_instream\_blockedTrue if the owner blocked instream ads on this video.
Ex: true
boolean
dm:deleteDelete the video (source + encoded assets).
Ex: true
boolean

3. Share your MRSS feed

You can now share the following information to your Dailymotion Account Manager so our technical team can start processing your catalog ingestion:

  • Your MRSS feed URL (with login/password if needed).
  • The Dailymotion channel where the content will be ingested.
  • The frequency defining how often the MRSS feed should be crawled.



Technical specifications


Standard definitionHigh definition
Video codecH.264
DivX
WMV9
Progressive MPEG-2
H.264 preferred
VC-1 acceptable
Video resolution640×480 (4:3)
720×480 (16:9)
1280×720 (720p)
1920×1080 (1080p)
Video bitrateMin: 1,2 Mbps
Max: 3 Mbps
Min: 2 Mbps
Max: 4 Mbps
Video framerate25 fps25 fps
Audio codecAAC
MP3
WMA9
MPEG Layer 2
AAC
MP3
WMA9
MPEG Layer 2
Audio bitrate

Recommended: 256 Kbps AAC or 320 Kbps stereo MP3.

Minimum: 128 Kbps stereo AAC or 192 Kbps stereo MP3.

44100Hz

Recommended: 256 Kbps AAC or 320 Kbps stereo MP3.

Minimum: 128 Kbps stereo AAC or 192 Kbps stereo MP3.

44100Hz

ContainerMP4
AVI
MOV
MP4
AVI
MOV

Feed example

<?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>

Did this page help you?