カテゴリID取得

カテゴリＩＤ取得はYahoo!ショッピングのカテゴリ名・カテゴリ構造をリアルタイムで返すAPIです。デベロッパーはカテゴリIDを指定することでこれらの情報を得ることができます。

リクエストURL

リクエストパラメータ

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

サンプルリクエストURL

https://shopping.yahooapis.jp/ShoppingWebService/V1/categorySearch?appid=<あなたのアプリケーションID>&category_id=1

レスポンスフィールド

カテゴリID取得APIのスキーマの記述は、以下になります。

サンプルレスポンス

以下は、Yahoo!ショッピング第1階層目のカテゴリ情報のリクエストに対するレスポンスです。

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xsi:schemaLocation="urn:yahoo:jp:categorySearch http://shopping.yahooapis.jp/ShoppingWebService/V1/categorySearch.xsd" xmlns="urn:yahoo:jp:categorySearch" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="1">
  <Result>
    <Categories>
      <Current>
        <Id>1</Id>
        <ParentId>0</ParentId>
        <Url/>
        <Title>
          <Short>Shopping</Short>
          <Medium/>
          <Long/>
        </Title>
        <Path>
          <Category depth="1">
            <Id>1</Id>
            <ParentId>0</ParentId>
            <Title>
              <Name>Shopping</Name>
            </Title>
          </Category>
        </Path>
      </Current>
      <Children>
        <Child sortOrder="0">
          <Id>13457</Id>
          <Url>http://shopping.yahoo.co.jp/category/13457/recommend</Url>
          <Title>
            <Short>ファッション</Short>
            <Medium>ファッション</Medium>
            <Long>ファッション</Long>
          </Title>
        </Child>
        <Child sortOrder="40">
          <Id>2498</Id>
          <Url>http://shopping.yahoo.co.jp/category/2498/recommend</Url>
          <Title>
            <Short>食品</Short>
            <Medium>食品</Medium>
            <Long>食品</Long>
          </Title>
        </Child>
        <Child sortOrder="60">
          <Id>2500</Id>
          <Url>http://shopping.yahoo.co.jp/category/2500/recommend</Url>
          <Title>
            <Short>ダイエット、健康</Short>
            <Medium>ダイエット、健康グッズ</Medium>
            <Long>ダイエット、健康</Long>
          </Title>
        </Child>
        <Child sortOrder="70">
          <Id>2501</Id>
          <Url>http://shopping.yahoo.co.jp/category/2501/recommend</Url>
          <Title>
            <Short>コスメ、香水</Short>
            <Medium>コスメ、香水</Medium>
            <Long>コスメ、香水</Long>
          </Title>
        </Child>
        <Child sortOrder="80">
          <Id>2502</Id>
          <Url>http://shopping.yahoo.co.jp/category/2502/recommend</Url>
          <Title>
            <Short>パソコン、周辺機器</Short>
            <Medium>パソコン、周辺機器</Medium>
            <Long>パソコン、周辺機器</Long>
          </Title>
        </Child>
        <Child sortOrder="90">
          <Id>2504</Id>
          <Url>http://shopping.yahoo.co.jp/category/2504/recommend</Url>
          <Title>
            <Short>AV機器、カメラ</Short>
            <Medium>AV機器、カメラ</Medium>
            <Long>AV機器、カメラ</Long>
          </Title>
        </Child>
        <Child sortOrder="100">
          <Id>2505</Id>
          <Url>http://shopping.yahoo.co.jp/category/2505/recommend</Url>
          <Title>
            <Short>家電</Short>
            <Medium>家電</Medium>
            <Long>家電</Long>
          </Title>
        </Child>
        <Child sortOrder="110">
          <Id>2506</Id>
          <Url>http://shopping.yahoo.co.jp/category/2506/recommend</Url>
          <Title>
            <Short>家具、インテリア</Short>
            <Medium>家具、インテリア用品</Medium>
            <Long>家具、インテリア</Long>
          </Title>
        </Child>
        <Child sortOrder="120">
          <Id>2507</Id>
          <Url>http://shopping.yahoo.co.jp/category/2507/recommend</Url>
          <Title>
            <Short>花、ガーデニング</Short>
            <Medium>花、ガーデニング用品</Medium>
            <Long>花、ガーデニング</Long>
          </Title>
        </Child>
        <Child sortOrder="130">
          <Id>2508</Id>
          <Url>http://shopping.yahoo.co.jp/category/2508/recommend</Url>
          <Title>
            <Short>キッチン、生活雑貨、日用品</Short>
            <Medium>キッチン、生活雑貨、日用品</Medium>
            <Long>キッチン、生活雑貨、日用品</Long>
          </Title>
        </Child>
        <Child sortOrder="140">
          <Id>2503</Id>
          <Url>http://shopping.yahoo.co.jp/category/2503/recommend</Url>
          <Title>
            <Short>DIY、工具、文具</Short>
            <Medium>DIY、工具、文具</Medium>
            <Long>DIY、工具、文具</Long>
          </Title>
        </Child>
        <Child sortOrder="150">
          <Id>2509</Id>
          <Url>http://shopping.yahoo.co.jp/category/2509/recommend</Url>
          <Title>
            <Short>ペット用品、生き物</Short>
            <Medium>ペット用品、生き物</Medium>
            <Long>ペット用品、生き物</Long>
          </Title>
        </Child>
        <Child sortOrder="160">
          <Id>2510</Id>
          <Url>http://shopping.yahoo.co.jp/category/2510/recommend</Url>
          <Title>
            <Short>楽器、趣味、学習</Short>
            <Medium>楽器、趣味、学習</Medium>
            <Long>楽器、趣味、学習</Long>
          </Title>
        </Child>
        <Child sortOrder="170">
          <Id>2511</Id>
          <Url>http://shopping.yahoo.co.jp/category/2511/recommend</Url>
          <Title>
            <Short>ゲーム、おもちゃ</Short>
            <Medium>ゲーム、おもちゃ</Medium>
            <Long>ゲーム、おもちゃ</Long>
          </Title>
        </Child>
        <Child sortOrder="180">
          <Id>2497</Id>
          <Url>http://shopping.yahoo.co.jp/category/2497/recommend</Url>
          <Title>
            <Short>ベビー、キッズ、マタニティ</Short>
            <Medium>ベビー、キッズ、マタニティ</Medium>
            <Long>ベビー、キッズ、マタニティ</Long>
          </Title>
        </Child>
        <Child sortOrder="190">
          <Id>2512</Id>
          <Url>http://shopping.yahoo.co.jp/category/2512/recommend</Url>
          <Title>
            <Short>スポーツ</Short>
            <Medium>スポーツ関連商品</Medium>
            <Long>スポーツ</Long>
          </Title>
        </Child>
        <Child sortOrder="200">
          <Id>2513</Id>
          <Url>http://shopping.yahoo.co.jp/category/2513/recommend</Url>
          <Title>
            <Short>レジャー、アウトドア</Short>
            <Medium>レジャー、アウトドア</Medium>
            <Long>レジャー、アウトドア</Long>
          </Title>
        </Child>
        <Child sortOrder="210">
          <Id>2514</Id>
          <Url>http://shopping.yahoo.co.jp/category/2514/recommend</Url>
          <Title>
            <Short>自転車、車、バイク</Short>
            <Medium>自転車、車、バイク</Medium>
            <Long>自転車、車、バイク</Long>
          </Title>
        </Child>
        <Child sortOrder="220">
          <Id>2516</Id>
          <Url>http://shopping.yahoo.co.jp/category/2516/recommend</Url>
          <Title>
            <Short>CD、音楽ソフト</Short>
            <Medium>CD、音楽ソフト</Medium>
            <Long>CD、音楽ソフト</Long>
          </Title>
        </Child>
        <Child sortOrder="230">
          <Id>2517</Id>
          <Url>http://shopping.yahoo.co.jp/category/2517/recommend</Url>
          <Title>
            <Short>DVD、映像ソフト</Short>
            <Medium>DVD、映像ソフト</Medium>
            <Long>DVD、映像ソフト</Long>
          </Title>
        </Child>
        <Child sortOrder="240">
          <Id>10002</Id>
          <Url>http://shopping.yahoo.co.jp/category/10002/recommend</Url>
          <Title>
            <Short>本、雑誌、コミック</Short>
            <Medium>本、雑誌、コミック</Medium>
            <Long>本、雑誌、コミック</Long>
          </Title>
        </Child>
      </Children>
    </Categories>
  </Result>
</ResultSet>

エラー

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

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
1日50,000リクエストを超える場合は、アプリケーションIDを追加してご対応ください。

利用約款

このAPIに関する利用約款はこちら。