検索

動画検索

Version 3

リクエストURL

XML

http://search.yahooapis.jp/VideoSearchService/V3/videoSearch

動画検索Web APIは、ウェブ上に公開されている動画を検索する機能を提供します。

リクエストパラメータ

「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。

パラメータ	値	説明
appid（必須）	string	アプリケーションID。詳細はこちらをご覧ください。
query（必須）	string	検索クエリーです。文字を含む場合は '+'、含まない場合は '-' を指定します。フレーズの場合は "検索クエリー" のように " でくくります。
type	all（デフォルト）, any, phrase	指定検索の種類: allは全クエリー文字を含む検索結果を返します。 anyはクエリー文字のうちいずれかを含む検索結果を返します。 phrase はクエリー文字を文章として含む検索結果を返します。
results	integer: 10（デフォルト）, 100（最大）	返却結果の数です。
start	integer: 1（デフォルト）	返却結果の先頭位置（1 - based）です。最終位置（start + results - 1）は、900を超えられません。
format	any（デフォルト）, flash	検索する動画の種類を指定します。
adult_ok	値なし（デフォルト）, 1	アダルトコンテンツの検索結果を含めるかどうかを指定します。1の場合はアダルトコンテンツを含みます。
site	string: 値なし（デフォルト）	検索するドメイン（例えば www.yahoo.co.jp）を制限します。（site=www.yahoo.co.jp）

サンプルリクエストURL

http://search.yahooapis.jp/VideoSearchService/V3/videoSearch?appid=<あなたのアプリケーションID>&query=%e6%b2%96%e7%b8%84&results=2

レスポンスフィールド

動画検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://search.yahooapis.jp/VideoSearchService/V3/VideoSearchResponse.xsd

フィールド	説明
ResultSet	他のレスポンスフィールドのすべてを含み、次の属性を持ちます。 totalResultsAvailable: クエリにマッチした検索結果数です。 totalResultsReturned: クエリにマッチした検索結果のうち、実際に返却された検索結果数です。もし有効な結果の数が少ない場合、要求した結果の数より少なくなることがあります。 firstResultPosition: クエリにマッチした検索結果全体における、返却された検索結果の先頭の順位です。
Result	各個別レスポンスを含みます。
Title	動画ファイルのタイトルです。
Summary	動画ファイルに関連するテキストサマリーです。
Url	空の値を返します。
ClickUrl	空の値を返します。
RefererUrl	動画コンテンツを含むページのURLです。
FileFormat	flashのみです。
Duration	動画ファイルの時間です。単位は秒です。
Width	動画コンテンツの幅です。単位はピクセルです。
Height	動画コンテンツの高さです。単位はピクセルです。
Thumbnail	サムネイルのURL、高さ、幅です。高さ、幅の単位はピクセルです。
Copyright	動画コンテンツの掲載サイトです。

サンプルレスポンス

以下は、沖縄のクエリーの結果です。

<?xml
 version="1.0" encoding="UTF-8"?>
<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="urn:yahoo:jp:srchmv" xsi:schemaLocation="urn:yahoo:jp:srchmv 
http://search.yahooapis.jp/VideoSearchService/V3/VideoSearchResponse.xsd"
 totalResultsAvailable="65400" totalResultsReturned="2" 
firstResultPosition="1">
  <Result>
    <FileSize>0</FileSize>
    <Title>2011.7.17_03 07 リチャード・コシミズ「琉球と沖縄」沖縄那覇講演会</Title>
    <Summary>NEXT→ TOP</Summary>
    
<RefererUrl>http://www.nicovideo.jp/watch/sm15303788</RefererUrl>

    <FileFormat>flash</FileFormat>
    <Duration>849</Duration>
    <Width>480</Width>
    <Height>400</Height>
    <Copyright>ニコニコ動画</Copyright>
    <Thumbnail>
      
<Url>http://msp.c.yimg.jp/video?q=eVpbl1RygnaV6XizwZa6X5I5aWuFPk7xLYgHNNg5jeOkEzPyzv40y0zBi8XwaxYKPg_8pT3KcGi4&sig=11ktff77u</Url>

      <Width>160</Width>
      <Height>160</Height>
    </Thumbnail>
    <Url></Url>
    <ClickUrl></ClickUrl>
  </Result>
  <Result>
    <FileSize>0</FileSize>
    <Title>第3回沖縄国際映画祭 レッドカーペット</Title>
    <Summary>ちょっと遅くなってしまいましたが… 第3回 沖縄国際映画祭、開幕しています！ 
3月22日、宜野湾市トロピカルビーチで沖縄国際映画祭が開幕しました。 
オープニングセレモニーの前には、映画祭に関わるたくさんの芸人さんやタレントさんたちがレッドカーペットを歩き、明るい笑顔で映画祭を盛り上げていまし
た。 映画祭は、今週の日曜日、27日に大団円を迎</Summary>
    
<RefererUrl>http://zoome.jp/OKINAWAnet/diary/177</RefererUrl>

    <FileFormat>flash</FileFormat>
    <Duration>108</Duration>
    <Width>480</Width>
    <Height>400</Height>
    <Copyright>zoome</Copyright>
    <Thumbnail>
      
<Url>http://msp.c.yimg.jp/video?q=Z9Jl3W9ygnawefPaycx.WAuVKLnxMVIg_bQIoqy6tlrLZhv66LePV_p80BZoNF0f47tKapQqmkZQ&sig=11keppjo4</Url>

      <Width>160</Width>
      <Height>160</Height>
    </Thumbnail>
    <Url></Url>
    <ClickUrl></ClickUrl>
  </Result>
</ResultSet>

エラー

動画検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

動画検索Web APIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。

動画検索

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

利用制限

動画検索を使用した開発に関するQ＆A

お役立ち度の高い解決済みの質問

Web APIとその他のサービス

API

その他

スタッフブログ

開発者コミュニティ

開発のヒント

法人デベロッパー専用お問い合わせ