Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント
Amazon MWS ドキュメント

GetLowestPricedOffersForASIN

ASINに応じた、単一の商品の最低価格の出品情報を返します。

説明

GetLowestPricedOffersForASINオペレーションは、商品を一意に識別するためにMarketplaceIdASINを指定する点と、MyOffer要素を返さない点を除き、GetLowestPricedOffersForSKUオペレーションと同様です。商品のASINが不明な場合は、ListMatchingProductsオペレーションを使ってASINを検索できます。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。ただし中国は除きます。

スロットリング

最大リクエストクォータ 回復レート 時間あたりのリクエストクォータ
10リクエスト 1秒ごとに5商品 1時間あたり200リクエスト
このクォータと回復レートはGetLowestPricedOffersForSKUと共有されます。 スロットリング用語の定義およびスロットリングの詳しい説明については、Amazon MWS開発者ガイドスロットリング:リクエストの送信頻度を制限するを参照してください。商品ごとのスロットリングの詳細については、商品APIのスロットリングを参照してください。

1時間に問い合わせできるSKUまたはASINは200件までのため、GetLowestPricedOffersForASINを呼び出して出品者自身が出品しているASINの上位20の出品を取得したあとは、CreateSubscriptionを呼び出してAnyOfferChanged通知をサブスクライブしてください。出品者自身が販売しているASINの上位20の出品に変更があった場合に通知されるため、GetLowestPricedOffersForASINクォータを使う必要がありません。

リクエストパラメーター

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイド必須のリクエストパラメーターを参照してください。

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
ASIN 商品のAmazon標準識別番号(ASIN)。 はい タイプ:xs:string
ItemCondition 商品コンディションに応じて結果をフィルタします。 はい ItemCondition値:NewUsedCollectibleRefurbishedClub

タイプ:xs:string

注意

  1. バリエーションの親商品のASINを指定した場合、NoBuyableOffersが返されます。バリエーションの親商品は総称的な商品を表し、販売できません。バリエーションの子商品は商品の特性(サイズや色など)を表し、販売可能です。

レスポンス要素

GetLowestPricedOffersForASINオペレーションが返すレスポンス要素は、一般に公開されているXSD ProductsAPI_Response.xsdで内容を確認できます。GetLowestPricedOffersForASINオペレーションが返す最上位要素は以下の通りです。

GetLowestPricedOffersForASINResult要素

名前 説明
Identifier マーケットプレイスおよびASINで商品を識別します。
Summary LowestPricesBuyBoxPricesListPriceSuggestedLowerPricePlusShippingNumberOfOffersNumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。
Offers Offer要素のリストで、PointsShippingTimeShippingShipsFromListingPriceSellerFeedbackRating などが出力されます。

GetLowestPricedOffersForASINResult属性

Statusを除き、これらの属性はそれぞれ、呼び出しの元のリクエストパラメーターと一致します。Statusはオペレーションの全体的な結果(SuccessまたはNoBuyableOffers)を示します。NoBuyableOffersは商品が出品されていないことを表します。

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
ASIN 商品のAmazon標準識別番号(ASIN)。 はい タイプ:xs:string
ItemCondition 商品のコンディション。 はい ItemCondition値:NewUsedCollectibleRefurbishedClub

タイプ:xs:string

Status オペレーションのステータス。 はい Status値:SuccessまたはNoBuyableOffers

タイプ:xs:string

Identifier

マーケットプレイスおよびASINで商品を識別します。

Identifier要素

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
ASIN 商品のAmazon標準識別番号(ASIN)。 はい タイプ:xs:string
ItemCondition 商品のコンディション。 はい ItemCondition値:NewUsedCollectibleRefurbishedClub

タイプ:xs:string

TimeOfOfferChange 出品の更新時刻。 いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

Summary

LowestPricesBuyBoxPricesListPriceSuggestedLowerPricePlusShippingNumberOfOffersNumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。

Summary要素

名前 説明 必須
TotalOfferCount NumberOfOffersに含まれている一意な出品の数。 はい タイプ:xs:int
NumberOfOffers 商品の出品数の合計を示すリスト(コンディション・フルフィルメントチャネル別)。 はい タイプ: OfferCountType
LowestPrices 商品の最低価格の一覧。 いいえ タイプ:タイプのリスト: LowestPrice
BuyBoxPrices 商品価格の一覧。 いいえ タイプ:タイプのリスト: BuyBoxPrice
ListPrice メーカー希望価格。 いいえ タイプ: MoneyType
SuggestedLowerPricePlusShipping 商品の価格見直し例(配送料込み)。価格見直し例は販売価格の履歴、カートボックス価格および対象商品へのお客様のご意見などを基にしています。 いいえ タイプ: MoneyType
BuyBoxEligibleOffers ショッピングカートボックス獲得の対象となっている出品総数を示すリスト。(コンディション・フルフィルメントチャネル別) はい タイプ: OfferCountType

Offers

Offer要素のリストで、PointsShippingTimeShippingShipsFromListingPriceSellerFeedbackRating などが出力されます。

このリストの長さは、Summaryで示されるTotalOfferCountと同じ長さ、または20のいずれか小さい方です。

Offer要素

名前 説明 必須
Subcondition 商品のサブコンディション。 はい Subcondition値:NewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen Box、 またはOther

タイプ:xs:string

SellerFeedbackRating 出品者のフィードバックに関する情報(良い評価を受けた割合および寄せられたフィードバックの総数)。 いいえ タイプ: SellerFeedbackRating
ShippingTime 注文から商品が出荷できるようになるまでの最大時間。 はい タイプ: DetailedShippingTimeType
ListingPrice 商品の価格。 はい タイプ: MoneyType
Points 商品の購入で獲得するAmazonポイント数。 いいえ タイプ: Points
Shipping 配送料。 はい タイプ: MoneyType
ShipsFrom 商品の発送元の都道府県および国。 いいえ タイプ: ShipsFrom
IsFulfilledByAmazon Amazonから出荷で出品する場合は true はい タイプ:xs:boolean
IsBuyBoxWinner true (現在ショッピングカートボックスにある場合)。いつでも、1つのASINあたり最大2件(プライム対象とプライム対象外それぞれ1つ)のショッピングカートボックス獲得出品者が存在します。 いいえ タイプ:xs:boolean
IsFeaturedMerchant true (商品の出品者にショッピングカートボックスを獲得する資格がある場合)。 いいえ タイプ:xs:boolean

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

POST /Products/2011-10-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

&ASIN=B00COK3FD8
&AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetLowestPricedOffersForASIN
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&ItemCondition=New
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2015-05-22T21%3A23%3A31Z
&Version=2011-10-01
&Signature=V1uTEXAMPLE8HVCfobAqQDKzylYyTRWfv3X4SEXAMPLEY%3D

↑ トップへ戻る

レスポンス例(成功)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?><GetLowestPricedOffersForASINResponse 
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" 
        ItemCondition="New" ASIN="B0002GTTRC" status="Success">
        <Identifier>
            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
            <ASIN>B0002GTTRC</ASIN>
            <ItemCondition>New</ItemCondition>
            <TimeOfOfferChange>2015-07-19T23:15:11.859Z</TimeOfOfferChange>
        </Identifier>
        <Summary>
            <TotalOfferCount>0</TotalOfferCount>
            <NumberOfOffers>
                <OfferCount condition="new" 
                    fulfillmentChannel="Amazon">1</OfferCount>
            </NumberOfOffers>
            <LowestPrices>
                <LowestPrice condition="new" fulfillmentChannel="Amazon">
                    <LandedPrice>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>32.99</Amount>
                    </LandedPrice>
                    <ListingPrice>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>32.99</Amount>
                    </ListingPrice>
                    <Shipping>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>0.00</Amount>
                    </Shipping>
                </LowestPrice>
            </LowestPrices>
            <BuyBoxPrices>
                <BuyBoxPrice condition="New">
                    <LandedPrice>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>32.99</Amount>
                    </LandedPrice>
                    <ListingPrice>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>32.99</Amount>
                    </ListingPrice>
                    <Shipping>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>0.00</Amount>
                    </Shipping>
                </BuyBoxPrice>
            </BuyBoxPrices>
            <ListPrice>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>58.34</Amount>
            </ListPrice>
            <SuggestedLowerPricePlusShipping>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>32.99</Amount>
            </SuggestedLowerPricePlusShipping>
            <BuyBoxEligibleOffers>
                <OfferCount condition="new" 
                    fulfillmentChannel="Amazon">1</OfferCount>
            </BuyBoxEligibleOffers>
        </Summary>
        <Offers>
            <Offer>
                <SubCondition>new</SubCondition>
                <SellerFeedbackRating>
                    <SellerPositiveFeedbackRating>100.0</SellerPositiveFeedbackRating>
                    <FeedbackCount>1</FeedbackCount>
                </SellerFeedbackRating>
                <ShippingTime minimumHours="0" maximumHours="0" 
                    availabilityType="NOW"/>
                <ListingPrice>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>32.99</Amount>
                </ListingPrice>
                <Shipping>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>0.00</Amount>
                </Shipping>
                <IsFulfilledByAmazon>true</IsFulfilledByAmazon>
                <IsBuyBoxWinner>true</IsBuyBoxWinner>
                <IsFeaturedMerchant>true</IsFeaturedMerchant>
            </Offer>
        </Offers>
    </GetLowestPricedOffersForASINResult>
    <ResponseMetadata>
        <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
    </ResponseMetadata>
</GetLowestPricedOffersForASINResponse>

↑ トップへ戻る

レスポンス例(成功、商品なし)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<GetLowestPricedOffersForASINResponse 
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" 
        ItemCondition="New" ASIN="B000EVPGSQ" status="NoBuyableOffers">
        <Identifier>
            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
            <ASIN>B000EVPGSQ</ASIN>
            <ItemCondition>New</ItemCondition>
        </Identifier>
        <Summary>
            <TotalOfferCount>0</TotalOfferCount>
        </Summary>
        <Offers/>
    </GetLowestPricedOffersForASINResult>
    <ResponseMetadata>
        <RequestId>2bb867cd-8fa3-406c-adba-eb84c1796d21</RequestId>
    </ResponseMetadata>
</GetLowestPricedOffersForASINResponse>

↑ トップへ戻る

レスポンス例(サーバーエラー)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <Error MarketplaceID="ATVPDKIKX0DER" ASIN="24478624" ItemCondition="New" 
    status="ServerError">
    <Type>Receiver</Type>
    <Message>Server Error. Try back later</Message>
    <Detail/>
  </Error>
  <ResponseMetadata>
    <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
  </ResponseMetadata>
</ErrorResponse>


↑ トップへ戻る

レスポンス例(ASINが無効)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<ErrorResponse 
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <Error MarketplaceID="ATVPDKIKX0DER" ASIN="B0002GTTRD" ItemCondition="New" 
        status="ClientError">
        <Code>InvalidParameterValue</Code>
        <Type>Sender</Type>
        <Message>B0002GTTRD is an invalid ASIN for marketplace ATVPDKIKX0DER</Message>
    </Error>
    <ResponseMetadata>
        <RequestId>3e8e64e8-edd7-4b63-a855-fa44094951ff</RequestId>
    </ResponseMetadata>
</ErrorResponse>

↑ トップへ戻る