検索
ウェブ検索
Version 2
リクエストURL
XML
http://search.yahooapis.jp/WebSearchService/V2/webSearch
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 | （UTF-8エンコードされた）検索クエリーです。このクエリーはYahoo!検索の全言語をサポートし、またメタキーワードも含みます。 |
| type | all（デフォルト）, any, phrase | 指定検索の種類:
|
| results | integer: 10（デフォルト）, 20（最大） | 返却結果の数です。 |
| start | integer: 1（デフォルト） | 返却結果の先頭位置です。最終位置（start + results - 1）は、1000を超えられません。 |
| format | any（デフォルト）, html, msword, pdf, ppt, txt, xls | 検索するファイルの種類を指定します。 |
| adult_ok | 値なし（デフォルト）, 1 | アダルトコンテンツの検索結果を含めるかどうかを指定します。1 の場合はアダルトコンテンツを含みます。 |
| similar_ok | 値なし（デフォルト）, 1 | 同じコンテンツを別の検索結果とするかどうかを指定します。1 の場合は同じコンテンツを含みます。 |
| language | string: ja（デフォルト） | languageで書かれた結果になります。「サポートしている言語」をご参照ください。 |
| country | string: 値なし（デフォルト） | ウェブサイトが位置する国の国コードです。「サポートしている国・地域」をご参照ください。 |
| site | string: 値なし（デフォルト） | 検索するドメイン（例えば www.yahoo.co.jp）を制限します。 （ |
サンプルリクエストURL
http://search.yahooapis.jp/WebSearchService/V2/webSearch?レスポンスフィールド
ウェブ検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://search.yahooapis.jp/WebSearchService/V2/WebSearchResponse.xsd
| フィールド | 説明 |
|---|---|
| ResultSet | 他のレスポンスフィールドのすべてを含み、次の属性を持ちます。
|
| Result | 各個別レスポンスを含みます。 |
| Title | ページのタイトルです。 |
| Summary | ページに関連するテキストサマリーです。 |
| Url | ページのURLです。 |
| ClickUrl | ページのURLです。 |
| ModificationDate | ページが最後にクロールされた日付です。UNIXタイムスタンプフォーマットです。 |
| Cache | キャシュ結果のURLです。サイズはbyteです。 |
サンプルレスポンス
以下は、沖縄 のクエリーの結果です。エラー
ウェブ検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
