ログイン
IDでもっと便利に[ 新規取得 ]

検索

関連検索ワード

Version 1

リクエストURL

XML

http://search.yahooapis.jp/AssistSearchService/V1/webunitSearch

関連検索ワードWeb APIは、実際にYahoo!検索で使用されたキーワード情報をもとに、指定されたキーワードとよく組み合わせて検索されるキーワード情報などを抽出する機能を提供します。
「関連検索ワード」の詳細は、「関連検索ワード」とは(Yahoo!検索のウェブ検索ヘルプページ)をご覧ください。

リクエストパラメータ

RESTリクエストの構築(GET)」および、「RESTリクエストの構築(POST)」をご参照ください。

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
query(必須) string (UTF-8エンコードされた)検索クエリーです。このクエリーはYahoo!検索の全言語をサポートし、またメタキーワードも含みます。
results integer: 10(デフォルト), 100(最大) 返却結果の数です。
start integer: 1(デフォルト) 返却結果の先頭位置です。最終位置(start + results - 1)は、100を超えられません。

サンプルリクエストURL

http://search.yahooapis.jp/AssistSearchService/V1/webunitSearch?appid=<あなたのアプリケーションID>&query=%e6%b2%96%e7%b8%84&results=2

レスポンスフィールド

関連検索ワードWeb APIのスキーマの記述は、以下のURLをご覧ください。
http://search.yahooapis.jp/AssistSearchService/V1/WebUnitSearchResponse.xsd

フィールド 説明
ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。
  • totalResultsAvailable: データ内のマッチした関連検索ワードの数です。
  • totalResultsReturned: 返却され、かつマッチした関連検索ワードの数です。有効な結果の合計が少ない場合、要求した結果の数より少ないことがあります。
  • firstResultPosition: 全検索結果の最初のポジションです。
Result 各個別の関連検索ワードです。

サンプルレスポンス

以下は、沖縄 のクエリーの結果です。

エラー

関連検索ワードWeb APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

関連検索ワードWeb APIは、24時間中1つのアプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。


スタッフブログ

日々成長を続けるYahoo!検索。その戦略、サービスの詳細、Tipsなどを開発の現場から発信。検索に関する新しい情報や、いろいろなトピックスを公開しています。

開発者コミュニティ

Yahoo!グループに開発者のためのグループを用意しています。ほかのデベロッパーと交流し、質問やアイデアの共有にお役立てください。

法人デベロッパー専用お問い合わせ