おすすめ情報モジュール

Yahoo!ショッピングで提供する最新のおすすめ情報を、モジュール単位で取得できるAPIです。おすすめ情報は季節やトレンドにあわせて更新されます。

リクエストパラメータ

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

パラメータ	値	説明
appid （必須）	string	アプリケーションID。詳細はこちらをご覧ください。
affiliate_type	vc	バリューコマースアフィリエイト(vc)を選択。 例：affiliate_type=vc
affiliate_id	string	バリューコマースアフィリエイトIDを入力。
callback	string	JSONPとして出力する際のコールバック関数名を入力するためのパラメータ。UTF-8でエンコードした文字列を入力する。
category_id （デフォルト1）	integer	取得したいおすすめ情報モジュールがあるカテゴリ階層のカテゴリIDを指定します。
position (必須）	トップページ（category_id=1） 　・promotionbox 　・querykeyword 　・hotitem カテゴリページ（category_id=1以外） 　・basicpromotion 　・bestpromotion	トップページ（category_id=1）の場合に以下のpositionを指定できます。 　・promotionbox:開催中の販促イベント情報をバナーを使って掲載している情報。（更新頻度高） 　・querykeyword:検索人気キーワードをピックアップして紹介する情報。（更新頻度高） 　・hotitem:話題情報の画像とキャッチコピーを掲載しているモジュール情報。（更新頻度中） カテゴリページの場合に以下のpositionを指定できます。 　・basicpromotion:画像ありのおすすめ特集や商品のご紹介情報。 　・bestpromotion:画像なしのおすすめ特集や商品のご紹介情報。

サンプルリクエストURL

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

---

レスポンスフィールド

おすすめ情報モジュールAPIのスキーマの記述は、以下のURLになります。

フィールド	説明
/ResultSet	totalResultsReturned: 返された値の個数
/ResultSet/Result/CategoryId	リクエストしたカテゴリID
/ResultSet/Result/Position	リクエストしたPosition
/ResultSet/Result/ModuleTitle	モジュールのタイトル名
/ResultSet/Result/Hit	index:おすすめ情報の順番
/ResultSet/Result/Hit/Title	おすすめ情報の見出し文言
/ResultSet/Result/Hit/Url	見出し文言からのリンク先URL/アフィリエイトURL
/ResultSet/Result/Hit/EventTerm/Start	販促イベント開始時期（RFC）
/ResultSet/Result/Hit/EventTerm/End	販促イベント終了時期（RFC）
/ResultSet/Result/Hit/Image/Original	Yahoo!ショッピングのおすすめ情報モジュールで使用しているオリジナルサイズの画像 トップページ 　・promotionbox:770×250 　・promotionbox:300×300 　※2015/11/18より画像サイズが変更となります 　・querykeyword:なし 　・hotitem:76×76 カテゴリページ 　・basicpromotion：106×106
/ResultSet/Result/Hit/Image/Small	76×76サイズの画像URL（オリジナルサイズの画像以外がない場合は空）
/ResultSet/Result/Hit/Image/Medium	146×146サイズの画像URL（オリジナルサイズの画像以外がない場合は空）
/ResultSet/Result/Hit/SubTitles/SubTitle/Title	おすすめ情報の補足文言
/ResultSet/Result/Hit/SubTitles/SubTitle/Url	補足文言からのリンク先URL/アフィリエイトURL

---

サンプルレスポンス

以下は、hotitemを指定しリクエストした場合のレスポンスです。

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xsi:schemaLocation="urn:yahoo:jp:getModule http://shopping.yahooapis.jp/ShoppingWebService/V1/getModule.xsd" xmlns="urn:yahoo:jp:getModule" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="5">
  <Result>
    <CategoryId>1</CategoryId>
    <Position>hotitem</Position>
    <ModuleTitle>ホットアイテム</ModuleTitle>
    <Hit index="1">
      <Title>送料も無料！ジャージ上下セット激安セール</Title>
      <Url>http://topics.shopping.yahoo.co.jp/sale/whatshot/sports/00003/index.html?sc_i=sh_top_hotitem1</Url>
      <EventTerm>
        <Start>2012-11-22T12:00:00+09:00</Start>
        <End/>
      </EventTerm>
      <Image>
        <Original>http://i.yimg.jp/images/shp_edit/promotion/scl/sports/56/2012/20121122_001/pb_01.jpg</Original>
        <Small/>
        <Medium/>
      </Image>
      <SubTitles>
        <SubTitle>
          <Title/>
          <Url/>
        </SubTitle>
      </SubTitles>
    </Hit>
    <Hit index="2">
      <Title>ゴルフボールもお得な爆買いセール開催中！</Title>
      <Url>http://topics.shopping.yahoo.co.jp/sale/whatshot/sports/00002/index.html?sc_i=sh_top_hotitem2</Url>
      <EventTerm>
        <Start>2012-11-22T12:00:00+09:00</Start>
        <End/>
      </EventTerm>
      <Image>
        <Original>http://i.yimg.jp/images/shp_edit/promotion/scl/sports/56/1122golfball56x56.png</Original>
        <Small/>
        <Medium/>
      </Image>
      <SubTitles>
        <SubTitle>
          <Title/>
          <Url/>
        </SubTitle>
      </SubTitles>
    </Hit>
    <Hit index="3">
      <Title>TVで紹介！牛革を使用したイタリア製バッグ</Title>
      <Url>http://store.shopping.yahoo.co.jp/tbsshopping/daisakusen2.html?sc_i=sh_top_hotitem3</Url>
      <EventTerm>
        <Start>2012-11-23T10:00:00+09:00</Start>
        <End/>
      </EventTerm>
      <Image>
        <Original>http://i.yimg.jp/images/shp_edit/promotion/scl/top/56/2012/3q/1122_313.jpg</Original>
        <Small/>
        <Medium/>
      </Image>
      <SubTitles>
        <SubTitle>
          <Title/>
          <Url/>
        </SubTitle>
      </SubTitles>
    </Hit>
    <Hit index="4">
      <Title>ブランドバッグ＆財布セールもお見逃しなく</Title>
      <Url>http://sales.shopping.yahoo.co.jp/fair/newfair/fashion/0002/?cid=2494&amp;keyword=%E3%81%9F%E3%81%A0%E3%81%84%E3%81%BE%E3%81%AE%E3%82%B9%E3%83%9A%E3%82%B7%E3%83%A3%E3%83%AB%E7%9B%AE%E7%8E%89%E3%80%80-%E3%83%96%E3%83%BC%E3%83%84%E3%80%80-%E3%82%B9%E3%83%8B%E3%83%BC%E3%82%AB%E3%83%BC&amp;uIv=on&amp;uSa=on&amp;sc_i=sh_top_hotitem4</Url>
      <EventTerm>
        <Start>2012-11-15T09:55:00+09:00</Start>
        <End/>
      </EventTerm>
      <Image>
        <Original>http://i.yimg.jp/images/shp_edit/promotion/scl/top/56/2012/3q/1122_293.jpg</Original>
        <Small/>
        <Medium/>
      </Image>
      <SubTitles>
        <SubTitle>
          <Title/>
          <Url/>
        </SubTitle>
      </SubTitles>
    </Hit>
    <Hit index="5">
      <Title>日用品12点で半額1,155円！ 最短当日お届け</Title>
      <Url>http://lohaco.jp/feature/happybox201211/?bk=y&amp;sc_e=j_as_ya_sp_n&amp;sc_i=sh_top_hotitem5</Url>
      <EventTerm>
        <Start>2012-11-15T11:33:00+09:00</Start>
        <End/>
      </EventTerm>
      <Image>
        <Original>http://i.yimg.jp/images/shp_edit/promotion/scl/kitchen/other/sp_56x56.gif</Original>
        <Small/>
        <Medium/>
      </Image>
      <SubTitles>
        <SubTitle>
          <Title/>
          <Url/>
        </SubTitle>
      </SubTitles>
    </Hit>
  </Result>
</ResultSet>

---

エラー

おすすめ情報モジュールはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

---

利用制限

※短い時間の間に同一URLに大量にアクセスを行った場合、一定時間利用できなくなることもございます。（1クエリー/秒）
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を緩和させていただきます。（無料）
まずはヘルプページのお問い合わせフォームからご相談ください。