知恵袋

質問詳細API

リクエストURL
XML
http://chiebukuro.yahooapis.jp/Chiebukuro/V1/detailSearch

質問詳細は、Yahoo!知恵袋に投稿された質問・回答内容を取得する機能を提供します。質問の本文・補足・画像・地図情報や、回答の本文・画像・地図情報などのデータを取得できます。回答受付中の質問はすべての回答を表示でき、解決済みの質問はベストアンサーの回答を表示できます。

リクエストパラメータ

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

パラメータ値説明
appid
（必須）		 string アプリケーションIDです。詳細はこちらをご覧ください。
question_id
(必須）		 integer 質問IDです。
sort string: -postdate（デフォルト）, +postdate ソートフラグです。
指定可能な項目は下記の通り
  • -postdate: 回答日時 （降順） （デフォルト）
  • +postdate: 回答日時 （昇順）
answer_id integer 回答IDです。
回答IDが指定された場合は、指定された回答詳細のみを返します。
start integer: 1（デフォルト）～10 開始位置です。
デフォルトは1
1以上1000以下で指定します。
results integer: 0（デフォルト）～100 回答返却件数です。（ベストアンサー以外）
デフォルトは0
通常、0以上100以下で指定します。
use_title integer: 0～80（デフォルト） タイトル表示文字数です。
user_qa_list > 0 のときのみ有効。
直近のQ&Aのタイトルの先頭Nバイトを「...」で丸め込み。
デフォルトは80。0～80の間で指定可。
image_type integer: 0（デフォルト）, 1, 2, 3, 4 画像タイプです。
利用可能なフラグは下記の通り
  • 0： 画像表示なし （デフォルト）
  • 1： 200px / モバイル用画像（通常）
  • 2： 320px / パソコン用画像
  • 3： 440px / モバイル用画像（QVGA向け）
  • 4： 600px / 画像（大）
1～4指定時は、<Image> ... </Image>タグが返されるようになります。
output string: xml（デフォルト）, json 出力形式です。
利用可能な形式は下記の通り
  • xml: XML形式 （デフォルト）
  • json: JSON形式

サンプルリクエストURL

http://chiebukuro.yahooapis.jp/Chiebukuro/V1/detailSearch?appid=アプリケーションID&question_id=123456789

サンプルコード

質問詳細APIを使用したサンプルコードです。



レスポンスフィールド

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

XPath 値 説明
ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。
  • totalResultsAvailable: データ内でマッチしたクエリー数です。
  • totalResultsReturned: 返却され、かつマッチしたクエリーの数です。
  • firstResultPosition: 全検索結果の最初のポジションです。
  • maxPosition: 最大ポジションです。
  • nextFirstPosition: 次ページの最初のポジションです。※該当がない場合は属性が存在しません。
  • prevFirstPosition: 前ページの最初のポジションです。※該当がない場合は属性が存在しません。
  • maxItems: extend 指定されていないときのresultsに指定できる最大結果取得件数です。現在100固定。
Result 各個別レスポンスを含みます。
QuestionId integer 質問IDです。
CategoryId integer カテゴリIDです。
Title string タイトルです。
CDATAで括られています。
Content string 質問内容本文です。
CDATAで括られています。
SupplementContent string 補足内容です。
CDATAで括られています。
補足内容が存在する場合のみ取得されます。
BestAnswerContent string ベストアンサーです。
CDATAで括られています。
ベストアンサーが存在する場合のみ取得されます。
QuestionPostDate string 質問投稿日時です。（形式はRFC3339準拠）
QuestionEditDate string 質問編集日時です。（現状では補足した日時）（形式はRFC3339準拠）
編集が行われた場合のみ取得されます。
QuestionVoteDate string 質問投票日時です。（形式はRFC3339準拠）
QuestionEndDate string 回答受付中なら回答受付終了日時、投票受付中なら投票受付終了日時です。（形式はRFC3339準拠）
QuestionFinishDate string 解決日時です。（形式はRFC3339準拠）
RewardDate string お礼を書いた日時です。（形式はRFC3339準拠）
お礼が存在する場合のみ取得されます。
Reward string お礼内容です。
CDATAで括られています。
お礼が存在する場合のみ取得されます。
PcQuestionUrl string PCページのURLです。
MobileQuestionUrl string モバイルページのURLです。
Image 画像データです。
画像がないときは子要素が空となります。
Width integer 画像の幅です。
画像がないときはタグ自体生成しません。空のときもタグ自体生成しません。
Height integer 画像の高さです。
画像がないときはタグ自体生成しません。空のときもタグ自体生成しません。
Url string 画像のURLです。
画像がないときはタグ自体生成しません。空のときもタグ自体生成しません。
AttributeCode string 属性コードです。（key:valueの'|'記号区切りで取得されます）
CDATAで括られています。
CategoryIdPath string カテゴリIDパスです。（key:valueの'|'記号区切りで取得されます）
Category CDATA カテゴリ名です。
CDATAで括られています。
CategoryPath CDATA 大分類カテゴリ、中分類カテゴリ、小分類カテゴリのカテゴリ名パスです。（key:valueの'|'記号区切りで取得されます）
CDATAで括られています。
QuestionStatus string 質問ステータスです。
  • open: 回答受付中
  • vote: 投票受付中
  • solved: 解決済み
solved（解決済み）の質問の場合ベストアンサー以外の回答は返りません。
AnswerCount integer 回答数です。

下記は標準で付属します

XPath 値 説明
AnswerList 回答リストセット
下記、BestAnswer, Answer[n]が含まれます。
BestAnswer ベストアンサーリスト
AnswerList中に１つだけ含まれます。
ベストアンサーがなければ空となります。
answer_idで指定した場合、ベストアンサーであってもAnswerに入ります。
Answer[n] 回答リスト（ベストアンサー以外）
AnswerList中に複数含まれることがあります。
resultsパラメータは、これに関連します。
解決済みの質問の場合このレスポンスは返却されません。タグ自体生成しないanswer_idを指定し、かつ存在する場合は、これが1件のみ返ります。

ベストアンサーリスト/回答リスト（下記の例は回答リストの場合）
ベストアンサーリストは、回答リストと構造は同じです。XPath中のAnswerList/Answer[n]がAnswerList/BestAnswerとなります。

XPath 値 説明
AnswerId integer 回答IDです。
AnswerStatus string 回答ステータスです。
  • ba: ベストアンサー
  • notba: 非ベストアンサー
Content string 質問文字列または、回答文字列をあらわします。
CDATAで括られています。
AnswerPostDate string 回答投稿日時です。（形式はRFC3339準拠）
AnswerEditDate string 回答編集日時です。（形式はRFC3339準拠）
AttributeCode string 属性コードです。（key:valueの'|'記号区切りで取得されます）
CDATAで括られています。
Image 画像データです。
画像がないときは子要素が空となります。
Width integer 画像の幅です。
画像がないときはタグ自体生成しません。空のときもタグ自体生成しません。
Height integer 画像の高さです。
画像がないときはタグ自体生成しません。空のときもタグ自体生成しません。
Url string 画像のURLです。
画像がないときはタグ自体生成しません。空のときもタグ自体生成しません。



サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xmlns="urn:yahoo:jp:chiebukuro" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:yahoo:jp:chiebukuro http://chiebukuro.yahooapis.jp/Chiebukuro/V1/detailSearchResponse.xsd" totalResultsAvailable="0" totalResultsReturned="0" firstResultPosition="1" maxPosition="0" prevFirstPosition="1" maxItems="100">
  <Result>
    <QuestionId>123456789</QuestionId>
    <CategoryId>2078297572</CategoryId>
    <SpaceIdDetail>2079587465</SpaceIdDetail>
    <Title><![CDATA[質問タイトル]]></Title>
    <Content><![CDATA[質問全体]]></Content>
    <BestAnswerContent><![CDATA[ベストアンサー本文]]></BestAnswerContent>
    <ViewCount>0</ViewCount>
    <VoteCount>0</VoteCount>
    <ReviewCount>0</ReviewCount>
    <QuestionPostDate>2010-12-14T19:24:00+09:00</QuestionPostDate>
    <QuestionEditDate/>
    <QuestionVoteDate/>
    <QuestionEndDate>2010-12-21T19:24:00+09:00</QuestionEndDate>
    <QuestionFinishDate>2010-12-14T19:46:35+09:00</QuestionFinishDate>
    <RewardDate>2010-12-14T19:46:35+09:00</RewardDate>
    <Reward><![CDATA[お礼本文]]></Reward>
    <PcQuestionUrl><![CDATA[http://detail.chiebukuro.yahoo.co.jp/qa/question_detail/q123456789]]></PcQuestionUrl>
    <MobileQuestionUrl><![CDATA[http://chie.mobile.yahoo.co.jp/p/chie/qa/view?qid=123456789]]></MobileQuestionUrl>
    <Image/>
    <AttributeCode><![CDATA[]]></AttributeCode>
    <CategoryIdPath>2078297513|2078297558|2078297572</CategoryIdPath>
    <Category><![CDATA[あの人は今]]></Category>
    <CategoryPath><![CDATA[エンターテインメントと趣味|芸能人|あの人は今]]></CategoryPath>
    <QuestionStatus>solved</QuestionStatus>
    <AnswerCount>1</AnswerCount>
    <AnswerList>
      <BestAnswer>
        <AnswerId>123456789</AnswerId>
        <AnswerStatus>ba</AnswerStatus>
        <Content><![CDATA[ベストアンサー本文]]></Content>
        <AnswerPostDate>2010-12-14T19:45:18+09:00</AnswerPostDate>
        <AnswerEditDate/>
        <AttributeCode><![CDATA[]]></AttributeCode>
        <Image/>
      </BestAnswer>
    </AnswerList>
  </Result>
</ResultSet>


エラー

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



利用制限

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