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

知恵袋

質問検索

Version 1

リクエストURL

XML

http://chiebukuro.yahooapis.jp/Chiebukuro/V1/questionSearch

質問検索は、Yahoo!知恵袋に公開されている質問を検索し、質問本文とベストアンサーを取得する機能を提供します。またカテゴリを指定して質問を取得することもできます。

リクエストパラメータ

RESTリクエストの構築(GET)」をご参照ください。

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
query(必須) string (UTF-8エンコードされた)検索キーワードを指定します。
type all(デフォルト), any, phrase 指定検索の種類です。
  • all:全クエリー文字を含む検索結果を返します。
  • any:クエリー文字のうちいずれかを含む検索結果を返します。
  • phrase:クエリー文字を文章として含む検索結果を返します。
categoryid integer カテゴリIDです。指定した場合、検索するカテゴリを絞り込めます。
condition all(デフォルト), open, vote, solved 質問の状態です。
  • all:すべての質問を返します。
  • open:回答受付中の質問を返します。
  • vote:投票受付中の質問を返します。
  • solved:解決済みの質問を返します。
sort -posteddate(デフォルト), +posteddate,-anscount, +anscount 返却結果のソート項目です。
  • -posteddate:質問日時順で降順にソートします。
  • +posteddate:質問日時順で昇順にソートします。
  • -anscount:回答数順で降順にソートします。
  • +anscount:回答数順で昇順にソートします。
posteddevice all(デフォルト), mobile, pc 投稿の種類(パソコンからの投稿、モバイルからの投稿)です。
  • all:すべての投稿
  • mobile:モバイルからの投稿
  • pc:パソコンからの投稿
start integer: 1(デフォルト) 返却結果の先頭位置です。最終位置(start + results - 1)は、1000を超えられません。
results integer: 10(デフォルト),100(最大) 返却結果の数です。
restype integer: 0(デフォルト) サイト内URLの出力タイプ
  • 0:PC用(デフォルト)
  • 1:モバイル用
  • 2:スマートフォン用

サンプルリクエストURL

http://chiebukuro.yahooapis.jp/Chiebukuro/V1/questionSearch?appid=<あなたのアプリケーションID>&query=apple

レスポンスフィールド

質問検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://chiebukuro.yahooapis.jp/Chiebukuro/V1/questionSearchResponse.xsd

フィールド 説明
ResultSet リクエストに対する結果です。次の属性を持ちます。
  • totalResultsAvailable:マッチした質問の総数です。
  • totalResultsReturned:返却され、かつマッチした質問の数です。もし有効な結果の合計が少ない場合、要求した結果の数より少ないことがあります。
  • firstResultPosition:全検索結果の最初のポジションです。
Status レスポンスの状態やサーバーからのメッセージです。
StatusCode 実行結果のステータスです。正常終了の場合は「0」、異常が検出された場合には「-1」を返します。
Error 異常が検出された場合、エラーの詳細を含みます。
Message エラーメッセージを含み、次の属性を持ちます。
  • code:エラーコードです。
Result クエリーレスポンスのすべてを含みます。
Question 各個別レスポンスを含みます。
Id 質問IDです。
Content 質問本文です。
BestAnswer ベストアンサーです。
Url 詳細ページのURLです。
Condition 質問の状態です。
  • open:回答受付中の質問
  • vote:投票受付中の質問
  • solved:解決済みの質問
CategoryPath 階層表示したカテゴリ名です。区切り文字は「|」です。
CategoryIdPath 階層表示したカテゴリIDです。区切り文字は「|」です。
AnsCount 回答数です。
PostedDate 質問日時です。
SolvedDate 解決日時です。
PostedDevice 投稿の種類(パソコンからの投稿、ケータイからの投稿)です。「mobile」はケータイからの投稿、「pc」はパソコンからの投稿です。

サンプルレスポンス

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

エラー

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

利用制限

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


このAPIを使ったサンプルコード

開発者ブログ

Yahoo! JAPANのスタッフや著名なデベロッパーのブログを紹介しています。新しいサービスのアイデアにお役立てください。

開発者コミュニティ

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

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