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.
Operations that can use this response group include:
ItemLookup
ItemSearch
ListLookup
SimilarityLookup
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 Element | Ancestry | Definition |
|---|---|---|
| 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/Availability | How soon the item can be shipped. |
AverageFeedbackRating
| Offers/Offer/Seller/AverageFeedbackRating | Customer 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. |
| Code | Errors/Error/Code | Number that uniquely identifies an error. |
Condition
| Offers/Offer/OfferAttributes/Condition | The condition of the item, for example, new, used, collectible, or refurbished. |
ConditionNote
| Offers/Offer/OfferAttributes/ConditionNote | A note that describes the Condition. |
Country
| Offers/Offer/OfferListing/Country | The country a store is in. |
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/IsEligibleForSuperSaverShipping | Specifies whether the items is eligible for super saving shipping. |
MerchantId
| Offers/Offer/Merchant/MerchantId | A number that uniquely identifies a merchant |
Message
| Errors/Error/Code | Description of the error. |
Name
| Offers/Offer/OfferListing/Name | The name of the store. |
OfferListingId
| Offers/Offer/OfferListing/OfferListingId | A number that uniquely identifies an offer listing. This number represents a sales offer from a specific merchant. |
SellerId
| Offers/Offer/Seller/SellerId | A number that uniquely identifies a seller. |
State
| Offers/Offer/OfferListing/State | The state the store is in. |
SubCondition
| Offers/Offer/OfferAttributes/SubCondition | Further specifies the Condition of an item, for example, mint, very good, good. Typically used to qualify the condition of a Used item. |
TotalFeedback
| Offers/Offer/Seller/TotalFeedback | Average rating of the customers' feedback about the seller. |
TotalOfferPages
| Offers/TotalOfferPages | Number of pages of offers. Up to ten offers are returned per page. By default, the first ten offers are returned in the response. |
TotalOffers
| Offers/TotalOffers | Total 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.
The following response groups are parent response groups of OfferListings.
None
The following response groups are children response groups of OfferListings.
None
The following 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>