知恵袋

カテゴリツリー

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

カテゴリツリーは、Yahoo!知恵袋に公開されているカテゴリ名やカテゴリのツリー構造を取得する機能を提供します。

リクエストパラメータ

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

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
categoryid integer カテゴリIDです。指定したカテゴリIDの下位カテゴリの一覧を取得できます。省略された場合、最上位カテゴリの一覧を取得できます。

サンプルリクエストURL

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


レスポンスフィールド

カテゴリツリーのスキーマの記述は、以下のURLをご覧ください。
http://chiebukuro.yahooapis.jp/Chiebukuro/V1/categoryTreeResponse.xsd

フィールド 説明
ResultSet リクエストに対する結果です。次の属性を持ちます。
  • totalResultsAvailable:マッチしたカテゴリの総数です。
  • totalResultsReturned:返却され、かつマッチしたカテゴリの数です。
Status レスポンスの状態やサーバーからのメッセージを含みます。
StatusCode 実行結果のステータスです。正常終了の場合は「0」、異常が検出された場合には「-1」を返します。
Error 異常が検出された場合、エラーの詳細を含みます。
Message エラーメッセージを含み、次の属性を持ちます。
  • code:エラーコードです。
Result クエリーレスポンスのすべてを含みます。
Category 各個別レスポンスを含みます。
Id カテゴリIDです。
Title カテゴリ名です。
IdPath 階層表示したカテゴリIDです。区切り文字は「|」です。
Path 階層表示したカテゴリ名です。区切り文字は「|」です。



サンプルレスポンス

以下は、categoryid=2078297513 のリクエストに対するレスポンスです。

<?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:tree http://chiebukuro.yahooapis.jp/Chiebukuro/V1/categoryTreeResponse.xsd" totalResultsReturned="14" totalResultsAvailable="14">
  <Status>
    <StatusCode>0</StatusCode>
    <Error></Error>
  </Status>
  <Result>
    <Category>
      <Id>2078297513</Id>
      <Title>エンターテインメントと趣味</Title>
      <IdPath>2078297513</IdPath>
      <Path>エンターテインメントと趣味</Path>
    </Category>
    <Category>
      <Id>2078297558</Id>
      <Title>芸能人、タレント</Title>
       <IdPath>2078297513|2078297558</IdPath>
      <Path>エンターテインメントと趣味|芸能人、タレント</Path>
    </Category>
    <Category>
      <Id>2078297526</Id>
      <Title>テレビ、ラジオ</Title>
      <IdPath>2078297513|2078297526</IdPath>
      <Path>エンターテインメントと趣味|テレビ、ラジオ</Path>
    </Category>
    <Category>
      <Id>2078297536</Id>
      <Title>音楽</Title>
       <IdPath>2078297513|2078297536</IdPath>
      <Path>エンターテインメントと趣味|音楽</Path>
    </Category>
    <Category>
      <Id>2078297543</Id>
      <Title>映画</Title>
       <IdPath>2078297513|2078297543</IdPath>
      <Path>エンターテインメントと趣味|映画</Path>
    </Category>
    <Category>
      <Id>2078297550</Id>
      <Title>演劇、ミュージカル、ダンス</Title>
       <IdPath>2078297513|2078297550</IdPath>
      <Path>エンターテインメントと趣味|演劇、ミュージカル、ダンス</Path>
    </Category>
    <Category>
      <Id>2079048392</Id>
      <Title>アニメ、コミック</Title>
       <IdPath>2078297513|2079048392</IdPath>
      <Path>エンターテインメントと趣味|アニメ、コミック</Path>
    </Category>
    <Category>
      <Id>2078297514</Id>
      <Title>ゲーム</Title>
       <IdPath>2078297513|2078297514</IdPath>
      <Path>エンターテインメントと趣味|ゲーム</Path>
    </Category>
    <Category>
      <Id>2078523512</Id>
      <Title>おもちゃ、ホビー</Title>
       <IdPath>2078297513|2078523512</IdPath>
      <Path>エンターテインメントと趣味|おもちゃ、ホビー</Path>
    </Category>
    <Category>
      <Id>2078297562</Id>
      <Title>本、雑誌</Title>
       <IdPath>2078297513|2078297562</IdPath>
      <Path>エンターテインメントと趣味|本、雑誌</Path>
    </Category>
    <Category>
      <Id>2078297564</Id>
      <Title>占い、超常現象</Title>
       <IdPath>2078297513|2078297564</IdPath>
      <Path>エンターテインメントと趣味|占い、超常現象</Path>
    </Category>
    <Category>
      <Id>2078645004</Id>
      <Title>懸賞、くじ</Title>
       <IdPath>2078297513|2078645004</IdPath>
      <Path>エンターテインメントと趣味|懸賞、くじ</Path>
    </Category>
    <Category>
      <Id>2078297554</Id>
      <Title>絵画、手芸、工芸</Title>
       <IdPath>2078297513|2078297554</IdPath>
      <Path>エンターテインメントと趣味|絵画、手芸、工芸</Path>
    </Category>
    <Category>
      <Id>2079048291</Id>
      <Title>伝統文化</Title>
       <IdPath>2078297513|2079048291</IdPath>
      <Path>エンターテインメントと趣味|伝統文化</Path>
    </Category>
  </Result>
</ResultSet>



エラー

カテゴリツリーはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。




利用制限

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