知恵袋
質問検索
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 | 指定検索の種類です。
|
| categoryid | integer | カテゴリIDです。指定した場合、検索するカテゴリを絞り込めます。 |
| condition | all(デフォルト), open, vote, solved | 質問の状態です。
|
| sort | -posteddate(デフォルト), +posteddate,-anscount, +anscount | 返却結果のソート項目です。
|
| posteddevice | all(デフォルト), mobile, pc | 投稿の種類(パソコンからの投稿、モバイルからの投稿)です。
|
| start | integer: 1(デフォルト) | 返却結果の先頭位置です。最終位置(start + results - 1)は、1000を超えられません。 |
| results | integer: 10(デフォルト),100(最大) | 返却結果の数です。 |
| restype | integer: 0(デフォルト) | サイト内URLの出力タイプ
|
サンプルリクエストURL
http://chiebukuro.yahooapis.jp/Chiebukuro/V1/questionSearch?レスポンスフィールド
質問検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://chiebukuro.yahooapis.jp/Chiebukuro/V1/questionSearchResponse.xsd
| フィールド | 説明 |
| ResultSet | リクエストに対する結果です。次の属性を持ちます。
|
| Status | レスポンスの状態やサーバーからのメッセージです。 |
| StatusCode | 実行結果のステータスです。正常終了の場合は「0」、異常が検出された場合には「-1」を返します。 |
| Error | 異常が検出された場合、エラーの詳細を含みます。 |
| Message | エラーメッセージを含み、次の属性を持ちます。
|
| Result | クエリーレスポンスのすべてを含みます。 |
| Question | 各個別レスポンスを含みます。 |
| Id | 質問IDです。 |
| Content | 質問本文です。 |
| BestAnswer | ベストアンサーです。 |
| Url | 詳細ページのURLです。 |
| Condition | 質問の状態です。
|
| CategoryPath | 階層表示したカテゴリ名です。区切り文字は「|」です。 |
| CategoryIdPath | 階層表示したカテゴリIDです。区切り文字は「|」です。 |
| AnsCount | 回答数です。 |
| PostedDate | 質問日時です。 |
| SolvedDate | 解決日時です。 |
| PostedDevice | 投稿の種類(パソコンからの投稿、ケータイからの投稿)です。「mobile」はケータイからの投稿、「pc」はパソコンからの投稿です。 |
サンプルレスポンス
以下は、apple のクエリーの結果です。
エラー
質問検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
Yahoo!知恵袋Web APIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。