eBay Trading APIVersion 1235

GetCategorySpecificsResponseType ( AbstractResponseType )

This is the base response type for the GetCategorySpecifics call. This call retrieves recommended Item Specifics names and values for one or multiple eBay Categories.

Call that uses GetCategorySpecificsResponseType:

Fields

FileReferenceID ( string ) [0..1]
A TaskReferenceID and a FileReferenceID value are returned if the CategorySpecificsFileInfo field is included in the call request and set to true. These values will be used as inputs in the downloadFile call of the File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.)
See the Field Index to learn which calls use FileReferenceID.

Recommendations ( RecommendationsType ) [0..*]
This container provide details about relevant Item Specifics for the specified category. Required Item Specifics are generally returned at the top of the response payload, followed by the other most common/popular Item Specifics for the category. If an Item Specific is required, a MinValues field will be returned with a value of 1, and the corresponding UsageConstraint field will show a value of Required. Optional Item Specifics are returned after required and recommended Item Specifics, but sellers should still provide any optional Item Specific name-value pairs if known and relevant for the product.

As mentioned above, the most relevant Item Specifics are returned first, and similarly, if an Item Specific has multiple suggested values, these values are sorted according to popularity (most popular to less popular/common).

This node returns empty (or it's not returned) for a category if there is no applicable data (such as when you request a parent category, a category that has no popular Item Specifics yet, or a duplicate category that was already returned). If you pass in the CategoryID and Name fields together, but no matching values are found for the name, eBay returns the name with no values (even if the name is not recommended).

If GetCategoryFeatures indicates that Item Specifics are enabled for a leaf category, but GetCategorySpecifics doesn't return any recommendations for that category, the seller can still specify their own Item Specifics in that category.
See the Field Index to learn which calls use Recommendations.

TaskReferenceID ( string ) [0..1]
A TaskReferenceID and a FileReferenceID value are returned if the CategorySpecificsFileInfo field is included in the call request and set to true. These values will be used as inputs in the downloadFile call of the File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.)
See the Field Index to learn which calls use TaskReferenceID.