ショッピング

おすすめ情報モジュール

リクエストURL
XML
http://shopping.yahooapis.jp/ShoppingWebService/V1/getModule
PHPserialize
http://shopping.yahooapis.jp/ShoppingWebService/V1/php/getModule
JSONP
http://shopping.yahooapis.jp/ShoppingWebService/V1/json/getModule

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

http://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クエリー/秒)
※大規模なサイト構築やアプリ開発等にご利用いただけるデベロッパー様や、法人様向けに、クエリー数制限/秒を解除させていただきます。(無料)
まずはヘルプページのお問い合わせフォームからご相談ください。