検索
画像検索
Version 2
リクエストURL
XML
http://search.yahooapis.jp/ImageSearchService/V2/imageSearch
Yahoo!プレミアム会員、Yahoo! BB会員、またはYahoo!ウォレット登録済みの方を対象として、以下のサービス内容にてウェブ検索API、画像検索APIの提供を行います（参考：「Yahoo!検索Web API のサービス内容変更について」、2011年3月）。
【Yahoo!プレミアム会員、Yahoo! BB会員、Yahoo!ウォレット登録済みの方向け提供機能（通常版との差異）】
- 同時にアクセス可能なユーザー数に制限はありません。
- 24時間中、1つのアプリケーションIDにつき50,000件のリクエストを上限とします。
Yahoo!検索Web API のより広範なご利用を希望される場合には、以下のページの内容をご確認のうえ、各対象サービスの登録をご検討ください。
画像検索Web APIは、ウェブ上に公開されている画像を検索する機能を提供します。
リクエストパラメータ
「RESTリクエストの構築（GET）」および、「RESTリクエストの構築（POST）」をご参照ください。
| パラメータ | 値 | 説明 |
|---|---|---|
| appid（必須） | string | アプリケーションID。詳細はこちらをご覧ください。 |
| query（必須） | string | 検索クエリーです。文字を含む場合は ’+’、含まない場合は ’-’ を指定します。フレーズの場合は "検索 クエリー" のように " でくくります。 |
| type | all（デフォルト）, any, phrase | 指定検索の種類:
|
| results | integer: 10（デフォルト）, 20（最大） | 返却結果の数です。 |
| start | integer: 1（デフォルト） | 返却結果の先頭位置（1 - based）です。最終位置（start + results - 1）は、1000を超えられません。 |
| format | any（デフォルト）, gif, jpeg, png | 検索する画像の種類を指定します。 |
| adult_ok | 値なし（デフォルト）, 1 | アダルトコンテンツの検索結果を含めるかどうかを指定します。1の場合はアダルトコンテンツを含みます。 |
| coloration | any（デフォルト）, color, bw | カラー画像だけを検索結果とするかどうかを指定します（カラーか白黒）。 |
| site | string: 値なし（デフォルト） | 検索するドメイン（例えば www.yahoo.co.jp）を制限します。 （ |
サンプルリクエストURL
http://search.yahooapis.jp/ImageSearchService/V2/imageSearch?レスポンスフィールド
画像検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://search.yahooapis.jp/ImageSearchService/V2/ImageSearchResponse.xsd
| フィールド | 説明 |
|---|---|
| ResultSet | 他のレスポンスフィールドのすべてを含み、次の属性を持ちます。
|
| Result | 各個別レスポンスを含みます。 |
| Title | 画像ファイルのタイトルです。 |
| Summary | 画像ファイルに関連するテキストサマリーです。 |
| Url | 画像ファイルのURLです。 |
| ClickUrl | 画像ファイルのURLです。 |
| RefererUrl | 画像へのリンクを含むページのURLです。 |
| FileSize | ファイルサイズです。単位はkB, MB などファイルサイズに応じて表示されます |
| FileFormat | gif、jpegまたはpngのいずれかになります。 |
| Height | 画像の高さです。単位はピクセルです。 |
| Width | 画像の幅です。単位はピクセルです。 |
| Thumbnail | サムネイル画像のURL、高さ、幅です。高さ、幅の単位はピクセルです。 |
| Restrictions | このメディアオブジェクトの制限事項です。制限事項はnoinlineを含みます。
|
サンプルレスポンス
以下は、沖縄 のクエリーの結果です。エラー
画像検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
