API Reference

The following sections of the guide provide reference material for the Amazon Associates Web Service. For more information about any concepts or programming tasks associated with the reference material, refer to the previous chapters in this guide.

The API Reference is divided into the following sections:

This chapter provides a description of all ECS response elements.

Response Element

Definition

About

Describes the seller.

Ancestry: Seller/About

AboutMe

Information a customer supplies about themselves

Ancestry: Seller/About

Actor

Actor associated with the item.

Ancestry: ItemAttributes

AdditionalName

For baby registries, this field is used for the name of the other parent.

Ancestry: List/AdditionalName

Address1

Street address

Ancestry: ItemAttributes/Address

Offers/Offer/OfferListing/Address1

Address2

Street address

Ancestry: ItemAttributes/Address

Offers/Offer/OfferListing/Address2

Address3

Street address

Ancestry: ItemAttributes/Address

Offers/Offer/OfferListing/Address3

AlternateVersion

Container for AlternateVersion information, including ASIN, Title, and Binding.

Ancestry: None

AmazonMaximumAge

Maximum age in months of the person who will enjoy the item. For example, a book might be targeted at kids up to three years old. Three would be the value for the MaximumAge.

Ancestry: ItemAttributes

AmazonMinimumAge

Youngest age in months that a person should be to use the item.

Ancestry: ItemAttributes

Amount

Price in terms of the lowest currency denomination, for example, pennies. The price, in terms of the lowest currency denomination, for example, pennies, of an item in the cart. The total price, in terms of the lowest currency denomination, of one or more of the same item in the Saved For Later area. If, for example, Saved For Later contains two orders of the same book, this amount would be the sum total of those two books.

Ancestry: ItemAttributes/ListPrice OfferSummary/LowestUsedPrice

OfferSummary/LowestCollectiblePrice

OfferSummary/LowestNewPrice OfferSummary/LowestRefurbishedPrice/Amount

Offers/Offer/OfferListing/Price/Amount

Offers/Offer/OfferListing/SalePrice/Amount

Transaction/TransactionItems/TransactionItem/UnitPrice

VariationSummary/LowestPrice

VariationSummary/HighestSalePrice

ApertureModes

Aperture modes associated with items that have lenses.

Ancestry: ItemAttributes

Artist

Artist associated with the item.

Ancestry: ItemAttributes

ASIN

A positive integer distributed by Amazon that uniquely identifies an item. ASIN of the new release, item, or similar item

Ancestry: Item/ASIN CartItem SavedForLaterItem Cart/NewReleases/NewRelease NewReleases/NewRelease/ASIN OtherCategoriesSimilarProduct/ASIN SimilarProduct SimilarViewedProduct, CustomerReviews/Review

AspectRatio

The ratio of an item's length to its width.

Ancestry: ItemAttributes

AudienceRating

Audience rating for a movie. The rating suggests the age for which the movie is appropriate. The rating format varies by locale.

Ancestry: ItemAttributes

AudioFormat

Format, such as MP3, of the audio media.

Ancestry: ItemAttributes/Languages/Language

Author

Author associated with the item.

Ancestry: ItemAttributes

Availability

How soon the item can be shipped.

Ancestry: Offers/Offer/OfferListing/Availability

AvailabilityAttributes

Container for availability information, including AvailabilityType, MaximumHours and MinimumHours.

Ancestry: Offers/Offer/OfferListing

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.

Ancestry: Offers/Offer/Seller/AverageFeedbackRating

AverageRating

An average of all of the ratings entered by customers where 5 is the best.

Ancestry: CustomerReviews, List

BackFinding

The metal in jewelry, for example, 14 K gold.

Ancestry: ItemAttributes

BandMaterialType

Type of material used to make the band in a piece of jewelry.

Ancestry: ItemAttributes

Batteries

Batteries required or not

Ancestry: ItemAttributes

BatteriesIncluded

Whether batteries are included

Ancestry: ItemAttributes

BatteryDescription

A description of the batteries that are required for the item to work.

Ancestry: ItemAttributes

BatteryType

Required battery type

Ancestry: ItemAttributes

Benefit

Container for information relating to a promotional benefit.

Ancestry: Benefits

Benefits

Containter for one or more Benefit elements.

Ancestry: None

BenefitType

Specifies the type of promotion, for example, Free, FixedAmountOff, PercentOff, and TieredFixedAmountOff.

Ancestry: Benefits/Benefit/BenefitType

BenefitDescription

Text that describes the promotion.

Ancestry: Offers/Offer/Promotions/Promotion/Summary

BezelMaterialType

Material that makes up the bezel of jewelry, for example, a ring.

Ancestry: ItemAttributes

BinItemCount

Number of items in a bin.

Ancestry: SearchBinSets/SearchBinSet/Bin/BinItemCount

BinName

Name of the bin.

Ancestry: SearchBinSets/SearchBinSet/Bin/BinName

Binding

Typically but not always similar to the product category.

Ancestry: ItemAttributes

Birthday

A customer's birth date.

Ancestry: CustomerFull

Brand

An item's brand.

Ancestry: ItemAttributes, Large, Medium

BrowseNodeId

A positive integer that uniquely identifies a parent product category.

Ancestry: BrowseNode/Ancestors/BrowseNode BrowseNode/Children/BrowseNode

CalendarType

Type of calendar

Ancestry: ItemAttributes

CameraManualFeatures

Manual features of a camera

Ancestry: ItemAttributes

CartId

A positive integer that uniquely identifies a cart. All operations on a cart must include this value, which is generated by CartCreate.

Ancestry: Cart

CartItem

A parent element for many child elements, including CartItemId, MerchantId, SellerId, Quantity, Title, ProductGroup, Price, and ItemTotal.

Ancestry: Cart/CartItems

CartItemId

A positive integer that uniquely identifies an item in a cart or in the Saved For Later area. You must use this value to modify cart items or Saved For Later items. Other identifiers, such as ASINs, do not work.

Ancestry: CartItem

SavedForLaterItem

CartItems

A parent element for many child elements, including SubTotal, and CartItem.

Ancestry: Cart

CaseDiameter

Distance from corner to corner of a case

Ancestry: ItemAttributes

CaseMaterialType

The material of which a case is made.

Ancestry: ItemAttributes

CaseThickness

Thickness of a case

Ancestry: ItemAttributes

CaseType

Type of case

Ancestry: ItemAttributes

Category

Specifies the kind of promotion. Valid values include FreeShipping, BuyAmountXGetAmountOffX, and ForEachAmountXGetAmountOffX. For more information, see Promotion Types.

Ancestry: Offers/Offer/Promotions/Promotion/Summary

CDRWDescription

Description of CD read-write peripheral device.

Ancestry: ItemAttributes

ChainType

Type of chain, typically, in jewelry.

Ancestry: ItemAttributes

City

City

Ancestry: ItemAttributes/Address

ClaspType

Type of clasp on a piece of jewelry

Ancestry: ItemAttributes

ClothingSize

Size of clothes

Ancestry: ItemAttributes

Code

Number that uniquely identifies an error.

Ancestry: Errors/Error

Collection

Container for items that are part of a collection. For more information, see Collections

Ancestry: None

CollectionItem

An item that is part of a collection of items. For more information, see Collections

Ancestry: None

CollectionParent

The parent item has an ASIN but it cannot be purchase. It names the collection. CollectionItems are children of the Collection Parent and can be purchased. For more information, see Collections

Ancestry: None

Collections

Container for one or more collection objects. For more information, see Collections

Ancestry: None

Color

Color

Ancestry: ItemAttributes

Comment

Comment typically about the purpose of the list.

Ancestry: List, ListItems

Compatibility

Compatibility

Ancestry: ItemAttributes

ComponentType

Specifies what the promotion applies to, for example, Shipping, ItemPrice, Subtotal.

Ancestry: Benefits/Benefit

Condition

Specifies the condition of the item, such as new, used, collectible, or refurbished.

Ancestry: SellerListing/Condition Offers/Offer/OfferAttributes/Condition

ConditionNote

A note that describes the Condition.

Ancestry:

Content

The content of the review.

Ancestry: Offers/Offer/OfferAttributes/ConditionNote

CorrectedQuery

A parent element that contains the elements related to a corrected keyword. See Keywords.

Ancestry: Items

Country

A customer's country.

Ancestry: CustomerFull, CustomerInfo, OfferFull, OfferListings

CouponCombinationType

Specifies the kinds of promotional coupons that can be combined, for example, Unrestricted, Preferential, and Exclusive.

Ancestry: None

CPUManufacturer

Manufacturer of the CPU

Ancestry: ItemAttributes

CPUSpeed

CPU speed

Ancestry: ItemAttributes

CPUType

CPU type, such as P4.

Ancestry: ItemAttributes

Creator

Creator associated with the item.

Ancestry: ItemAttributes

CreationDate

The date an API element was created.

Ancestry: Help

CurrencyAmount

Price in terms of the lowest currency denomination, for example, pennies.

Ancestry: EligibilityRequirements/EligibilityRequirement/

CurrencyCode

An abbreviation that specifies the format of the price for the associated locale.

Ancestry:

ItemAttributes/ListPrice

CartItem/ItemTotal

Cart/SavedForLaterItems/SubTotal

Cart/CartItems/SubTotal

SavedForLaterItem/ItemTotal

SavedForLaterItem/Price

CartItem/Price

Cart/SubTotal

EligibilityRequirements/EligibilityRequirement/CurrencyAmount

Benefits/Benefit/FixedAmount

OfferSummary/LowestCollectiblePrice/CurrencyCode

OfferSummary/LowestNewPrice/CurrencyCode

OfferSummary/LowestRefurbishedPrice/CurrencyCode

OfferSummary/LowestUsedPrice/CurrencyCode

Offers/Offer/OfferListing/Price/CurrencyCode

Offers/Offer/OfferListing/SalePrice/CurrencyCode

Transaction/Totals/Total

VariationSummary/HighestPrice VariationSummary/LowestSalePrice VariationSummary/HighestSalePrice VariationSummary/LowestPrice

CustomerId

A positive number distributed by Amazon that unqiely identifies a customer who entered a review.

Ancestry: CustomerReviews/Review/CustomerId

CustomerName

Name of the list owner.

Ancestry: List/CustomerName

CustomerNickname

Nickname of list owner

Ancestry: List

CustomerReview

A review of a seller submitted by a customer.

Ancestry: CustomerFull, CustomerReviews

CustomerReviews

A containter for one or more CustomerReview objects.

Ancestry: CustomerFull, CustomerReviews

Date

The date the review was created.

Ancestry: CustomerReviews/Review

DateAdded

Date the item was added to the list.

Ancestry: ListItem/DateAdded

DateCreated

Date the list was created, in the form yyyy-mm-dd.

Ancestry: List/DateCreated

Day

Day

Ancestry: ItemAttributes/HoursOfOperation/Hours

DelayBetweenShots

The necessary delay between shots.

Ancestry: ItemAttributes

Department

Department

Ancestry: ItemAttributes

Details

Container for all of the elements that describe a promotion.

Ancestry:

DetailPageURL

URL of the detail page, which describes an item and enables the customer to add it to their cart.

Ancestry: ItemAttributes

DeweyDecimalNumber

Dewey decimal number

Ancestry: ItemAttributes

DialColor

Color of the dial, typically, of a watch face

Ancestry: ItemAttributes

DialWindowMaterialType

Material that makes up the transparent face of a watch.

Ancestry: ItemAttributes

DigitalZoom

Specifies the zoom ratio.

Ancestry: ItemAttributes

Director

Director

Ancestry: ItemAttributes

DisplaySize

Size of the display, typically the length of the diagonal across the display surface.

Ancestry: ItemAttributes

DistinctUsers

Number of different users that created tags for an entity.

Ancestry: Tagged Items, TaggedListmaniaLists, Tag

DVDLayers

Specifies whether the DVD is a dual-layer DVD-9 movie or a single-layer DVD-5 movie.

Ancestry: ItemAttributes

DVDRWDescription

Description of the DVD player's read and write functionality.

Ancestry: ItemAttributes

DVDSides

Specifies whether one or two sides of the DVD has recorded information.

Ancestry: ItemAttributes

EAN

European Article Number, which is a number that uniquely identifies an item.

Ancestry: ItemAttributes

Edition

Edition

Ancestry: ItemAttributes

EditorialReviewIsLinkSuppressed

Boolean value that specifies whether or not the link to the editorial review is displayed.

Ancestry: EditorialReview

Element

An xml tag returned.

Ancestry: Help

EligibilityRequirement

Containter for one or more EligibilityRequirementType elements.

Ancestry: EligibilityRequirements

EligibilityRequirementDescription

Specifies the conditions necessary to qualify for the promotion.

Ancestry: Offers/Offer/Promotions/Promotion/Summary

EligibilityRequirements

Containter for one or more EligibilityRequirement elements.

Ancestry: None

EligibilityRequirementType

Specifies the eligibility requirements to qualify for the promotion, for example, MinPurchase, MinQuantity, or, ForEachQuantity.

Ancestry: EligibilityRequirements/EligibilityRequirement

EndDate

Specifies a date when the item will stop being sold. Or, specifies the last day and ending time (GMT) of the promotion.

Ancestry: SellerListing/EndDate, Offers/Offer/Promotions/Promotion/Summary

ExchangeId

Token that uniquely identifies an SDP-Marketplace, auction, Merchant@, Merchant.Com listings, or 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.

Ancestry:

SellerListing

SavedForLaterItem

OfferSummary/LowestNewPrice/FormattedPrice

OfferSummary/LowestRefurbishedPrice/FormattedPrice

OfferSummary/LowestUsedPrice/FormattedPrice

Offers/Offer/OfferListing/Price/FormattedPrice

Offers/Offer/OfferListing/SalePrice/FormattedPrice

CartItem

ESRBAgeRating

The Entertainment Software Rating Board (ESRB) sets ratings, advertising guidelines, and online privacy principles for video and computer games in the United States and Canada. The value, CEROAgeRating specifies that a video or software game (search indices Software and VideoGames) is suitable for everyone to play.

Ancestry: ItemAttributes

ExternalDisplaySupportDescription

Specifies whether the items supports an external display.

Ancestry: ItemAttributes

FabricType

The type of fabric used in the item.

Ancestry: ItemAttributes

FaxNumber

Fax number

Ancestry: ItemAttributes

Feature

An item's feature

Ancestry: ItemAttributes

Feedback

Provides customer feedback about the seller.

Ancestry:

FeedbackRating

Provides an average customer rating of the merchant where 5 is the best and 0 is the worst.

Ancestry: Seller/FeedbackRating

FirstIssueLeadTime

The wait time to expect before receiving the first issue in a newspaper or magazine subscription.

Ancestry: ItemAttributes

FirstTagging

Container for information relating to the first time the entity was tagged.

Ancestry: TaggedItems, TaggedListmaniaLists, Tag

FixedAmount

Specifies the price in terms of the lowest currency denomination.

Ancestry: Benefits/Benefit

FlavorName

The flavor of an item. Typically used as a variation dimension.

Ancestry: ItemAttributes

FloppyDiskDriveDescription

Description of a computer's floopy drive.

Ancestry: ItemAttributes

Format

An item's format

Ancestry: ItemAttributes

FormattedPrice

The price formatted as it should be displayed to the user. The formatting is specified by CurrencyCode and varies by country. Or, the discounted price formatted for display.

Ancestry: ItemAttributes/ListPrice

SavedForLaterItem/ExchangeId

CartItem/ExchangeId,

EligibilityRequirements/EligibilityRequirement/CurrencyAmount

Benefits/Benefit/FixedAmount

OfferSummary/LowestUsedPrice/FormattedPrice

OfferSummary/LowestCollectiblePrice/FormattedPrice

OfferSummary/LowestNewPrice/FormattedPrice

Transaction/TransactionItems/TransactionItem/TotalPrice

GemType

The type of gem.

Ancestry: ItemAttributes/GemType

GemTypeSetElement

Returns multiple values for the gem types.

Ancestry: Variations/Item/ItemAttributes

GlancePage

URL of a seller's web page. A GlancePage is not returned when the merchant is Amazon.

Ancestry:

Offers/Offer/Seller/Glancepage

Offers/Offer/Merchant/GlancePage

GolfClubFlex

The flex (regular or stiff) of a golf club.

Ancestry: ItemAttributes

GolfClubLoft

The loft (number of degrees) of a golf club.

Ancestry: ItemAttributes

GraphicsCardInterface

The type of computer graphic card interface.

Ancestry: ItemAttributes

GraphicsDescription

Description of the computer graphics card.

Ancestry: ItemAttributes

GraphicsMemorySize

The amount of memory resident on in a computer graphics card.

Ancestry: ItemAttributes

GroupClaimCode

An alphanumeric token to use to claim the promotional benefit.

Ancestry: None

HandOrientation

Left or right handedness

Ancestry: Variations/Item/ItemAttributes

HardDiskCount

Number of hard drives in a computer.

Ancestry: ItemAttributes

HardDiskSize

The amount of memory contained in a hard drive.

Ancestry: ItemAttributes

HardwarePlatform

Hardware

Ancestry: Variations/Item/ItemAttributes

HasAutoFocus

Specifies whether the item has auto focus.

Ancestry: ItemAttributes

HasBurstMode

Specifies whether or not the item has burst mode.

Ancestry: ItemAttributes

HasInCameraEditing

Specifies whether a camera has editing functionality.

Ancestry: ItemAttributes

HasRedEyeReduction

Specifies whether or not the camera has a mechanism for preventing red eyes in pictures.

Ancestry: ItemAttributes

HasSelfTimer

Specifies whether or not the item has a timer.

Ancestry: ItemAttributes

HasTripodMount

Specifies whether or not the item has a mount to connect to a tripod.

Ancestry: ItemAttributes

HasVideoOut

Specifies whether or not the item has an output for video.

Ancestry: ItemAttributes

HasViewfinder

Specifies whether or not the item has a view finder.

Ancestry: ItemAttributes

Height

Height of an item, package, or image.

Ancestry: ItemAttributes/ItemDimensions ItemAttributes/PackageDimensions ImageSets/ImageSet/LargeImage ImageSets/ImageSet/MediumImage ImageSets/ImageSet/SmallImage ImageSets/ImageSet/TinyImaget ImageSets/ImageSet/SwatchImage/Height ItemAttributes

HelpfulVotes

The number of customers who felt that the review was helpful.

Ancestry: CustomerReviews/Review/HelpfulVotes

HMAC

Hashing for Message Authentication (HMAC) is a keyed hash function that is used with a CryptographicHashFunction such as SHA-1 or MD5 that cannot be computed with out the key. This is used to identify and secure a cart. Each cart operation must include this value.

Ancestry: Cart

Hours

Hours

Ancestry: ItemAttributes/HoursOfOperation

HoursOfOperation

Defines the hours of a store's operations.

Ancestry: ItemAttributes

Image

An image associated with a seller's item.

Ancestry: SellerListing/Image

IncludedSoftware

Specifies the software included in the purchase.

Ancestry: ItemAttributes

IncludesMp3Player

Specifies whether or not the item contains an MP3 player.

Ancestry: ItemAttributes

Ingredients

Ingredient

Ancestry: ItemAttributes

IngredientsSetElement

Multiple ingredients. Used instead of Ingredients when the item is made of more than one ingredient.

Ancestry: Variations/Item/ItemAttributes

IsAutographed

Specifies whether or not the item is autographed.

Ancestry: ItemAttributes

ISBN

ISBN number

Ancestry: ItemAttributes

IsCategoryRoot

Boolean value that specifies if the browse node is at the top of the browse node tree.

Ancestry: BrowseNodes

IsEligibleForSuperSaverShipping

Specifies whether the items is eligible for super saving shipping.

Ancestry: Offers/Offer/OfferListing/IsEligibleForSuperSaverShipping

IsEmailNotifyAvailable The value of IsEmailNotifyAvailable is a boolean where 1 means that an Email can be sent when the item is in stock, 0 when an Email cannot be sent. This functionality is not available for all offers.

IsFragile

Species whether or not the item is fragile.

Ancestry: ItemAttributes

IsInBenefitSet

A boolean value. When True, the associated ASIN is what the customer receives as part of the promotion.

Ancestry: ItemApplicability

IsInEligibilityRequirementSet

A boolean value. When True, the associated ASIN is what the customer must purchase to qualify for the promotion.

Ancestry: ItemApplicability

IsLabCreated

Specifies whether or not the item was created in a lab.

Ancestry: ItemAttributes

IsLinkSuppressed

"1" (true) if there were any HTML links in editorial reviews that have been suppressed.

Ancestry: EditorialReview

IsMemorabilia

Specifies whether the item is considered memorabilia.

Ancestry: ItemAttributes

ISOEquivalent

The ISO equivalent of a digital camera is what the film sensitivity would be if the camera used film. The higher the number, the more sensitive the camera, the less light required to take the photograph.

Ancestry: ItemAttributes

Item

Container for information about an item.

Ancestry: ItemAttributes

ItemApplicability

Container for ASIN, IsInBenefitSet, and IsInEligibilityRequirementSet. This group of values specifies whether the ASIN is what the customer receives as part of the promotion, whether the ASIN is what the customer needs to purchase to qualify for the promotion, or both.

Ancestry:

ItemApplicability/ItemApplicability

IssuesPerYear

Number of issues per year, usually, in a subscription.

Ancestry: ItemAttributes

IsValid

Boolean value that specifies whether the request syntax was correct.

Ancestry: Request

ItemAttributes

Container for many attributes that describe an item.

Children: Over 200 elements.

KeyboardDescription

Description of the keyboard

Ancestry: ItemAttributes

Keywords

The (corrected) words used in a search.

Ancestry:

Items/CorrectedQuery

Label

Label

Ancestry: ItemAttributes

LargeImage

Container for a large image

Ancestry:

ImageSets/ImageSet

LastModified

Date when the list was last modified

Ancestry:

List/LastModified

LastTagging

Container for information relating to the last time the entity was tagged.

Ancestry: TaggedItems, TaggedListmaniaLists, Tag

LegalDisclaimer

Legal disclaimer

Ancestry: ItemAttributes

Length

Length

Ancestry: ItemAttributes/ItemDimensions ItemAttributes/PackageDimensions/Length ItemAttributes

LineVoltage

The voltage used.

Ancestry: ItemAttributes

ListId

A positive integer distributed by Amazon that uniquely identifies a list.

Ancestry: ListmaniaLists/ListmaniaList

ListingId

A number that uniquely identifies a seller's item within a given year. This values, also known as the Exchange Code, is a shortened form of the ExchangeId, whose uniqueness is not limited to a single year.

Ancestry: SellerListing/ListingId

ListItemId

A number that uniquely identifies an item on a list.

Ancestry: ListItem/ListItemId

ListName

Name of a Listmania list.

Ancestry:

ListmaniaLists/ListmaniaList List

ListOwner

Name of the list owner.

Ancestry:

CartItem

SavedForLaterItem

ListType

The type of list an item in the cart is on. The item might be in the Saved For Later area.

Ancestry:

CartItem

SavedForLaterItem

ListURL

URL where you can find the list. The URL is the same for all lists except for the final filename, which is the ListId. In this way you can display the list by just knowing the ListId.

Ancestry: List

Location

Location of the seller.

Ancestry:

Seller/Location

LoyaltyPoints

In the JP locale only, loyalty points are returned. Loyalty points are used to generate sales.

Ancestry:

Offers/Offer

LoyaltyPoints

The number of points awarded as part of a purchase. Points translate into rewards.

Ancestry:

Offers, VariationOffers

MacroFocusRange

Describes the macro focus feature.

Ancestry: ItemAttributes

MagazineType

Describes the genre of the magazine.

Ancestry: ItemAttributes

Manufacturer

Manufacturer

Ancestry: ItemAttributes

ManufacturerLaborWarrantyDescription

Describes the manufacturer's labor warranty

Ancestry: ItemAttributes

ManufacturerMaximumAge

Defines the maximum age in months the user should be to enjoy the use of the item. For example, for a toy targeted at kids from ages 2 to 4, 4 would be the value for the ManufacturerMaximumAge.

Ancestry: ItemAttributes

ManufacturerMinimumAge

Defines the minimum age in months the user should be to enjoy the use of the item. For example, for a toy targeted at kids from ages 2 to 4, 2 would be the value for the ManufacturerMiniimumAge.

Ancestry: ItemAttributes

ManufacturerPartsWarrantyDescription

Describes the manufacturer's parts warranty

Ancestry: ItemAttributes

MaterialType

The type of material used in the item.

Ancestry: ItemAttributes

MaterialTypeSetElement

Returns multiple values describing the different materials that constitute the item.

Ancestry:

Variations/Item/ItemAttributes

MaximumAperture

The larges lens aperture

Ancestry: ItemAttributes

MaximumColorDepth

The number of bytes used to display colors in digital media.

Ancestry: ItemAttributes

MaximumFocalLength

The maximum focal length of the lens.

Ancestry: ItemAttributes

MaximumHighResolutionImages

The highest image resolution provided by the item.

Ancestry: ItemAttributes

MaximumHours

The maximum number of hours for which the item might be available.

Ancestry:

Offers/Offer/OfferListing/AvailabilityAttributes

MaximumHorizontalResolution

The highest resolution provided on the horizontal axis--the higher the number, the greater the resolution.

Ancestry: None

MaximumLowResolutionImages

The lowest image resolution an item provides.

Ancestry: ItemAttributes

MaximumResolution

The highest image resolution an item provides.

Ancestry: ItemAttributes

MaximumShutterSpeed

The fastest speed of a camera shutter, This value is an of time.The unit of time is captured in the Units element.

Ancestry: ItemAttributes

MaximumVerticalResolution

Highest image resolution on the vertical axis.

Ancestry: ItemAttributes

MaximumWeightRecommendation

The maximum weight an item should hold.

Ancestry: ItemAttributes

MediumImage

Container for a medium image

Ancestry:

ImageSets/ImageSet

MemorySlotsAvailable

Specifies whether or not the item has slots for memory additions.

Ancestry: ItemAttributes

MerchandisingMessage

MerchandisingMessage contains text entered by a merchant that describes a promotion.

Ancestry: None

MerchantId

A positive integer distributed by Amazon that uniquely identifies a merchant. Or, the legacy merchant ID that is associated with the promotion. In contrast, the element, OwningMerchantId, is an updated ID for the same merchant. These IDs may or may not be the same.

Ancestry:

CartItem

SavedForLaterItem

Message

Message, or, a description of an error.

Ancestry:

Items/CorrectedQuery, Errors/Error

MetalStamp

A distinctive marking in metal usually associated with jewelry.

Ancestry: ItemAttributes

MetalType

The type of metal used in the item.

Ancestry: ItemAttributes

MinimumHours

The minimum number of hours for which the item is available.

Ancestry:

Offers/Offer/OfferListing/AvailabilityAttributes

MiniMovieDescription

Short description of a movie.

Ancestry: ItemAttributes

MinimumFocalLength

The shortest focal length of an item.

Ancestry: ItemAttributes

MinimumShutterSpeed

The longest time a camera shutter can stay open.

Ancestry: ItemAttributes

Model

Model

Ancestry: ItemAttributes

ModemDescription

Description of a modem.

Ancestry: ItemAttributes

MonitorSize

Size of a monitor expressed as the length between opposite corners of the monitor

Ancestry: ItemAttributes

MonitorViewableDiagonalSize

The length between opposite corners of the monitor in which the image actually appears.

Ancestry: ItemAttributes

MouseDescription

Description of a computer mouse.

Ancestry: ItemAttributes

MPN

Manufacturer's part number.

Ancestry: ItemAttributes

Name

Name of customer of item in a bin. Or, the name of a parameter passed in the request.

Ancestry: ItemAttributes/Address ItemAttributes/Languages/Language BrowseNode/Ancestors/BrowseNode BrowseNode/Children/BrowseNode, Seller, SearchBinSets, SearchBinSet/Bin/BinParameter, Arguments/Argument

NativeResolution

The maximum resolution of a flat panel display.

Ancestry: ItemAttributes

Neighborhood

Neighborhood

Ancestry: ItemAttributes

NetworkInterfaceDescription

Description of the item's network interface.

Ancestry: ItemAttributes

Nickname

Seller's nickname

Ancestry:

SellerListing/Seller

NotebookDisplayTechnology

Describes the technology used in the notebook computer's display

Ancestry: ItemAttributes

NotebookPointingDeviceDescription

Describes the pointing device used by the notebook computer.

Ancestry: ItemAttributes

Number

An attribute in the Disc tag that denotes the CD number in the item, for example, <Disc Number="1">. Items with multiple CDs would have multiple values for Disc. Or, an attribute in the Track tag that denotes the track number on the CD, for example, <Track Number="9">Now Or Never</Track>.

Ancestry:

Tracks/Disc

Tracks/Disc/Track

NumberOfDiscs

Number of discs an item can hold or use.

Ancestry: ItemAttributes

NumberOfIssues

Number of issues in a subscription.

Ancestry: ItemAttributes

NumberOfItems

Number of items.

Ancestry: ItemAttributes

NumberOfPages

Number of pages.

Ancestry: ItemAttributes

NumberOfPearls

Number of pearls in an item

Ancestry: ItemAttributes

NumberOfRapidFireShots

The number of shots that can be fired sequentially.

Ancestry: ItemAttributes

NumberOfStones

Number of stones in an item

Ancestry: ItemAttributes

NumberOfTracks

Number of recorded track on a CD.

Ancestry: ItemAttributes

OccasionDate

Specifies the date of an occasion, such as a wedding or birthday.

Ancestry:

List/OccasionDate

OfferListingId

A number that uniquely identifies an offer listing. This number represents a sales offer from a specific merchant.

Ancestry:

Offers/Offer/OfferListing

OperatingSystem

Specifies the name of the operating system on a computer.

Ancestry: VariationMatrix

Operation

Specifies the name of the operation, such as ItemLookup.

Ancestry: Help

OpticalZoom

Specifies the optical, as opposed to the electronic, zoom.

Ancestry: ItemAttributes

OriginalReleaseDate

Specifies the date the item was originally released. Items that have been released multiple times have both release dates and original release dates. See ReleaseDate.

Ancestry: ItemAttributes

OtherCategoriesSimilarProducts

Parent element for Title and ASIN of similar products in other product groups

Ancestry: Cart

OwningMerchantId

The merchant ID that is associated with the promotion. OwningMerchantId is an updated ID for MerchantId. These IDs may or may not be the same.

Ancestry: None

PackageQuantity

Quantity in a package

Ancestry:

Variations/Item/ItemAttributes/

Parameter

A parameter that an operation can or must use.

Ancestry: Help

ParentASIN

A parent ASIN for an item in Saved For Later or the Active areas of a cart..

Ancestry:

CartItem

SavedForLaterItem

PartnerName

For wedding registries, this is the name of the bride or groom.

Ancestry:

List/PartnerName

PearlLustre

The luster of the pearl.

Ancestry: ItemAttributes

PearlMinimumColor

The pearl's minimum color.

Ancestry: ItemAttributes

PearlShape

The shape of the pearl.

Ancestry: ItemAttributes

PearlStringingMethod

The means used to string the pearls.

Ancestry: ItemAttributes

PearlSurfaceBlemishes

A description of the surface blemishes on the pearl.

Ancestry: ItemAttributes

PearlType

Pearl type is categorized by the shape and size of the pearl.

Ancestry: ItemAttributes

PearlUniformity

Describes the uniformity of color of the pearl.

Ancestry: ItemAttributes

PhoneNumber

Phone number

Ancestry: ItemAttributes

PhotoFlashType

Description of the camera's flash.

Ancestry: ItemAttributes

PictureFormat

Describes the format of an electronic image.

Ancestry: ItemAttributes

Platform

Operating system.

Ancestry: ItemAttributes

PostalCode

Postal code, such as a zip code.

Ancestry: ItemAttributes/Address

Offers/Offer/OfferListing

Price

A parent element for Amount, CurrencyCode, and FormattedPrice. In this case, the price is for an item in the Active or Saved For Later areas, respectively.

Ancestry:

CartItem

SavedForLaterItem

PriceRating

Defines how expensive an item is. For example, for apparel, 1=under $15 2=$15-30 3=$30-45 4=over $45.

Ancestry: ItemAttributes

ProcessorCount

The number of processors in an item.

Ancestry: ItemAttributes

ProductGroup

The product category an item belongs to. The name of a category, such as sporting goods, to which an item in the cart belongs. The name of a category, such as sporting goods, to which an item in Saved For Later belongs.

Ancestry: ItemAttributes/ProductGroup CartItem/ProductGroup SavedForLaterItem

ProductTypeSubcategory

Subcategory of product type

Ancestry: Variations/Item/ItemAttributes

Promotion

Container for one or more Details elements.

Ancestry:

Offers/OfferPromotions

PromotionCategory

Specifies the kind of promotion. Valid values include FreeShipping, BuyAmountXGetAmountOffX, and ForEachAmountXGetAmountOffX. For more information, see Promotion Types.

Ancestry:

Offers/OfferPromotions/Promotion/Summary

PromotionId

An alphanumeric token that uniquely identifies a promotion.

Ancestry: Offers/Offer/Promotions/Promotion/Summary

Promotions

A container for one or more Promotion elements.

Ancestry:

Offers/Offer

PublicationDate

Publication date.

Ancestry: ItemAttributes

Publisher

Publisher

Ancestry: ItemAttributes

PurchaseURL

A URL that the customer must use to purchase the items in their cart.

Ancestry: Cart

Quantity

The number of a particular item in a cart. Or, the number of items in stock.Or, the number of a particular item in Saved For Later.

Ancestry:

CartItem, SellerListing

SavedForLaterItem

QuantityDesired

The number of items the customer wants.

Ancestry: ListFull, ListItems

QuantityReceived

The number of items the customer received.

Ancestry: ListFull, ListItems

Rating

A customer's rating in their review where a rating of 5 is the best.

Ancestry:

CustomerReviews/Review

ReadingLevel

Describes the reading difficulty of the book.

Ancestry: ItemAttributes

RegistryNumber

Number that identifies a registry, such as a wedding registry.

Ancestry: ListFull

RegionCode

A code that specifies a region.

Ancestry: ItemAttributes

RegistryName

Name of a wedding or baby registry.

Ancestry:

List/RegistryName

RelatedItem

Container for an item that is related to the one specified in the ItemLookup request.

Ancestry: RelatedItems

Children: Item, ASIN , ItemAttributes

RelatedItems

A container for one or more items that are related to the one specified in an ItemLookup request. This value is only returned with the Relateditems response group.

Children: Relationship, Relationshiptype, RelatedItemCount, RelatedItemPageCount, RelatedItemPage, RelatedItem.

RelatedItemsCount

Specifies the number of related items found. This number, however, can be larger than the actual number returned because not all related items found are available.

RelatedItemPage

Specifies which page of related items has been returned.

Ancestry: RelatedItems

RelatedItemPageCount

Specifies the number of pages of related items found. There are up to ten items per page.

Ancestry: RelatedItems

Relationship

Child or parent. Relationships are uni-directional: either parent to child, or child to parent.

Ancestry: RelatedItems

RelationshipType

Specifies how the related item relates to the specified item in the ItemLookup request, for example, Tracks. For more information, go to the ItemLookup page.

Ancestry: RelatedItems

ReleaseDate

Date on which the item was was latest released. Items that have been released multiple times have both release dates and original release dates. See ReleaseDate.

Ancestry: ItemAttributes

RemovableMemory

Specifies whether or not the memory is removable.

Ancestry: ItemAttributes

RequestId

A number that uniquely identifies a request

Ancestry: OperationRequest

ResolutionModes

Specifies the resolution modes of the item.

Ancestry: ItemAttributes

ResponseGroup

An ECS response group.

Ancestry: Help

RingSize

Size of a ring.

Ancestry: ItemAttributes

Role

Role

Ancestry: ItemAttributes/Creator

RunningTime

The duration of a presentation.

Ancestry: ItemAttributes

SalesRank

Indicates how well an item is selling within its product category. The lower the number, the better the item has sold.

Ancestry: Item

SavedForLaterItem

A positive integer that uniquely identifies an item in Saved For Later.

Ancestry:

Cart/SavedForLaterItems

Cart

ScentName

Scent of perfume or cologne

Ancestry:

Variations/Item/ItemAttributes/

SearchBinSet

A means by which to categorize results, such as price range.

Ancestry: SearchBinSets

SearchBinSets

Parent element for SearchBins element.

Ancestry: SearchBinSets

SecondaryCacheSize

Size of the secondary cache.

Ancestry: ItemAttributes

SellerId

A positive integer that uniquely identifies the seller, or the seller of an item that is in either the Active or Saved For Later areas of a cart.

Ancestry:

SavedForLaterItem

SellerListing/Seller

CartItem Offers/Offer/Seller

SellerLegalName

Seller's legal name. This can differ from the Name value. For example, Amazon could be the value for the Name, but Amazon.com for the Legalname.

Ancestry: Seller

SellerNickname

The nickname of the seller of an item in Saved For Later. The nickname is often a less formal version of the merchant's official name, such as, MyCompany, as opposed to MyCompany Ltd..

Ancestry: CartItem, Seller

SettingType

The setting type used in a piece of jewelry.

Ancestry: ItemAttributes

ShaftMaterialType

Material the shaft is composed of

Ancestry:

Variations/Item/ItemAttributes/

ShipmentItems

The items in a specific shipment.

Ancestry:

Transaction/Shipments/Shipment

Shipments

The shipments

Ancestry: Transaction

SimilarProducts

Parent element for Title and ASIN of similar products in the same product group

Ancestry: Cart

SimilarViewedProducts

Parent element for Title and ASIN of similar products in the same product group that have been viewed

Ancestry: Cart

SingleMerchantId

ID of a merchant that applies across all of the variations of an item.

Ancestry: VariationSummary

Size

Size

Ancestry: ItemAttributes

SizePerPearl

Size of the pearl(s) in a piece of jewelry.

Ancestry: ItemAttributes

SKU

Stock Keeping Unit (SKU) is a number that uniquely identifies an item.

Ancestry: ItemAttributes

SellerListing

SmallImage

Container for a small image. Thumbnail and Small images are the same size.

Ancestry:

ImageSets/ImageSet

SoundCardDescription

Describes a computer's sound card.

Ancestry: ItemAttributes

Source

Where the review was entered. Typically, this is Amazon.com. It is possible, however, for customers to enter reviews from other sites.

Ancestry:

EditorialReviews/EditorialReview

SpeakerDescription

Describes the item's speakers.

Ancestry: ItemAttributes

SpecialFeatures

Describes an item's special features.

Ancestry: ItemAttributes

StartDate

The data an item goes on sale. Or, specifies the first day and beginning time (GMT) of the promotion.

Ancestry:

SellerListing, Offers/Offer/Promotions/Promotion/Summary

State

State

Ancestry: ItemAttributes

Status

Specifies whether an item is for sale (Open) or not (Closed). To determine if an item is truly available, this value must be Open, Quantity must be greater than zero and also the value of QuantityAllocated.

Ancestry:

StoneClarity

The clarity of a gem.

Ancestry: ItemAttributes

StoneColor

The color of a gem.

Ancestry: ItemAttributes

StoneCut

The cut of a gem.

Ancestry: ItemAttributes

StoneShape

The shape of a gem.

Ancestry: ItemAttributes

StoneWeight

The number of karats of a gem.

Ancestry: ItemAttributes

StoreId

A number that uniquely identifies the seller's store.

Ancestry:

SellerListing/Seller

StoreName

The name of the seller's store.

Ancestry:

SellerListing/Seller

Studio

Studio

Ancestry: ItemAttributes

Style

Style

Ancestry:

Variations/Item/ItemAttributes/

Subject

A book’s Subject description, which characterizes the book’s content.

Ancestry: Subjects

SubCondition

The condition of an item. This tag helps to further describes items that are not new. Values, for example, are mint, very good, and good.

Ancestry: SellerListing/SubCondition

SubscriptionLength

The duration of a subscription.

Ancestry: ItemAttributes

Summary

A short summary of the content of the review. Or, a container for all promotion information, including the elements BenefitDescription, Category, EndDate, EligibilityRequirementsDescription, PromotionId, StartDate, and TermsAndConditions.

Ancestry: CustomerReviews/Review/Summary, Offers/Offer/Promotions/Promotion

SupportedImageType

The image formats supported by the item.

Ancestry: ItemAttributes

SwatchImage

Container for a swatch image, which is smaller than a Small image.

Ancestry:

ImageSets/ImageSet

SystemBusSpeed

The bus speed of the motherboard.

Ancestry: ItemAttributes

SystemMemorySize

The size of the item's RAM.

Ancestry: ItemAttributes

SystemMemorySizeMax

The maximum RAM size an item can be expanded to.

Ancestry: ItemAttributes

SystemMemoryType

The type of RAM memory used.

Ancestry: ItemAttributes

Tag

A customer-created tag for an item, such as BobsBestMovie.

Ancestry: TaggedGuides, TaggedItems, TaggedListmaniaLists, Tag

TaggedItems

Container for Tag elements, such as Item and DistinctUsers.

Ancestry: TaggedGuides, TaggedItems, TaggedListmaniaLists, Tag

TagName

Tag name.

Ancestry: TaggedGuides, TaggedItems, TaggedListmaniaLists, Tag

Tags

Container for all Tag elements.

Ancestry: None

TagType

Describes the entity tagged, for example, Items.

Ancestry: TaggedGuides, TaggedItems, TaggedListmaniaLists, Tag

TermsAndConditions

Specifies the terms and conditions of the promotion.

Ancestry: Offers/Offer/Promotions/Promotion/Summary

TheatricalReleaseDate

The date of a theatrical release.

Ancestry: ItemAttributes

ThumbnailImage

Container for a Thumbnail image. Thumbnail and Small images are the same size.

Ancestry: ImageSets/ImageSet

Time

The time an entity was tagged.

Ancestry: TaggedItems, Tags

TinyImage

Container for a tiny image

Ancestry: ImageSets/ImageSet

Title

Title or the name of the accessory, item, new release, similar products in other product groups, similar products in the same product group, similar products in the same product group that have been viewed

Ancestry: ItemAttributes

Accessories/Accessory SavedForLaterItem Cart/NewReleases/NewRelease/Title CartItem OtherCategoriesSimilarProduct SimilarProduct SimilarViewedProduct TopSellers/TopSeller

TotalCollectible

The total number of collectible items for sale.

Ancestry: OfferSummary

TotalDiamondWeight

Total weight of all of the diamonds in a piece of jewelry.

Ancestry: ItemAttributes

TotalExternalBaysFree

The number of free external bays in a computer.

Ancestry: ItemAttributes

TotalFeedback

Average rating of the customers' feedback about the seller.

Ancestry:

Offers/Offer/Seller

TotalFeedbackPages

Specifies the number of pages of customer feedback. Up to twenty customer reviews are returned per page.

Ancestry: Seller

TotalFirewirePorts

The number of firewire ports an item has.

Ancestry: ItemAttributes

TotalGemWeight

Total weight of all of the gems in a piece of jewelry.

Ancestry: ItemAttributes

TotalInternalBaysFree

Number of internal bays free in a computer

Ancestry: ItemAttributes

TotalItems

The total number of items found on the list. Each page holds up to ten items.

Ancestry:

Items/TotalItems

TotalMetalWeight

Total weight of all of the metal in a piece of jewelry.

Ancestry: ItemAttributes

TotalNew

The total number of new items for sale.

Ancestry: OfferSummary

TotalNTSCPALPorts

Total number of NTSC and PAL video ports.

Ancestry: ItemAttributes

TotalOfferPages

Number of pages of offers. Up to twenty offers are returned per page. By default, the first ten offers are returned in the response.

Ancestry: Offers

TotalOffers

Total number of offers.

Ancestry: Offers

TotalPages

The total number of pages found in a response. Each page holds up to ten items.

Ancestry: Items

TotalParallelPorts

Total number of parallel ports.

Ancestry: ItemAttributes

TotalPCCardSlots

Total number of PC card slots in a computer.

Ancestry: ItemAttributes

TotalPCISlotsFree

Number of free PCI card slots in a computer.

Ancestry: ItemAttributes

TotalRatings

Catalogs all customer ratings of the seller.

Ancestry:

Seller/TotalRatings

TotalRefurbished

The total number of refurbished items for sale.

Ancestry: OfferSummary

TotalResults

Total number of items found by the request. Only ten are returned at a time.

Ancestry:

Items, List

TotalReviewPages

The number of pages of reviews found. Up to ten reviews are returned in a response

Ancestry: CustomerReviews

TotalReviews

Total number of reviews of an item.

Ancestry: CustomerReviews

Totals

Container object for all other Total* elements, including Total, SubTotal, Tax, ShippingCharges, Promotion, and so forth.

Ancestry: Transaction

TotalSerialPorts

Total number of serial ports on an item.

Ancestry: ItemAttributes

TotalSVideoOutPorts

Total number of SVideo out connectors.

Ancestry: ItemAttributes

TotalTimesRead

The number of times a list has been viewed.

Ancestry: List

TotalUsages

The number of times an entity has been accessed.

Ancestry: TaggedGuides, TaggedItems, TaggedListmaniaLIsts, Tags

TotalUSBPorts

Total number of USB2 ports on an item.

Ancestry: ItemAttributes

TotalUSB2Ports

Total number of USB1 ports on an item.

Ancestry: ItemAttributes

TotalUsed

The total number of used items for sale.

Ancestry: OfferSummary

TotalVGAOutPorts

Total number of VGA (video) outputs on an item.

Ancestry: ItemAttributes

TotalVotes

The total number of review votes cast.

Ancestry: CustomerReviews/Review/TotalVotes

Track

Refers to each track on a CD. On a music CD, each track corresponds to a song.

Ancestry:

Tracks/Disc

TransactionDate

The date on which the transaction began of the form yyyy-mm-ddThh.mm.ss, for example, 2005-06-08T19:19:27.

Ancestry: Transaction

TransactionDateEpoch

The date on which the transaction began in the form of epoch seconds.

Ancestry: Transaction

TransactionId

A series of dash-separated integers, such as 111-222-333, that uniquely identify a transaction.

Ancestry: Transaction

TransactionItem

Container for all of the information related to a specified transaction.

Ancestry: Transaction

TransactionItemId

A string that uniquely identifies a transaction item.

Ancestry: Transaction/TransactionItems/TransactionItem

TransactionItems

Container for TransactionItem

Ancestry: Transaction

Type

Type

Ancestry: ItemAttributes/Languages/Language

Unit

This is the unit of time returned by the element, MaximumShutterSpeed.

Ancestry: ItemAttributes

UPC

Universal Product Code, which is a 12 digit number, 6 of which represents an item's manufacturer. These numbers are translated into a bar code that is printed on an item or its packaging.

Ancestry: ItemAttributes

SellerListing

URL

URL of an image.

Ancestry:

Variations/Item/ImageSets/ImageSet/LargeImage

Variations/Item/ImageSets/ImageSet/SwatchImage

Variations/Item/ImageSets/ImageSet/MediumImage

Variations/Item/ImageSets/ImageSet/SmallImage

URLEncodedHMAC

A URL-encoded version of the HMAC that can be used directly in a request.

Ancestry: Cart

UserAgent

The client application, for example, web browsers, search engine crawlers, mobile phones, screen readers and braille browsers. The text associated with UserAgent contains the application name, version, host operating system, and language.

Ancestry: OperationRequest

UserId

An alphanumeric token that uniquely identifies the customer that tagged the entity.

Ancestry:

Value

The value of a parameter passed in the request. Or, the value for item in bin.

Ancestry: TaggedItems, TaggedListmaniaLists, Tags

VariationDenomination

Describes the variation. Typically used in the Electronics product category.

Ancestry: ItemAttributes

VariationDescription

Describes the variation. A variation is a particular instance of an item, for example, a specific size and color of a shirt.

Ancestry: ItemAttributes

VariationDimension

Container for dimensions

Ancestry:

Variations/VariationDimensions/

Version

ECS version number.

Ancestry: Help

Warranty

Warranty terms

Ancestry: ItemAttributes

WatchMovementType

The type of movement used in a watch.

Ancestry: ItemAttributes

WaterResistanceDepth

How deep a watch can go in water before water leaks into it.

Ancestry: ItemAttributes

Weight

Weight

Ancestry: ItemAttributes/ItemDimensions ItemAttributes/PackageDimensions/Weight ItemAttributes

Width

Width

Ancestry:

ItemAttributes/ItemDimensions ItemAttributes/PackageDimensions/Width ItemAttributes

Variations/Item/ImageSets/ImageSet/SwatchImage

Variations/Item/ImageSets/ImageSet/LargeImage

Variations/Item/ImageSets/ImageSet/SmallImage

Variations/Item/ImageSets/ImageSet/MediumImage

WillShipExpedited

Specifies whether seller can ship items faster than normal delivery.

Ancestry:

SellerListing/WillShipExpedited

WillShipInternational

Specifies whether seller will ship item to international destinations.

Ancestry:

SellerListing/WillShipInternational

WishListId

An alphanumeric token that uniquely identifies a wish list.

Ancestry:

CustomerFull, CustomerLists