search_publicメソッド

フォト蔵API

フォト蔵API

http://api.photozou.jp/rest/search_public

概要

インターネットに公開されている写真/動画を検索します。

認証

このメソッドは、認証の必要はありません。

サポートされているHTTPメソッド

HTTP GET/POSTをサポートしています。

パラメータ

type: コンテントのタイプ。
'photo', 'video', 'all' のいずれかを指定します。
'photo': 写真
'video': 動画
'all': すべて(省略時)

keyword: タイトル、タグ、説明文に含まれるキーワードを指定します。最大100文字まで指定できます。

copyright: 著作権表示の型を指定します。
'normal', 'creativecommons', 'all' のうちから指定します。
'normal': ライセンスなし
'creativecommons': クリエイティブ・コモンズ
'all': すべて(省略時)

copyright_commercial: クリエイティブ・コモンズによる著作権、営利目的での利用を指定します。 ('copyright'パラメータに'creativecommons'を指定したときのみ有効)
'yes'(デフォルト), 'no'の2種類を指定できます。
'yes'の場合は利用を許可、'no'の場合は利用を許可しません。

copyright_modifications: クリエイティブ・コモンズによる著作権、改変の許可を指定します。 ('copyright'パラメータに'creativecommons'を指定したときのみ有効)
'yes'(デフォルト), 'no', 'share'の3種類を指定できます。
'yes'の場合は改変を許可、'no'の場合は改変を許可しません。
'share'の場合は他の人が同一条件化で配付する場合のみ変更を許可します。

limit: 検索の上限を指定します。(省略時100件、最大1000件)

offset: 検索のオフセットを指定します。(省略時: 0)

レスポンス

<info>
  <photo_num>###</photo_num>
  <photo>
    <photo_id>###</photo_id>
    <user_id>###</user_id>
    <album_id>###</album_id>
    <photo_title>タイトル</photo_title>
    <favorite_num>###</favorite_num>
    <comment_num>###</comment_num>
    <view_num>###</view_num>
    <copyright>normal/creativecommons</copyright>
    <copyright_commercial>yes/no</copyright_commercial>
    <copyright_modifications>yes/no</copyright_modifications>
    <regist_time>2006-05-07T02:14:47+09:00</regist_time>
    <url>URL</url>
    <image_url>URL</image_url>
    <original_image_url>URL</original_image_url>
    <thumbnail_image_url>URL</thumbnail_image_url>
    <large_tag><![CDATA[..........]]></large_tag>
    <medium_tag><![CDATA[.........]]></medium_tag>
  </photo>
  ...
</info>

photo_num: 写真/動画の数

photo_id: 写真/動画ID

user_id: ユーザーID

album_id: アルバムID

photo_title: タイトル

favorite_num: お気に入り数

comment_num: コメント数

view_num: アクセス数

copyright: ライセンスの型(normal: ライセンスなし、または creativecommons: クリエイティブ・コモンズ)

copyright_commercial: クリエイティブ・コモンズによる著作権、営利目的での利用を指定します。
'yes'(デフォルト), 'no'の2種類を指定できます。
'yes'の場合は利用を許可、'no'の場合は利用を許可しません。

copyright_modifications: クリエイティブ・コモンズによる著作権、改変の許可を指定します。 ('copyright'パラメータに'creativecommons'を指定したときのみ有効)
'yes'(デフォルト), 'no', 'share'の3種類を指定できます。
'yes'の場合は改変を許可、'no'の場合は改変を許可しません。
'share'の場合は他の人が同一条件化で配付する場合のみ変更を許可します。