ヘルプ

フォト蔵API

search_publicメソッド

JSON: https://api.photozou.jp/rest/search_public.json
 XML: https://api.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のパラメータを廃止、常に新着順にソートした結果を返すようになりました。