eBay Finding APIVersion 1.13.0

AspectHistogramContainer

Container for a top-level set of aspect histograms.

Types that use AspectHistogramContainer:

Calls that use AspectHistogramContainer:

Fields

aspect ( Aspect ) [1..*]
A characteristic of an item in a domain. For example, "Optical Zoom", "Brand", and "Megapixels" could be aspects of the Digital Cameras domain. Aspects are well-known, standardized characteristics of a domain, and they vary from domain to domain (the aspects of "Men's Shoes" are different from those of "Digital Cameras"). A search request on the eBay site will often display aspects and their respective aspect values on the left-had side of a query response.

Aspects are extracted from item listing properties (such as item titles and subtitles), and represent the characteristics of active items. Values returned in the Aspect container can be used as inputs to the aspectFilter fields in a query to distill the items returned by the query. eBay generates aspects dynamically from the items currently listed; aspects provide a view into what is currently available on eBay. Because of this, aspect values returned one day cannot be guaranteed to be valid the next day.

The following graphic shows how eBay might return a set of aspects for the Digital Cameras domain. In this graphic, "Product Type", "Brand", and "Megapixels" are aspects, and "Point & Shoot", "Canon", and "12.0 to 12.9 MP" are aspect values. Histogram values (item counts) are shown for each aspect value.

eBay Aspects
See the Field Index to learn which calls use aspect.

domainDisplayName ( token ) [1]
A buy-side group of items, for example "Shoes." Domains are extracted from item listing properties, such as the title, descriptions, and so on.
See the Field Index to learn which calls use domainDisplayName.

domainName ( string ) [1]
A buy-side group of items that share aspects, but not necessarily an eBay category. For example "Women's Dresses" or "Digital Cameras" could be domains. You can use a domainName to label a set of aspects that you display.

Domains are extracted from item listing properties (such as item titles and subtitles).
See the Field Index to learn which calls use domainName.