ポイントキャンペーン情報取得

Yahoo!ショッピング内で公開しているポイントキャンペーン情報を検索するAPIです。ショッピングでお買い物するともらえるお得なポイント情報をリアルタイムで取得できます。

変更履歴

2020年09月24日

ポイント種別（/Results/Result/Rules/Rule/Ratios/Ratio）の説明を更新しました。
※関連する告知についてはこちらをご確認ください。

リクエストURL

XML

https://shopping.yahooapis.jp/ShoppingWebService/V1/shopCampaignSearch

PHPserialize

https://shopping.yahooapis.jp/ShoppingWebService/V1/php/shopCampaignSearch

JSONP

https://shopping.yahooapis.jp/ShoppingWebService/V1/json/shopCampaignSearch

リクエストパラメータ

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

パラメータ	値	説明
appid （必須）	string	アプリケーションID。詳細はこちらをご覧ください。
affiliate_type	vc	バリューコマースアフィリエイト（vc）を選択例：affiliate_type=vc
affiliate_id	string	バリューコマースアフィリエイトIDを入力
callback	string	JSONPとして出力する際のコールバック関数名を入力するためのパラメータ。UTF-8でエンコードした文字列を入力

サンプルリクエストURL

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

レスポンスフィールド

ポイントキャンペーン情報取得APIのスキーマの記述は、以下になります。

フィールド	説明
/Results/Result/Title	キャンペーンタイトル
/Results/Result/Id	キャンペーンID
/Results/Result/EventType	キャンペーンの種類 point: 通常ポイントキャンペーン noentry: エントリー不要のキャンペーン yjcard: YJカード限定のエントリー不要キャンペーン
/Results/Result/CampaignStartTime	キャンペーン開始日時 (YYYY-MM-DD HH:mm:ssの形式)
/Results/Result/CampaignEndTime	キャンペーン終了日時 (YYYY-MM-DD HH:mm:ssの形式)
/Results/Result/EntryStartTime	エントリー開始日時(YYYY-MM-DD HH:mm:ssの形式)
/Results/Result/EntryEndTime	エントリー終了日時(YYYY-MM-DD HH:mm:ssの形式)
/Results/Result/IsAutoEntry	エントリーが必要なポイントキャンペーンかどうか 0:エントリーが必要 1:エントリーが不要
/Results/Result/Images	キャンペーン画像の情報
/Results/Result/Images/Image/Width	キャンペーン画像の幅
/Results/Result/Images/Image/Height	キャンペーン画像の高さ
/Results/Result/Images/Image/Url	キャンペーン画像のURL
/Results/Result/Contents	キャンペーンの詳細情報
/Results/Result/Contents/Content/Description	キャンペーンの説明文
/Results/Result/Contents/Content/Url	キャンペーンページのURL
/Results/Result/Contents/Content/ArchivedUrl	キャンペーンが終了した際の遷移先URL
/Results/Result/Rules	ポイントキャンペーンの倍率情報
/Results/Result/Rules/Rule/Target	ポイントキャンペーンの対象者 ALL:　全対象 CreditCard: クレジットカード決済によってポイントが貰えるキャンペーン Wallet: ウォレット支払いによってポイントが貰えるキャンペーン OtherPayment: その他決済によってポイントが貰えるキャンペーン Premium: プレミアム会員限定 YBB: YBB会員限定 Ymobile: Y!mobile会員限定 APP: アプリ限定 SD: スマートデバイス限定（スマホもアプリもどちらも対象） Stamp: スタンプラリー会員限定
/Results/Result/Rules/Rule/Ratios	ポイント倍率の情報
/Results/Result/Rules/Rule/Ratios/Ratio	ポイント種別 targetと同じ値が入る ※Target=Stamp時に、スタンプラリーランク毎の倍率が配列で返却される仕様は削除しました。
/Results/Result/Rules/Rule/Ratios/Ratio/Num	ポイント倍率数
/Results/Result/MaxRatio	キャンペーンで獲得可能な最大の倍率

サンプルレスポンス

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

<Results>
  <Result index="1">
    <Title>5のつく日キャンペーン</Title>
    <Id>1087</Id>
    <EventType>point</EventType>
    <IsDisplay>1</IsDisplay>
    <IsCondition>1</IsCondition>
    <Sentence>エントリーしてお買い物をすると+3倍。さらにスマートフォン・タブレット端末からのお買い物で+１倍。</Sentence>
    <CampaignStartTime>2016-03-15 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-15 23:59:59</CampaignEndTime>
    <EntryStartTime>2016-03-15 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-15 23:59:59</EntryEndTime>
    <IsAutoEntry>0</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/smartphone20131225/56_56.gif</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/smartphone20131225/76_76.gif</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/modal_bnr/pointx5.gif</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>ポイント最大5倍！　エントリーしてお買い物をすると、ストアポイントに加えてボーナスポイントをプレゼント。</Description>
        <Url>http://topics.shopping.yahoo.co.jp/campaign/points/pointx5/</Url>
        <ArchivedUrl>http://topics.shopping.yahoo.co.jp/campaign/points/pointx5/</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target>ALL</Target>
        <Ratios>
          <Ratio index="1">
            <Type>ALL</Type>
            <Num>4</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio>4</MaxRatio>
  </Result>
  <Result index="2">
    <Title>Yahoo!プレミアム会員限定！アプリで買ったらTポイント3倍！</Title>
    <Id>1105</Id>
    <EventType>noentry</EventType>
    <IsDisplay>1</IsDisplay>
    <IsCondition>1</IsCondition>
    <Sentence>Yahoo!プレミアム会員の方ならアプリでお買物をするとTポイント3倍！</Sentence>
    <CampaignStartTime>2016-03-11 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-20 23:59:59</CampaignEndTime>
    <EntryStartTime>2016-03-11 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-20 23:59:59</EntryEndTime>
    <IsAutoEntry>1</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/apps3/images/bnr/premium_56_56.png</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/apps3/images/bnr/premium_76_76.png</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/apps3/images/bnr/premium_300_300.png</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>Yahoo!プレミアム会員の方ならアプリでお買物をするとTポイント3倍！</Description>
        <Url>http://topics.shopping.yahoo.co.jp/general/points/apps3/</Url>
        <ArchivedUrl>http://topics.shopping.yahoo.co.jp/general/points/apps3/</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target>AppPremium</Target>
        <Ratios>
          <Ratio index="1">
            <Type>AppPremium</Type>
            <Num>2</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio>2</MaxRatio>
  </Result>
  <Result index="3">
    <Title>Yahoo! JAPANカード新規入会キャンペーン</Title>
    <Id>895</Id>
    <EventType>noentry</EventType>
    <IsDisplay>0</IsDisplay>
    <IsCondition>0</IsCondition>
    <Sentence/>
    <CampaignStartTime>2015-04-06 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-31 11:59:59</CampaignEndTime>
    <EntryStartTime>2015-04-06 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-31 11:59:59</EntryEndTime>
    <IsAutoEntry>1</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/20151112/56_56_shp.png</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/20150401/76_76.png</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/20150401/300x300.png</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>開催期間中にYahoo! JAPANカードのお申し込みを行い、カード到着後にYahoo!カードを使って決済をした方に5,000ポイントプレゼント。</Description>
        <Url>http://rdsig.yahoo.co.jp/yjcard/pc/shp/toolbar/evt=124979/RV=1/RU=aHR0cDovL2NhcmQueWFob28uY28uanAvY2FtcGFpZ24vPy5kb25lPWh0dHAlM0ElMkYlMkZzaG9wcGluZy55YWhvby5jby5qcCUyRiZwcmVtX29wdD1QXzQwMDIuQ19TdG9DMDAwMw--</Url>
        <ArchivedUrl>http://rdsig.yahoo.co.jp/yjcard/pc/shp/toolbar/evt=124979/RV=1/RU=aHR0cDovL2NhcmQueWFob28uY28uanAvY2FtcGFpZ24vPy5kb25lPWh0dHAlM0ElMkYlMkZzaG9wcGluZy55YWhvby5jby5qcCUyRiZwcmVtX29wdD1QXzQwMDIuQ19TdG9DMDAwMw--</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target/>
        <Ratios>
          <Ratio index="1">
            <Type/>
            <Num>0</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio>0</MaxRatio>
  </Result>
  <Result index="4">
    <Title>Yahoo! JAPANカードご利用で毎日Ｔポイント3倍</Title>
    <Id>1017</Id>
    <EventType>yjcard</EventType>
    <IsDisplay>1</IsDisplay>
    <IsCondition>0</IsCondition>
    <Sentence/>
    <CampaignStartTime>2015-12-01 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-31 23:59:59</CampaignEndTime>
    <EntryStartTime>2015-12-01 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-31 23:59:59</EntryEndTime>
    <IsAutoEntry>1</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/20150731/56x56.png</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/20150731/76x76.png</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/20150801/store_300_300.png</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>Yahoo!ショッピングとLOHACOでのご利用時、Ｔポイントが毎日合計3倍たまります。</Description>
        <Url>http://rdsig.yahoo.co.jp/yjcard/pc/shp/toolbar/evt=124979/RV=1/RU=aHR0cDovL2NhcmQueWFob28uY28uanAvY2FtcGFpZ24vPy5kb25lPWh0dHAlM0ElMkYlMkZzaG9wcGluZy55YWhvby5jby5qcCUyRiZwcmVtX29wdD1QXzQwMDIuQ19TdG9DMDAwMw--</Url>
        <ArchivedUrl>http://rdsig.yahoo.co.jp/yjcard/pc/shp/toolbar/evt=124979/RV=1/RU=aHR0cDovL2NhcmQueWFob28uY28uanAvY2FtcGFpZ24vPy5kb25lPWh0dHAlM0ElMkYlMkZzaG9wcGluZy55YWhvby5jby5qcCUyRiZwcmVtX29wdD1QXzQwMDIuQ19TdG9DMDAwMw--</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target>CreditCard</Target>
        <Ratios>
          <Ratio index="1">
            <Type>CreditCard</Type>
            <Num>2</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio>2</MaxRatio>
  </Result>
  <Result index="5">
    <Title>Yahoo!プレミアム会員限定！Tポイント5倍！</Title>
    <Id>1006</Id>
    <EventType>noentry</EventType>
    <IsDisplay>1</IsDisplay>
    <IsCondition>0</IsCondition>
    <Sentence/>
    <CampaignStartTime>2015-10-01 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-31 23:59:59</CampaignEndTime>
    <EntryStartTime>2015-10-01 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-31 23:59:59</EntryEndTime>
    <IsAutoEntry>1</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/premium/20150701/56_56.gif</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/premium/20150701/76_76.gif</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/shp_edit/points/modal_bnr/premium_03.gif</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>Yahoo!プレミアム会員なら、毎日のお買い物がずっとポイント5倍！</Description>
        <Url>http://topics.shopping.yahoo.co.jp/campaign/points/premium/</Url>
        <ArchivedUrl>http://topics.shopping.yahoo.co.jp/campaign/points/premium/</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target>Premium</Target>
        <Ratios>
          <Ratio index="1">
            <Type>Premium</Type>
            <Num>4</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio/>
  </Result>
  <Result index="6">
    <Title>Yahoo! JAPANカード　今ならどこでも2倍たまるキャンペーン</Title>
    <Id>1098</Id>
    <EventType>point</EventType>
    <IsDisplay>1</IsDisplay>
    <IsCondition>0</IsCondition>
    <Sentence/>
    <CampaignStartTime>2016-03-10 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-31 23:59:59</CampaignEndTime>
    <EntryStartTime>2016-03-10 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-31 23:59:59</EntryEndTime>
    <IsAutoEntry>0</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/2percent/20160310/56_56.png</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/2percent/20160310/76_76.png</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/yjcard/campaign/bnr/2percent/20160310/300_300.png</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>エントリーしてYahoo! JAPANカードでお買い物をすると、開催期間のお買い物100円につき1ポイントを進呈</Description>
        <Url>http://rdsig.yahoo.co.jp/yjcrd/sp/shp/app/2spring/RV=1/RU=aHR0cDovL2NhcmQueWFob28uY28uanAvY2FtcGFpZ24vcHJvbW90aW9uLzJwZXJjZW50Lw--</Url>
        <ArchivedUrl>http://rdsig.yahoo.co.jp/yjcrd/sp/shp/app/2spring/RV=1/RU=aHR0cDovL2NhcmQueWFob28uY28uanAvY2FtcGFpZ24vcHJvbW90aW9uLzJwZXJjZW50Lw--</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target>Wallet</Target>
        <Ratios>
          <Ratio index="1">
            <Type>Wallet</Type>
            <Num>1</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio>1</MaxRatio>
  </Result>
  <Result index="7">
    <Title>Enjoyパック 今ならYahoo!ショッピングお買い物で最大24倍キャンペーン</Title>
    <Id>1106</Id>
    <EventType>point</EventType>
    <IsDisplay>0</IsDisplay>
    <IsCondition>0</IsCondition>
    <Sentence/>
    <CampaignStartTime>2016-03-14 00:00:00</CampaignStartTime>
    <CampaignEndTime>2016-03-31 23:59:59</CampaignEndTime>
    <EntryStartTime>2016-03-14 00:00:00</EntryStartTime>
    <EntryEndTime>2016-03-31 23:59:59</EntryEndTime>
    <IsAutoEntry>0</IsAutoEntry>
    <Images>
      <Image index="1">
        <Width>56</Width>
        <Height>56</Height>
        <Url>http://i.yimg.jp/images/enjoy/pc/campaign/point/201603/banner/56x56.png</Url>
      </Image>
      <Image index="2">
        <Width>76</Width>
        <Height>76</Height>
        <Url>http://i.yimg.jp/images/enjoy/pc/campaign/point/201603/banner/76x76.png</Url>
      </Image>
      <Image index="3">
        <Width>300</Width>
        <Height>300</Height>
        <Url>http://i.yimg.jp/images/enjoy/pc/campaign/point/201603/banner/300x300.png</Url>
      </Image>
    </Images>
    <Contents>
      <Content index="1">
        <Device>pc</Device>
        <Description>Enjoyパック会員の方限定！　Yahoo!ショッピングでのお買物でボーナスポイントプレゼント</Description>
        <Url>http://contents.enjoy.yahoo.co.jp/campaign/point/201603.html</Url>
        <ArchivedUrl>http://contents.enjoy.yahoo.co.jp/campaign/point/201603.html</ArchivedUrl>
        <Carrier/>
      </Content>
    </Contents>
    <Rules>
      <Rule index="1">
        <Target/>
        <Ratios>
          <Ratio index="1">
            <Type/>
            <Num>0</Num>
          </Ratio>
        </Ratios>
      </Rule>
    </Rules>
    <MaxRatio>0</MaxRatio>
  </Result>
</Results>

エラー

ポイントキャンペーン情報取得APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

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

ポイントキャンペーン情報取得

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

利用制限

利用約款

目次

開発のヒント

サービス一覧