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 formats

Dailymotion 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 accessibility

Dailymotion 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 tag

Description

Value type

title

Name of the content provider. Ex: Universal Pictures

string

link

Website of the content provider. Ex:http://www.universalpictures.com/

URL string

description

Description of the content provider. Ex: Universal Pictures is an American motion picture studio

string

lastBuildDate

Last 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 tag

Attribute

Description

Value type

title*

Title of the video. Ex: Back to the Future

string

description

Description 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:valid

Date (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

width

Width of the video (px). Ex: 1280

digit

height

Height of the video (px). Ex: 720

digit

bitrate

Video bitrate in bytes. Ex: 3317

digit

filesize

Video filesize in bytes. Ex: 1326739508

digit

duration

Video duration in seconds. Ex: 6960

digit

type

MIME type of the video. Ex: video/quicktime

string

lang

Language of the video (“en” by default). Ex: en

ISO 639-1

media:thumbnail

url

Direct link to the thumbnail (max filesize: 5Mo). Ex: http://www.example.com/img/12345_back_to_the_future.jpg

URL string

width

Width of the thumbnail (px). Ex: 1280

digit

height

Height of the thumbnail (px). Ex: 720

digit

dm:poster

url

Direct link to the poster image. Ex: http://www.example.com/poster/12345_back_to_the_future.jpg

URL string

media:keywords

value

Relevant 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:subTitle

href

Direct 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

lang

Language 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:category

value

ID (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

value

Show name. Ex: Game of Thrones

string

season

Season number/name. Ex: 1

string

episode

Episode number/name. Ex: 2

string

media:copyright

value

Copyright information for the video. Ex: Copyright Universal Pictures

string

url

Copyright URL for the video. Ex: http://www.universalpictures.com/

URL string

media:restriction

value

Country codes (space-separated). For all countries : all Ex: us fr

ISO 3166 Alpha-2

relationship

Indicates the type of relationship (allow | deny). Ex: allow

string

type="country"

Ex: type=”country”

string

media:rating

value

Permissible audience to be declared. (adult | nonadult) Ex: nonadult

string

scheme

URI that identifies the rating scheme. Ex: urn:simple

URI

number

Visa number. Ex: 60261

string

value

Original title of the video. Ex: Back to the Future

string

language

Original language of the video. Ex: en

ISO 639-1

country

Country code of the video. Ex: us

ISO 3166 Alpha-2

dm:released

year

Date of release or production. Ex: Wed, 03 Jul 1985 04:00:01 -0400

RFC 2822


Item tags - Music

Dailymotion RSS tag

Description

Value type

dm:music_artist

The name of the artist. Ex: Ellie Goulding

string

dm:music_artist_id

The ID of the artist given by the label. Ex: id323234343

string

dm:music_album

The name of the music album. Ex: Holcyon Days

string

dm:music_album_id

Identify the album from where the music comes from. Ex: 1234-32131

string

dm:music_isrc

The International Standard Recording Code of the soundtrack associated to this video. Ex: FR-6V8-21-83311

string ISRC

dm:music_iswc

The International Standard Musical Work Code of the soundtrack associated to this video. Ex: T-034.524.680-1

string ISWC

dm:music_upc

The Universal Product Code of the soundtrack. Ex: 3610154759952

string UPC

dm:music_genre

The genre of the soundtrack. Ex: Pop

string

dm:music_label

The name of the record label. Ex: Sony

string

dm:music_muyap

The MUYAP ID (Turkish Phonographic Industry Society Identifier) of the soundtrack. Ex: BXjVm33LBNCIGfS6GBNw4A==

string

dm:music_track_id

The ID of the track/clip given by the label. Ex: 4234234-23

string

dm:music_itunes_id

The ID provided by iTunes for this soundtrack. Ex: id483555052

string


Item tags - Movie roles

Dailymotion RSS tag

Attribute

Description

Value type

media:credit

value

First name and last name of the actor. Multiple values can be passed. Ex: Michael J. Fox

string

role=actor

Specify the role the entity played. Ex: actor

string

value

First name and last name of the director. Multiple values can be passed. Ex: Robert Zemeckis

string

role=director

Specify the role the entity played. Ex: director

string

media:credit

value

First name and last name of the producer. Multiple values can be passed. Ex: Neil Canton

string

role=producer

Specify the role the entity played. Ex: producer

string

media:credit

value

First name and last name of the writer. Multiple values can be passed. Ex: Robert Zemeckis

string

role=writer

Specify the role the entity played. Ex: writer

string


Dailymotion.com specific data

Dailymotion RSS tag

Description

Value type

dm:private

Status if video is private or not. Ex: false

boolean

dm:advertising\_instream\_blocked

True if the owner blocked instream ads on this video. Ex: true

boolean

dm:delete

Delete 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 definition

High definition

Video codec

H.264 DivX WMV9 Progressive MPEG-2

H.264 preferred VC-1 acceptable

Video resolution

640×480 (4:3) 720×480 (16:9)

1280×720 (720p) 1920×1080 (1080p)

Video bitrate

Min: 1,2 Mbps Max: 3 Mbps

Min: 2 Mbps Max: 4 Mbps

Video framerate

25 fps

25 fps

Audio codec

AAC 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

Container

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