フォト蔵API
search_publicメソッド
JSON: https://api.art19.photozou.jp/rest/search_public.json
XML: https://api.art19.photozou.jp/rest/search_public.xml
XML: https://api.art19.photozou.jp/rest/search_public.xml
概要
インターネットに公開されている写真を検索します。認証
このメソッドは、認証の必要はありません。サポートされているHTTPメソッド
HTTP GETメソッドのみをサポートしています。パラメータ
- 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)
JSONレスポンス
{ "info": { "photo_num": ###, "photo": [ { "photo_id": ###, "user_id": ###, "album_id": ###, "photo_title": "タイトル", "favorite_num": ###, "comment_num": ###, "view_num": ###, "copyright": "normal/creativecommons", "copyright_commercial": "yes/no" "copyright_modifications": "yes/no/share" "original_height": ##, "original_width": ###, "geo": { "latitude": ###, "longitude": ### }, "date": "YYYY-MM-DD", "regist_time": "YYYY-MM-DDThh:mm:ss+09:00", "url": "URL", "image_url": "URL", "original_image_url": "URL", "thumbnail_image_url": "URL", "large_tag": "<a href=\"...\">...</a>", "medium_tag": "<a href=\"...\">...</a>" }, ... ] } }
XMLレスポンス
<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> <geo> <latitude>###</latitude> <longitude>###</longitude> </geo> <date>YYYY-MM-DD</date> <regist_time>YYYY-MM-DDThh:mm:ss+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'の場合は他の人が同一条件化で配付する場合のみ変更を許可します。 - geo
- 写真の位置情報(ある場合)
- date
- 撮影日
- regist_time
- 登録日時(W3C Date and Time Formats による書式)
- url
- 写真ページのURL
- image_url
- 画像のURL
- original_image_url
- オリジナル画像のURL
- thumbnail_image_url
- サムネイル画像のURL
- large_tag
- ブログ等に貼り付けるためのタグ(普通サイズ)、XMLではCDATAで囲まれています。
- medium_tag
- ブログ等に貼り付けるためのタグ(縮小サイズ)、XMLではCDATAで囲まれています。
改定履歴
- 2009年12月2日
- order_typeのパラメータを廃止、常に新着順にソートした結果を返すようになりました。