Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

Offers

The Offers response group is a parent response group that returns the contents of the OfferSummary response group. It also returns, 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 the customer to add the item to a shopping cart.

Note

The Offers response group returns a single offer for each item condition. For example, if a book is available in the conditions New, Used, and Collectible, an Offers request will return a total of three offers, one for New, one for Used, and one for Collectible.

The are two valid values for MerchantId: Amazon or All. Use Amazon to get only the Amazon offers for an item. Use All (the default value) to return all offers. The Offers response group ignores a MerchantID value of Featured or Featured Buy Box Winner and returns the default value, All.

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

Offer(s) Data Returned by the APIConditionMerchantId
(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

Note

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 uses the Offers response group.

http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
AssociateTag=[Associate ID]&
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. This example returns two offers, one in New condition, and one in Used condition.

<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>
        <IsEligibleForPrime>1</IsEligibleForPrime>
      </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>
        <IsEligibleForPrime>1</IsEligibleForPrime>
      </OfferListing>
    </Offer>
  </Offers>
</Item>