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:
- Subscribe to Dailymotion Pro Enterprise.
- Get in touch with your Dailymotion Account Manager to define your needs for the migration
- Upload a video to test the encoding compatibility
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:
|
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:
|
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 |
|---|---|---|
| Name of the content provider. Ex: Universal Pictures | string |
| Website of the content provider.
Ex: | URL string |
| Description of the content provider. Ex: Universal Pictures is an American motion picture studio | string |
| Last time the content of the feed changed. Ex: Wed, 10 Jul 2013 11:00:00 -0400 |
Item tags - General
*required tags
Dailymotion RSS tag | Attribute | Description | Value type |
|---|---|---|---|
| Title of the video. Ex: Back to the Future | string | |
| Description of the video. Ex: Back to the Future is a 1985 American science fiction film | string | |
|
| Dailymotion channel (list of categories). Ex: news | string |
|
| 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 |
| 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 | ||
|
| Direct link to the video | URL string |
| Width of the video (px). Ex: 1280 | digit | |
| Height of the video (px). Ex: 720 | digit | |
| Video bitrate in bytes. Ex: 3317 | digit | |
| Video filesize in bytes. Ex: 1326739508 | digit | |
| Video duration in seconds. Ex: 6960 | digit | |
| MIME type of the video. Ex: video/quicktime | string | |
| Language of the video (“en” by default). Ex: en | ||
|
| Direct link to the thumbnail (max filesize: 5Mo).
Ex: | URL string |
| Width of the thumbnail (px). Ex: 1280 | digit | |
| Height of the thumbnail (px). Ex: 720 | digit | |
|
| Direct link to the poster image.
Ex: | URL string |
| 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 |
|
| Direct link to the subtitle file (.srt). Multiple values can be passed.
Ex: | URL string |
| Language of the subtitles. Multiple values can be passed. Ex: en-us | ||
| Subtitle type. Multiple values can be passed. Ex: text/plain | string | |
| value | ID (xid) of the Dailymotion playlist OR desired playlist name. Multiple values can be passed. Ex: x2qsde | string |
| URI that identifies the playlist scheme. Ex: urn:dm:playlist | URI | |
value | Show name. Ex: Game of Thrones | string | |
| Season number/name. Ex: 1 | string | |
| Episode number/name. Ex: 2 | string | |
| value | Copyright information for the video. Ex: Copyright Universal Pictures | string |
| Copyright URL for the video.
Ex: | URL string | |
| value | Country codes (space-separated). For all countries : | |
| Indicates the type of relationship (allow | deny). Ex: allow | string | |
| Ex: type=”country” | string | |
| value | Permissible audience to be declared. (adult | nonadult) Ex: nonadult | string |
| URI that identifies the rating scheme. Ex: urn:simple | URI | |
| Visa number. Ex: 60261 | string | |
value | Original title of the video. Ex: Back to the Future | string | |
| Original language of the video. Ex: en | ||
| Country code of the video. Ex: us | ||
|
| Date of release or production. Ex: Wed, 03 Jul 1985 04:00:01 -0400 |
Item tags - Music
Dailymotion RSS tag | Description | Value type |
|---|---|---|
| The name of the artist. Ex: Ellie Goulding | string |
| The ID of the artist given by the label. Ex: id323234343 | string |
| The name of the music album. Ex: Holcyon Days | string |
| Identify the album from where the music comes from. Ex: 1234-32131 | string |
| The International Standard Recording Code of the soundtrack associated to this video. Ex: FR-6V8-21-83311 | string ISRC |
| The International Standard Musical Work Code of the soundtrack associated to this video. Ex: T-034.524.680-1 | string ISWC |
| The Universal Product Code of the soundtrack. Ex: 3610154759952 | string UPC |
| The genre of the soundtrack. Ex: Pop | string |
| The name of the record label. Ex: Sony | string |
| The MUYAP ID (Turkish Phonographic Industry Society Identifier) of the soundtrack. Ex: BXjVm33LBNCIGfS6GBNw4A== | string |
| The ID of the track/clip given by the label. Ex: 4234234-23 | string |
| The ID provided by iTunes for this soundtrack. Ex: id483555052 | string |
Item tags - Movie roles
Dailymotion RSS tag | Attribute | Description | Value type |
|---|---|---|---|
| value | First name and last name of the actor. Multiple values can be passed. Ex: Michael J. Fox | string |
| 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 | |
| Specify the role the entity played. Ex: director | string | |
| value | First name and last name of the producer. Multiple values can be passed. Ex: Neil Canton | string |
| Specify the role the entity played. Ex: producer | string | |
| value | First name and last name of the writer. Multiple values can be passed. Ex: Robert Zemeckis | string |
| Specify the role the entity played. Ex: writer | string |
Dailymotion.com specific data
Dailymotion RSS tag | Description | Value type |
|---|---|---|
| Status if video is private or not. Ex: false | boolean |
| True if the owner blocked instream ads on this video. Ex: true | boolean |
| 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 | MP4 |
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>Updated 12 days ago
