Prev Next

OfferListings

The OfferListings response group returns the OfferListings for items returned in the response. The values returned are similar to those returned by the Offers response group minus the values returned by the OfferSummary response group.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes and shows the parentage of the elements returned by OfferListings. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

Response ElementAncestryDefinition
Amount

OfferSummary/LowestCollectiblePrice/Amount

OfferSummary/LowestNewPrice/Amount

OfferSummary/LowestRefurbishedPrice/Amount

OfferSummary/LowestUsedPrice/Amount

Offers/Offer/OfferListing/Price/Amount

Offers/Offer/OfferListing/SalePrice/Amount

Price in terms of the lowest currency denomination, for example, pennies of the item offered for sale.
Availability Offers/Offer/OfferListing/AvailabilityHow soon the item can be shipped.
AverageFeedbackRating Offers/Offer/Seller/AverageFeedbackRatingCustomer review of an item represented by a number of stars where 5 stars is the highest rating, 0 the lowest. This element contains the average of all customer ratings of the item.
City Offers/Offer/OfferListing/ISPUStoreAddress/CityThe city where the store is that you can pick up the item.
CodeErrors/Error/Code Number that uniquely identifies an error.
Condition Offers/Offer/OfferAttributes/ConditionThe condition of the item, for example, new, used, collectible, or refurbished.
ConditionNote Offers/Offer/OfferAttributes/ConditionNoteA note that describes the Condition.
Country Offers/Offer/OfferListing/ISPUStoreAddress/CountryThe country where the store is that you can pick up the item.
CurrencyCode

OfferSummary/LowestCollectiblePrice/CurrencyCode

OfferSummary/LowestNewPrice/CurrencyCode

OfferSummary/LowestRefurbishedPrice/CurrencyCode

OfferSummary/LowestUsedPrice/CurrencyCode

Offers/Offer/OfferListing/Price/CurrencyCode

Offers/Offer/OfferListing/SalePrice/CurrencyCode

An abbreviation that specifies the formatting to use when displaying the price.
ExchangeId

Offers/Offer/OfferListing/ExchangeId

OfferSummary/LowestNewPrice/FormattedPrice

OfferSummary/LowestRefurbishedPrice/FormattedPrice

OfferSummary/LowestUsedPrice/FormattedPrice

Offers/Offer/OfferListing/Price/FormattedPrice

Offers/Offer/OfferListing/SalePrice/FormattedPrice

Token that uniquely identifies an offer in the Marketplace. Exchange IDs are available for every item offered by a third-party seller. When using ExchangeId, you must also specify a matching SellerID and ASIN.
FormattedPrice

OfferSummary/LowestCollectiblePrice/FormattedPrice

OfferSummary/LowestNewPrice/FormattedPrice

OfferSummary/LowestRefurbishedPrice/FormattedPrice

OfferSummary/LowestUsedPrice/FormattedPrice

Offers/Offer/OfferListing/Price/FormattedPrice

Offers/Offer/OfferListing/SalePrice/FormattedPrice

The price formatted according to the CurrencyCode parameter.
GlancePage

Offers/Offer/Seller/Glancepage

Offers/Offer/Merchant/GlancePage

URL of a seller's web page. A GlancePage is not returned when the merchant is Amazon.
IsEligibleForSuperSaverShipping Offers/Offer/OfferListing/IsEligibleForSuperSaverShippingSpecifies whether the items is eligible for super saving shipping.
MerchantId Offers/Offer/Merchant/MerchantIdA number that uniquely identifies a merchant
Message Errors/Error/Code Description of the error.
Name Offers/Offer/OfferListing/ISPUStoreAddress/NameThe name of the store where you can pick up the item.
OfferListingId Offers/Offer/OfferListing/OfferListingIdA number that uniquely identifies an offer listing. This number represents a sales offer from a specific merchant.
SellerId Offers/Offer/Seller/SellerIdA number that uniquely identifies a seller.
State Offers/Offer/OfferListing/ISPUStoreAddress/StateThe state in which the store is where the customer will pick up the item when in store pickup (ISPU) has been specified.
SubCondition Offers/Offer/OfferAttributes/SubConditionFurther specifies the Condition of an item, for example, mint, verygood, good. Typically used to qualify the condition of a Used item.
TotalFeedback Offers/Offer/Seller/TotalFeedbackAverage rating of the customers' feedback about the seller.
TotalOfferPages Offers/TotalOfferPagesNumber of pages of offers. Up to ten offers are returned per page. By default, the first ten offers are returned in the resonse.
TotalOffers Offers/TotalOffersTotal number of offers.
Value Arguments/Argument/Value Value of the corresponding argument name.

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

Parent Response Group

The following response groups are parent response groups of OfferListings.

Child Response Group

The following response groups arechildren response groups of OfferListings.

Sample REST Use Case

The folllowing request was used to illustrate the XML response elements returned by OfferListings.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[Your Access Key ID Here]]&
AssociateTag=[Your Associate ID Here]&
Operation=ItemSearch&
Keywords=sports&
ResponseGroup=OfferListings

The following response snippet shows the elements returned by OfferListings. 

<Item>
   <ASIN>B000AYGDIO</ASIN>
   <Offers>
      <TotalOffers>18</TotalOffers>
      <TotalOfferPages>2</TotalOfferPages>
      <Offer>
         <Seller>
            <SellerId>A43VGTGXZ8ZI6</SellerId>
         <AverageFeedbackRating>4.9</AverageFeedbackRating>
            <TotalFeedback>300</TotalFeedback>
         </Seller>
         <OfferAttributes>
            <Condition>New</Condition>
            <SubCondition>new</SubCondition>
            <ConditionNote>
               Brand new, unopened and complete in the retail box.
            </ConditionNote>
         </OfferAttributes>
         <OfferListing>
            <OfferListingId>
              pBmLD7%2F4J7zqIMjOLpQI5pkO774zf%2BsvrzbG4JR92xLmC%
            </OfferListingId>
            <ExchangeId>Y01Y4632798Y1053687</ExchangeId>
            <Price>
               <Amount>24700</Amount>
               <CurrencyCode>USD</CurrencyCode>
               <FormattedPrice>$247.00</FormattedPrice>
            </Price>
            <Availability>Usually ships in 1-2 business days</Availability>           <IsEligibleForSuperSaverShipping>0</IsEligibleForSuperSaverShipping>
         </OfferListing>
      </Offer>
      <!-- 9 ADDITIONAL OFFERS -->
   </Offers>
</Item>
Prev Copyright Information Next