This guide explains the process of transitioning from the deprecated GetCategoryFeatures call within the Trading API to the REST Metadata API and Taxonomy API methods.

The Metadata API methods only return metadata on leaf categories, so unlike GetCategoryFeatures, there is no concept of site defaults. All Metadata API methods return metadata for all leaf categories on a marketplace by default, but there is also the capability to specify up to 50 leaf categories through a query parameter.

The following table contains all fields (in alphabetical order) under the Category node of the GetCategoryFeatures call, and their new equivalent fields in the Metadata API and Taxonomy API methods. All REST methods in this table are Metadata API methods unless otherwise noted.

GetCategoryFeatures Field REST API Equivalent
REST API Field REST API Method
AdditionalCompatibilityEnabled automotivePartsCompatibilityPolicies getAutomotivePartsCompatibility
AdFormatEnabled adFormatEnabled getClassifiedAdPolicies
BestOfferAutoAcceptEnabled bestOfferAutoAcceptEnabled getNegotiatedPricePolicies
BestOfferAutoDeclinedEnabled bestOfferAutoDeclineEnabled getNegotiatedPricePolicies
BestOfferCounterEnabled bestOfferCounterEnabled getNegotiatedPricePolicies
BestOfferEnabled

negotiatedPricePolicies

Note: If a category is returned in this container, it supports Best Offer.

 getNegotiatedPricePolicies
BrandMPNIdentifierEnabled

localizedAspectName

Note: If supported, brand and MPN will appear in this field and the aspectRequired and aspectUsage fields will indicate whether the Brand and MPN are required, recommended, or optional.

getItemAspectsForCategory

(Taxonomy API)
ClassifiedAdAutoAcceptEnabled classifedAdAutoAcceptEnabled getClassifiedAdPolicies
ClassifiedAdAutoDeclineEnabled classifedAdAutoDeclineEnabled getClassifiedAdPolicies
ClassifiedAdBestOfferEnabled classifiedAdBestOfferEnabled getClassifiedAdPolicies
ClassifiedAdCompanyNameEnabled classifiedAdCompanyNameEnabled getClassifiedAdPolicies
ClassifiedAdContactByAddressEnabled classifiedAdContactByAddressEnabled getClassifiedAdPolicies
ClassifiedAdContactByEmailEnabled classifiedAdContactByEmailEnabled getClassifiedAdPolicies
ClassifiedAdContactByPhoneEnabled classifiedAdContactByPhoneEnabled getClassifiedAdPolicies
ClassifiedAdCounterOfferEnabled classifiedAdCounterOfferEnabled getClassifiedAdPolicies
ClassifiedAdPaymentMethodEnabled classifiedAdPaymentMethodEnabled getClassifiedAdPolicies
ClassifiedAdPhoneCount classifiedAdPhoneCount getClassifiedAdPolicies
ClassifiedAdShippingMethodEnabled classifiedAdShippingMethodEnabled getClassifiedAdPolicies
ClassifiedAdStreetCount classifiedAdStreetCount getClassifiedAdPolicies
CompatibleVehicleType compatibleVehicleTypes getAutomotivePartsCompatibility
ConditionEnabled itemConditionRequired getItemConditionPolicies
ConditionValues.Condition.DisplayName conditionDescription getItemConditionPolicies
ConditionValues.Condition.ID conditionId getItemConditionPolicies
ConditionValues.ConditionHelpURL conditionHelpText getItemConditionPolicies
CrossBorderTradeAustraliaEnabled crossBorderTradeAustraliaEnabled getSiteVisibilityPolicies
CrossBorderTradeGBEnabled crossBorderTradeGBEnabled getSiteVisibilityPolicies
CrossBorderTradeNorthAmericaEnabled crossBorderTradeNorthAmericaEnabled getSiteVisibilityPolicies
DepositSupported depositSupported getMotorsListingPolicies
DigitalGoodDeliveryEnabled digitalGoodDeliveryEnabled getListingTypePolicies
DomesticRefundMethodValues .DomesticRefundMethod refundMethods getReturnPolicies
DomesticReturnsAcceptedValues .DomesticReturnsAccepted returnsAcceptedEnabled getReturnPolicies
DomesticReturnsDurationValues .DomesticReturnsDuration returnPeriods getReturnPolicies
DomesticReturnsShipmentPayeeValues .DomesticReturnsShipmentPayee returnShippingCostPayers getReturnPolicies
EANEnabled localizedAspectName

Note: If supported, EAN will appear in this field and the aspectRequired and aspectUsage fields will indicate whether the EAN is required, recommended, or optional.

getItemAspectsForCategory

(Taxonomy API)
eBayMotorsProAdFormatEnabled ebayMotorsProAdFormatEnabled getMotorsListingPolicies
eBayMotorsProAutoAcceptEnabled ebayMotorsProAutoAcceptEnabled getMotorsListingPolicies
eBayMotorsProAutoDeclineEnabled ebayMotorsProAutoDeclineEnabled getMotorsListingPolicies
eBayMotorsProBestOfferEnabled ebayMotorsProBestOfferEnabled getMotorsListingPolicies
eBayMotorsProCompanyNameEnabled ebayMotorsProCompanyNameEnabled getMotorsListingPolicies
eBayMotorsProContactByAddressEnabled ebayMotorsProContactByAddressEnabled getMotorsListingPolicies
eBayMotorsProContactByEmailEnabled ebayMotorsProContactByEmailEnabled getMotorsListingPolicies
eBayMotorsProContactByPhoneEnabled ebayMotorsProContactByPhoneEnabled getMotorsListingPolicies
eBayMotorsProCounterOfferEnabled ebayMotorsProCounterOfferEnabled getMotorsListingPolicies
eBayMotorsProPaymentMethodCheckOutEnabled ebayMotorsProPaymentMethodCheckOutEnabled getMotorsListingPolicies
eBayMotorsProPhoneCount ebayMotorsProPhoneCount getMotorsListingPolicies
eBayMotorsProSellerContactDetailsEnabled ebayMotorsProSellerContactDetailsEnabled getMotorsListingPolicies
eBayMotorsProShippingMethodEnabled ebayMotorsProShippingMethodEnabled getMotorsListingPolicies
eBayMotorsProStreetCount ebayMotorsProStreetCount getMotorsListingPolicies
EpidSupported epidSupported getMotorsListingPolicies
GlobalShippingEnabled globalShippingEnabled getShippingPolicies
Group1MaxFlatShippingCost group1MaxFlatShippingCost getShippingPolicies
Group2MaxFlatShippingCost group2MaxFlatShippingCost getShippingPolicies
Group3MaxFlatShippingCost group3MaxFlatShippingCost getShippingPolicies
HandlingTimeEnabled handlingTimeEnabled getShippingPolicies
InternationalRefundMethodValues .InternationalRefundMethod internationalOverride.returnMethods getReturnPolicies
InternationalReturnsAcceptedValues .InternationalReturnsAccepted internationalOverride.returnsAcceptedEnabled getReturnPolicies
InternationalReturnsDurationValues .InternationalReturnsDuration internationalOverride.returnPeriods getReturnPolicies
InternationalReturnsShipmentPayeeValues .InternationalReturnsShipmentPayee internationalOverride.returnShippingCostPayers getReturnPolicies
ISBNEnabled

localizedAspectName

Note: If supported, ISBN will appear in this field and the aspectRequired and aspectUsage fields will indicate whether the ISBN is required, recommended, or optional.

getItemAspectsForCategory

(Taxonomy API)
ItemCompatibilityEnabled

automotivePartsCompatibilityPolicies

Note: If a leaf category appears in the response of this method, the category supports compatibility.

 getAutomotivePartsCompatibility
KTypeSupported kTypeSupported getMotorsListingPolicies
ListingDuration listingDurations getListingTypePolicies
LocalMarketAdFormatEnabled localMarketAdFormatEnabled getMotorsListingPolicies
LocalMarketAutoAcceptEnabled localMarketAutoAcceptEnabled getMotorsListingPolicies
LocalMarketAutoDeclineEnabled localMarketAutoDeclineEnabled getMotorsListingPolicies
LocalMarketBestOfferEnabled localMarketBestOfferEnabled getMotorsListingPolicies
LocalMarketCompanyNameEnabled localMarketCompanyNameEnabled getMotorsListingPolicies
LocalMarketContactByAddressEnabled localMarketContactByAddressEnabled getMotorsListingPolicies
LocalMarketContactByEmailEnabled localMarketContactByEmailEnabled getMotorsListingPolicies
LocalMarketContactByPhoneEnabled localMarketContactByPhoneEnabled getMotorsListingPolicies
LocalMarketCounterOfferEnabled localMarketCounterOfferEnabled getMotorsListingPolicies
LocalMarketNonSubscription localMarketNonSubscription getMotorsListingPolicies
LocalMarketPaymentMethodCheckOutEnabled localMarketPaymentMethodCheckOutEnabled getMotorsListingPolicies
LocalMarketPhoneCount localMarketPhoneCount getMotorsListingPolicies
LocalMarketPremiumSubscription localMarketPremiumSubscription getMotorsListingPolicies
LocalMarketRegularSubscription localMarketRegularSubscription getMotorsListingPolicies
LocalMarketSellerContactDetailsEnabled localMarketSellerContactDetailsEnabled getMotorsListingPolicies
LocalMarketShippingMethodEnabled localMarketShippingMethodEnabled getMotorsListingPolicies
LocalMarketSpecialitySubscription localMarketSpecialitySubscription getMotorsListingPolicies
LocalMarketStreetCount localMarketStreetCount getMotorsListingPolicies
MaxFlatShippingCost maxFlatShippingCost getShippingPolicies
MaxGranularFitmentCount maxGranularFitmentCount getMotorsListingPolicies
MaxItemCompatibility maxItemCompatibility getMotorsListingPolicies
MinimumReservePrice minimumReservePrice getCategoryPolicies
MinItemCompatibility minItemCompatibility getMotorsListingPolicies
NonSubscription nonSubscription getMotorsListingPolicies
PaymentMethod paymentMethods getCategoryPolicies
PickupDropOffEnabled pickupDropOffEnabled getListingTypePolicies
PremiumSubscription premiumSubscription getMotorsListingPolicies
RegularSubscription regularSubscription getMotorsListingPolicies
ReturnPolicyDescriptionEnabled policyDescriptionEnabled getReturnPolicies
ReturnPolicyEnabled required getReturnPolicies
SellerContactDetailsEnabled sellerContactDetailsEnabled getClassifiedAdPolicies
SellerProvidedTitleSupported sellerProvidedTitleSupported getMotorsListingPolicies
ShippingTermsRequired shippingTermsRequired getShippingPolicies
SpecialFeatures .Condition.DisplayName

conditionDescription

Note: The Certified - Refurbished, Excellent - Refurbished, Very Good - Refurbished, and Good - Refurbished item conditions are returned under the SpecialFeatures container of GetCategoryFeatures. In the getItemConditionPolicies response, they will only be returned to sellers who are eligible to list with any of those item conditions, and the user will need to use a user token instead of an application token.

 getItemConditionPolicies
SpecialFeatures .Condition.ID

conditionId

Note: The Certified - Refurbished, Excellent - Refurbished, Very Good - Refurbished, and Good - Refurbished item conditions are returned under the SpecialFeatures container of GetCategoryFeatures. In the getItemConditionPolicies response, they will only be returned to sellers who are eligible to list with any of those item conditions, and the user will need to use a user token instead of an application token.

 getItemConditionPolicies
SpecialFeatures .ConditionHelpURL

conditionHelpText

Note: The Certified - Refurbished, Excellent - Refurbished, Very Good - Refurbished, and Good - Refurbished item conditions are returned under the SpecialFeatures container of GetCategoryFeatures. In the getItemConditionPolicies response, they will only be returned to sellers who are eligible to list with any of those item conditions, and the user will need to use a user token instead of an application token.

 getItemConditionPolicies
SpecialitySubscription specialtySubscription  
UPCEnabled localizedAspectName

Note: If supported, ISBN will appear in this field and the aspectRequired and aspectUsage fields will indicate whether the ISBN is required, recommended, or optional.

getItemAspectsForCategory

(Taxonomy API)
ValueCategory valueCategory getCategoryPolicies
VariationsEnabled variationsSupported getListingStructurePolicies
VINSupported vinSupported getMotorsListingPolicies
VRMSupported vrmSupported getMotorsListingPolicies

Deprecated/non-migrated fields

The following table contains fields that were not migrated from GetCategoryFeatures to the REST APIs and the reason:

GetCategoryFeatures field not migrated Reason
BuyerGuaranteeEnabled Deprecated feature (no longer applicable)
ClassifiedAdPayPerLeadEnabled Deprecated feature (no longer applicable)

FreeGalleryPlusEnabled

eBay APIs no longer return this data point, as only a limited amount of categories support free Gallery Plus, including Art, Antiques, Collectibles, and Pottery & Glass categories

FreePicturePackEnabled

All non-motor vehicle categories offer Picture Pack free of charge, so this data point is no longer applicable
GalleryFeaturedDurations.Duration Deprecated feature (no longer applicable)
HomePageFeatureEnabled Deprecated feature (no longer applicable)
INEscrowWorkflowTimeline Deprecated feature (no longer applicable)
ItemSpecificsEnabled All categories supports item specifics

MaxFlatShippingCostCBTExempt

Deprecated feature (no longer applicable)

PaisaPayFullEscrowEnabled Deprecated feature (no longer applicable)
ProductCreationEnabled Deprecated feature (no longer applicable)
ProPackEnabled Deprecated feature (no longer applicable)

ReturnPolicyEnabled

A Return Policy Description field is only supported on a limited number of eBay marketplaces, and the supported marketplaces are Germany, Austria, France, Italy, and Spain. For these marketplaces, the field is supported across all categories, so the leaf category level metadata is no longer relevant
RevisePriceAllowed All categories allow price revisions
ReviseQuantityAllowed All categories allow quantity revisions for fixed price listings.

SafePaymentRequired

This data point is no longer relevant since eBay controls all online payments, and sellers are always expected to use secure/safe payment methods for offline/local pickup transactions
ShippingProfileCategoryGroup Business policies no longer support the concept of default category groups
StoreOwnerExtendedListingDurations.Duration Deprecated feature (no longer applicable)
StoreOwnerExtendedListingsDurationsEnabled Deprecated feature (no longer applicable)
TransactionConfirmationRequestEnabled Deprecated feature (no longer applicable)
UserConsentRequired Deprecated feature (no longer applicable)