Migrate video catalog 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
As a Partner, make sure to complete the following requirements before moving forward with the other steps:
- Create an account on Dailymotion.com
- Get in touch with your Dailymotion Account Manager to define your needs for the migration
- Upload a video to test the encoding compatibility
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
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/">
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>
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:password@server.com/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 | |
dm:show | 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 | |
dm:visa | number | Visa number Ex: 60261 | string |
dm:original | 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 |
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 |
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 | |
media:credit | 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>