Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档
亚马逊 MWS 文档

GetCompetitivePricingForSKU

根据 SellerSKU,返回商品的当前有竞争力的价格。

描述

GetCompetitivePricingForSKU 会根据您指定的 SellerSKUMarketplaceId 返回当前具有竞争力的商品定价。请注意,SellerSKU 由您的 SellerId 限定,您提交的每个亚马逊商城网络服务(亚马逊 MWS)操作都需要包含您的 SellerId。此操作会根据以下两种定价模式返回在售商品的价格:新品购买按钮价格和二手商品购买按钮价格。在亚马逊商城网站的详情页面中,这两种定价模式分别相当于主购买按钮价格和次购买按钮价格。请注意,在售商品可能不会返回任何一种价格。例如,如果某件商品的所有卖家都没有资格获得新品购买按钮或者二手商品购买按钮,就可能出现这种情况。您还需要注意,由于响应会包含您为 SellerSKU 设置的自己的价格,因此,如果您的价格是最低商品价格,也会被返回。此外,也会返回您指定的 SellerSKU 的商品数量、售价和销量排行。

注: 请注意:如果您指定的 SellerSKU 表示一个变体父 ASIN,则此操作会返回一个错误。一个变体父 ASIN 代表一类商品,无法直接销售。变体子 ASIN 代表可销售的、具有某些特性(如尺寸和颜色)的商品。

请求参数

名称 描述 必填项
MarketplaceId

商城编码。指定返回价格的商城。

类型:xs:string

SellerSKUList

一个 SellerSKU 值的结构化列表。用于标识指定商城中的商品。SellerSKU 由您的 SellerId 限定,您提交的每个亚马逊商城网络服务(亚马逊 MWS)操作都需要包含您的 SellerId。

最大值:20 个 SellerSKU

响应元素

GetCompetitivePricingForSKU 操作返回的响应元素通过以下通用 XSD 描述:ProductsAPI_Response.xsd。下表提供了关于 GetCompetitivePricingForSKU 操作所返回的一些关键元素的更多信息。

名称 描述
Product 包含 ProductsAPI_Response.xsd 中 Product 元素的三个子元素。这些子元素是:IdentifiersCompetitivePricingSalesRankings
Identifiers
包含以下能够唯一标识商品的编码:
  • MarketplaceASINMarketplaceIdASIN 组合。
  • SKUIdentifierMarketplaceIdSellerSKUSellerId 组合。
CompetitivePricing

包含所返回的商品的定价信息。

以下是一些关键的子元素:

  • CompetitivePrice。包含定价信息。CompetitivePrice 元素包含以下属性:
    • Condition。表明返回其定价信息的商品的状况。可能的值为:NewUsedCollectibleRefurbishedClub
    • subcondition。表明返回其定价信息的商品的子状况。可能的值为:NewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen BoxOther
    • belongsToRequester。表明商品的定价信息是否来自请求提交人。请求提交人是指与请求一同提交的 SellerId 所关联的卖家。可能的值为:truefalse
  • CompetitivePriceId。所返回的各个价格的定价模式。有效值:12。值定义:1 = 新品购买按钮价格,2 = 二手商品购买按钮价格。
  • Price。给定的 CompetitivePriceId 值的定价信息。包括商品价格,还可以选择是否包括运费和到岸价格(商品价格+运费)。请注意,有时可能没有运费。
  • NumberOfOfferListings。所提交的在售商品的数量。在 OfferListingCount 子元素中,按商品状况返回商品计数,每个返回的商品状况值对应一个商品计数。可能的商品状况值为:AnyNewUsedCollectibleRefurbishedClub
  • TradeInValue。亚马逊以旧换新计划的商品抵换价格。有关亚马逊以旧换新计划的更多信息,请参阅亚马逊网站帮助页面中的“亚马逊以旧换新计划”部分。
SalesRankings

按商品分类排列的商品销量排行信息。

关键子元素:
  • ProductCategoryId。表明根据哪个商品分类进行销量排行。
  • Rank。商品在其商品分类中的销量排行。

示例

查询请求示例

https://mws.amazonservices.com/Products/2011-10-01
?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetCompetitivePricingForSKU
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&SellerId=A1IMEXAMPLEWRC
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A14%3A27Z
&Version=2011-10-01
&Signature=wJI6EXAMPLE2Bfa46Ej%2BD1NwsIG%2Bjdyp828HHEXAMPLEY%3D
&SignatureMethod=HmacSHA256
&MarketplaceId=ATVPDKIKX0DER
&SellerSKUList.SellerSKU.1=SKU2468

响应示例

<?xml version="1.0"?>
<GetCompetitivePricingForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetCompetitivePricingForSKUResult SellerSKU="SKU2468" status="Success">
  <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"
           xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
    <Identifiers>
      <MarketplaceASIN>
        <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
        <ASIN>1933890517</ASIN>
      </MarketplaceASIN>
      <SKUIdentifier>
        <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
        <SellerId>A1IMEXAMPLEWRC</SellerId>
        <SellerSKU>SKU2468</SellerSKU>
      </SKUIdentifier>
    </Identifiers>
    <CompetitivePricing>
      <CompetitivePrices>
        <CompetitivePrice belongsToRequester="false" condition="New" subcondition="New">
          <CompetitivePriceId>1</CompetitivePriceId>
          <Price>
            <LandedPrice>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>40.03</Amount>
            </LandedPrice>
            <ListingPrice>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>40.03</Amount>
            </ListingPrice>
            <Shipping>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>0.00</Amount>
            </Shipping>
          </Price>
        </CompetitivePrice>
        <CompetitivePrice belongsToRequester="false" condition="Used" subcondition="Good">
          <CompetitivePriceId>2</CompetitivePriceId>
          <Price>
            <LandedPrice>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>30.50</Amount>
            </LandedPrice>
            <ListingPrice>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>30.50</Amount>
            </ListingPrice>
            <Shipping>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>0.00</Amount>
            </Shipping>
          </Price>
        </CompetitivePrice>
      </CompetitivePrices>
      <NumberOfOfferListings>
        <OfferListingCount condition="Any">296</OfferListingCount>
        <OfferListingCount condition="Used">145</OfferListingCount>
        <OfferListingCount condition="New">151</OfferListingCount>
      </NumberOfOfferListings>
      <TradeInValue>
        <CurrencyCode>USD</CurrencyCode>
        <Amount>17.05</Amount>
      </TradeInValue>
    </CompetitivePricing>
    <SalesRankings>
      <SalesRank>
        <ProductCategoryId>book_display_on_website</ProductCategoryId>
        <Rank>900</Rank>
      </SalesRank>
      <SalesRank>
        <ProductCategoryId>271578011</ProductCategoryId>
        <Rank>1</Rank>
      </SalesRank>
      <SalesRank>
        <ProductCategoryId>355562011</ProductCategoryId>
        <Rank>8</Rank>
      </SalesRank>
      <SalesRank>
        <ProductCategoryId>173516</ProductCategoryId>
        <Rank>25</Rank>
      </SalesRank>
    </SalesRankings>
  </Product>
</GetCompetitivePricingForSKUResult>
<ResponseMetadata>
  <RequestId>003fc73e-bf70-4e55-8db8-EXAMPLEce417</RequestId>
</ResponseMetadata>
</GetCompetitivePricingForSKUResponse>