Product Advertising API
Developer Guide (API Version 2013-08-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

Offers Response Group

The Offers response group is a parent response group that returns the contents of the OfferSummary Response Group response group plus, by default, offer listing information. The Offers response group can take Condition and MerchantId as an optional input parameter. By default, the offer for Buy Box winner is returned, which is an item listed in the box on an item's detail page that enables you to add an item to a shopping cart.

The only valid values for MerchantId are Amazon, to get the Amazon offer for an item if it exists, and All, which is the default value. For reasons of reverse compatibility, the Offers response group ignores a MerchantID value of Featured or Featured Buy Box Winner and returns the default value.

The following table shows the expected behavior of the Offers response group for various input parameters:

Optional Input ParametersOffer(s) Data Returned by the API
ConditionMerchantId
(Default)(Default)Buy Box Winner if it exists [OR] Lowest priced new offer.
(Default)AmazonAmazon offer
(Default)Any other valueError: invalid value
Used, New, Refurbished, or Collectible(Default) or AllLowest priced offer for given condition
Used, New, Refurbished, or CollectibleAmazonAmazon offer
Used, New, Refurbished, or CollectibleAny other valueError: invalid value
All(Default)Lowest priced offer for each condition
AllAmazonAmazon offer
(Default)Any other valueError: invalid value

This response group is not returned for Amazon Kindle digital books. An Amazon Kindle ASIN can be verified through the Binding, Format, and ProductTypeName response elements.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by Offers.

Offers also returns the elements that all response groups return, as described in Elements Common to All Response Groups.

Loyalty Points

In the JP locale only, loyalty points are returned. Loyalty points are used to encourage patronage and stimulate sales.

Parent Response Group

The following response groups are parent response groups of Offers.

Child Response Group

The following response groups are child response groups of Offers.

Sample REST Use Case

The following request illustrates the XML response elements returned by Offers.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&
Operation=ItemSearch&
Condition=All&
SearchIndex=Books&
Title=Harry%20Potter&
ResponseGroup=Offers&
Version=2013-08-01
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

Sample Response Snippet

The following response snippet shows the elements returned by Offers.

<Item>
  <ASIN>047061529X</ASIN>
  <OfferSummary>
    <LowestNewPrice>
      <Amount>1025</Amount>
      <CurrencyCode>USD</CurrencyCode>
      <FormattedPrice>$10.25</FormattedPrice>
    </LowestNewPrice>
    <LowestUsedPrice>
      <Amount>1110</Amount>
      <CurrencyCode>USD</CurrencyCode>
      <FormattedPrice>$11.10</FormattedPrice>
    </LowestUsedPrice>
    <TotalNew>37</TotalNew>
    <TotalUsed>12</TotalUsed>
    <TotalCollectible>0</TotalCollectible>
    <TotalRefurbished>0</TotalRefurbished>
  </OfferSummary>
  <Offers>
    <TotalOffers>2</TotalOffers>
    <TotalOfferPages>1</TotalOfferPages>
    <MoreOffersUrl>http://www.amazon.com/gp/offer-listing/047061529X/?SubscriptionId=AKIAI44QH8DHBEXAMPLE&ie=UTF8&tag=adrpik-20&creative=386001&camp=2025&linkCode=xm2 </MoreOffersUrl>
    <Offer>
      <OfferAttributes>
        <Condition>New</Condition>
      </OfferAttributes>
      <OfferListing>
        <OfferListingId>6vZH%2FR4dOoabV7sTSv3vC0Np5xK1c8MKOhAl5HYbCIJhxOLlJw1O2AM6mLYyVhjnI8s2gMkx7yq%2F%2BEC7yKPWkQTqhVhFBeUDm71EdpaYwrXpppfcAL1yPzyQFkOuK6MsK8aLPSNSWVs%3D </OfferListingId>
        <Price>
          <Amount>1025</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$10.25</FormattedPrice>
        </Price>
        <AmountSaved>
          <Amount>974</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$9.74</FormattedPrice>
        </AmountSaved>
        <PercentageSaved>49</PercentageSaved>
        <Availability>Usually ships in 1-2 business days</Availability>
        <AvailabilityAttributes>
          <AvailabilityType>now</AvailabilityType>
          <MinimumHours>24</MinimumHours>
          <MaximumHours>48</MaximumHours>
        </AvailabilityAttributes>
        <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping>
      </OfferListing>
    </Offer>

    <Offer>
      <OfferAttributes>
        <Condition>Used</Condition>
      </OfferAttributes>
      <OfferListing>
        <OfferListingId>uXUlLeu7rH5t3ogkZJ%2Bd11tWCsdsj5kHhjoscRF1D1GuBuDwCyrz0XyR%2BTEOJO7PgpfwLjtX4ojhbXeHZgM0Br4DiWsPhNZTduzvYC8zLgG0z1e%2FgYiiuuR0wTyKqssY6ncHyVjZK1A%3D </OfferListingId>
        <Price>
          <Amount>1110</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$11.10</FormattedPrice>
        </Price>
        <AmountSaved>
          <Amount>889</Amount>
          <CurrencyCode>USD</CurrencyCode>
          <FormattedPrice>$8.89</FormattedPrice>
        </AmountSaved>
        <PercentageSaved>44</PercentageSaved>
        <Availability>Usually ships in 1-2 business days</Availability>
        <AvailabilityAttributes>
          <AvailabilityType>now</AvailabilityType>
          <MinimumHours>24</MinimumHours>
          <MaximumHours>48</MaximumHours>
        </AvailabilityAttributes>
        <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping>
      </OfferListing>
    </Offer>
  </Offers>
</Item>

The Request that Generated the Response (REST)

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]
AssociateTag=[Associate ID]
Operation=ItemLookup&
ItemId=B000AYGDIO&
ResponseGroup=Offers
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]