fetchItemAspects

The unique identifier of the eBay category tree being requested.

Occurrence: Always

The version of the category tree that is returned in the categoryTreeId field.

Occurrence: Always

An array of aspects that are appropriate or necessary for accurately describing items in a particular leaf category.

Occurrence: Always

The details that are appropriate or necessary to accurately define the category.

Occurrence: Always

The unique identifier of the eBay category within its category tree.

Note: The root node of a full default category tree includes the categoryId field, but its value should not be relied upon. It provides no useful information for application development.

Occurrence: Always

The name of the category identified by categoryId.

Occurrence: Always

A list of aspect metadata that is used to describe the items in a particular leaf category.

Occurrence: Conditional

Information about the formatting, occurrence, and support of this aspect.

Occurrence: Always

This value indicate if the aspect identified by the aspects.localizedAspectName field is a product aspect (relevant to catalog products in the category) or an item/instance aspect, which is an aspect whose value will vary based on a particular instance of the product.

Occurrence: Conditional

The data type of this aspect.

Occurrence: Always

A value of true indicates that this aspect can be used to help identify item variations.

Occurrence: Always

Returned only if the value of aspectDataType identifies a data type that requires specific formatting. Currently, this field provides formatting hints as follows:

• DATE: YYYY, YYYYMM, YYYYMMDD
• NUMBER: int32, double

Occurrence: Conditional

The maximum length of the item/instance aspect's value. The seller must make sure not to exceed this length when specifying the instance aspect's value for a product. This field is only returned for instance aspects.

Occurrence: Conditional

The manner in which values of this aspect must be specified by the seller (as free text or by selecting from available options).

Occurrence: Always

A value of true indicates that this aspect is required when offering items in the specified category.

Occurrence: Always

The enumeration value returned in this field will indicate if the corresponding aspect is recommended or optional.

Note: This field is always returned, even for hard-mandated/required aspects (where aspectRequired: true). The value returned for required aspects will be RECOMMENDED, but they are actually required and a seller will be blocked from listing or revising an item without these aspects.

Occurrence: Always

The expected date after which the aspect will be required.

Note: The value returned in this field specifies only an approximate date, which may not reflect the actual date after which the aspect is required.

Occurrence: Conditional

Indicates whether this aspect can accept single or multiple values for items in the specified category.

Note: Up to 30 values can be supplied for aspects that accept multiple values.

Occurrence: Always

A list of valid values for this aspect (for example: Red, Green, and Blue), along with any constraints on those values.

Occurrence: Always

The localized value of this aspect.

Note: This value is always localized for the specified marketplace.

Occurrence: Always

Not returned if the value of the localizedValue field can always be selected for this aspect of the specified category.

Contains a list of the dependencies that identify when the value of the localizedValue field is available for the current aspect. Each dependency specifies the values of another aspect of the same category (a control aspect), for which the current value of the current aspect can also be selected by the seller.

Example: A shirt is available in three sizes and three colors, but only the Small and Medium sizes come in Green. Thus for the Color aspect, the value Green is constrained by its dependency on Size (the control aspect). Only when the Size aspect value is Small or Medium, can the Color aspect value of Green be selected by the seller.

Occurrence: Conditional

The name of the control aspect on which the current aspect value depends.

Occurrence: Conditional

Contains a list of the values of the control aspect on which this aspect's value depends. When the control aspect has any of the specified values, the current value of the current aspect will also be available.

Occurrence: Conditional

The localized name of this aspect (for example: Colour on the eBay UK site).

Note: This name is always localized for the specified marketplace.

Occurrence: Always

The relevance of this aspect. This field is returned if eBay has data on how many searches have been performed for listings in the category using this item aspect.

Note: This container is restricted to applications that have been granted permission to access this feature. You must submit an App Check ticket to request this access. In the App Check form, add a note to the Application Title/Summary and/or Application Details fields that you want access to 'Buyer Demand Data' in the Taxonomy API.

Occurrence: Conditional

The number of recent searches (based on 30 days of data) for the aspect.

Occurrence: Conditional