DailymotionのRSSを利用した動画検索API

Dailymotionの検索結果はすべてRSSとして取得できるため、これを利用して検索APIのように利用できます。

リクエスト

RSSのURLは、

http://www.dailymotion.com/rss/地域/パラメータ/値/ソート-日時/ページ

のような形式になります。

基本的なパラメータ

パラメータ	説明
search	キーワード
channel	チャンネル
tag	タグ

パラメータの値はスラッシュ ( / ) で区切って指定します。たとえば「music」というタグを指定するならば、

http://www.dailymotion.com/rss/tag/music

のようにします。キーワードはURLエンコードして指定します。

検索結果の並べ替え

並べ替え (ソート)

次のいずれかのキーワードをURLに付加することで、検索結果の取得順位を変更できます。

[未指定] : 投稿日時が新しい順
visited : 再生数が多い順
rated : 評価の高い順
popular : 人気順
commented : コメントの多い順
discussed :
featured : 注目の高い順
relevance : 関連のある順

再生数が多い順に取得するならば、

http://www.dailymotion.com/rss/visited

のようにします。

アップロード日時

並べ替えを指定した場合には、アップロードの日時で検索結果を制限できます。

[未指定] : すべて
month : 1か月以内
week : 1週間以内
today : 24時間以内

1か月以内にアップロードされた動画に制限するならば、

http://www.dailymotion.com/rss/visited-month

のようにします。並べ替えのキーワードに続けて、ハイフン (-) で続けて記述します。

検索対象とする地域の制限

地域を指定して検索できます。たとえば「日本」を対象とするならば、

http://www.dailymotion.com/rss/jp

のように国コード[jp]を指定します。

検索結果のページ指定

検索結果の続きを取得するには、末尾にページ番号を付加します。たとえば検索結果の2ページ目を取得するには、

http://www.dailymotion.com/rss/2

のようにします。

パラメータの調べ方

パラメータの詳細は、検索結果ページの上部にある[RSSに登録]のURLを調べることでわかります。

RSSのURLは、検索結果ページのURLのホスト名に続けて「rss/」というパスを追加したものになっています。つまり、

http://www.dailymotion.com/rated/1

というページのRSSは、

http://www.dailymotion.com/rss/rated/1

というURLになります。

レスポンス

RSSの取得結果は、次のようなXML文書となります。

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:itunes="" xmlns:media="" xmlns:dm="">
  <channel>
    <title></title>
    <link></link>
    <description></description>
    <itunes:subtitle></itunes:subtitle>
    <itunes:summary></itunes:summary>
    <itunes:owner>
      <itunes:name></itunes:name>
      <itunes:email></itunes:email>
    </itunes:owner>
    <itunes:author></itunes:author>
    <itunes:image href=""/>
    <itunes:explicit></itunes:explicit>
    <itunes:category text="" />
    <language></language>
    <lastBuildDate></lastBuildDate>
    <image>
      <url></url>
      <title></title>
      <link></link>
      <width></width>
      <height></height>
    </image>
    <dm:link rel="uql" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_featured" title="注目の動画" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_buzz" title="今一番ホット" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_hd" title="HD画像コンテンツ" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_official" title="オフィシャルコンテンツ" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_creative" title="クリエイティブコンテンツ" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_recent" title="投稿日時が新しい順" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_visited-week" title="再生数が多い順" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_rated-week" title="評価の高い順" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_30" title="月" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_7" title="週" href="" type="application/rss+xml"/>
    <dm:link rel="sort_by_1" title="今日" href="" type="application/rss+xml"/>
    <dm:link rel="up" href="" type="application/rss+xml"/>
    <dm:link rel="next" href="" type="application/rss+xml"/>
    <dm:link rel="nextUql" href="" type="application/rss+xml"/>
    <item>
      <title></title>
      <link></link>
      <description></description>
      <author></author>
      <itunes:author></itunes:author>
      <itunes:explicit></itunes:explicit>
      <itunes:summary></itunes:summary>
      <itunes:subtitle></itunes:subtitle>
      <dm:videorating></dm:videorating>
      <dm:videovotes></dm:videovotes>
      <dm:link rel="" href="" type=""/>
      <dm:link rel="" href="" type=""/>
      <dm:views></dm:views>
      <dm:comments></dm:comments>
      <dm:favorites></dm:favorites>
      <dm:id></dm:id>
      <dm:author></dm:author>
      <dm:loggerURL></dm:loggerURL>
      <dm:authorAvatar></dm:authorAvatar>
      <dm:relativeDate></dm:relativeDate>
      <dm:channels></dm:channels>
      <pubDate></pubDate>
      <guid></guid>
      <media:title></media:title>
      <media:credit></media:credit>
      <media:thumbnail url="" height="" width="" />
      <media:player url="" height="" width=""></iframe></media:player>
      <media:group>
        <media:content url="" type="" duration="" width="" height=""/>
        <media:content url="" type="" duration="" width="" height=""/>
        <media:content url="" type="" duration="" width="" height=""/>
      </media:group>
      <itunes:keywords></itunes:keywords>
      <media:category label=""></media:category>
    </item>
    ...
  </channel>
</rss>

主要な部分をまとめると、次のようになります。

<rss>
  <channel>
    <item>
      <title>動画タイトル</title>
      <link>動画ページのURL</link>
      <description></description>
      <dm:id>動画のID</dm:id>
      <media:thumbnail url="サムネイルのURL" />
      <media:player url=""></media:player>
      <media:group>
        <media:content url="動画ファイルのURL" type="video/x-flv"/>
      </media:group>
    </item>
    <item>
      ...
    </item>
    ...
  </channel>
</rss>

サムネイル

http://static2.dmcdn.net/static/video/aaa/bbb/cccccccc:jpeg_preview_format.jpg

formatは、下表のいずれかです。

パラメータ	大きさ
small	高さ60px
medium	高さ120px
large	高さ240px
source	高さ480px
sprite	160×120pxの画像を縦に8つ並べた 160×960pxの画像

参考

dailymotionのRSS - 遊ぶブログ＋ Javaスクリプト小技集