検索
画像検索
Version 1
リクエストURL
XML
http://search.yahooapis.jp/ImageSearchService/V1/imageSearch
画像検索Web APIは、ウェブ上に公開されている画像を検索する機能を提供します。
リクエストパラメータ
「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string | アプリケーションID。詳細はこちらをご覧ください。 |
| query（必須） | string | 検索クエリーです。文字を含む場合は ’+’、含まない場合は ’-’ を指定します。フレーズの場合は "検索 クエリー" のように " でくくります。 |
| type | all（デフォルト）, any, phrase | 指定検索の種類:
|
| results | integer: 10（デフォルト）, 50（最大） | 返却結果の数です。 |
| start | integer: 1（デフォルト） | 返却結果の先頭位置（1 - based）です。最終位置（start + results - 1）は、1000を超えられません。 |
| format | any（デフォルト）, bmp, gif, jpeg, png | 検索する画像の種類を指定します。 |
| adult_ok | 値なし（デフォルト）, 1 | アダルトコンテンツの検索結果を含めるかどうかを指定します。1の場合はアダルトコンテンツを含みます。 |
| coloration | any（デフォルト）, color, bw | カラー画像だけを検索結果とするかどうかを指定します（カラーか白黒）。 |
| site | string: 値なし（デフォルト） | 検索するドメイン（例えば www.yahoo.co.jp）を制限します。30ドメインまで指定することができます （ |
サンプルリクエストURL
http://search.yahooapis.jp/ImageSearchService/V1/imageSearch?レスポンスフィールド
画像検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://search.yahooapis.jp/ImageSearchService/V1/ImageSearchResponse.xsd
| フィールド | 説明 |
|---|---|
| ResultSet | クエリーレスポンスのすべてを含み、次の属性を持ちます。
|
| Result | 各個別レスポンスを含みます。 |
| Title | 画像ファイルのタイトルです。 |
| Summary | 画像ファイルに関連するテキストサマリーです。 |
| Url | 画像ファイルのURLです。 |
| ClickUrl | 画像ファイルのリンクURLです。詳細は、こちらをご覧ください。 |
| RefererUrl | 画像へのリンクを含むページのURLです。 |
| FileSize | ファイルサイズです。単位はbyteです。 |
| FileFormat | bmp、gif、jpegまたはpngのいずれかになります。 |
| Height | 画像の高さです。単位はピクセルです。 |
| Width | 画像の幅です。単位はピクセルです。 |
| Thumbnail | サムネイル画像のURL、高さ、幅です。高さ、幅の単位はピクセルです。 |
| Publisher | 画像ファイルの提供者です。 |
| Restrictions | このメディアオブジェクトの制限事項です。制限事項はnoframeまたはnoinlineを含みます。
|
| Copyright | オーナーのコピーライトです。 |
サンプルレスポンス
以下は、沖縄 のクエリーの結果です。
エラー
画像検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
画像検索Web APIは、24時間中1つのアプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。