This guide explains the process of transitioning from the deprecated GetCategoryFeatures call within the Trading API to the REST Metadata API methods. The Metadata API offers access through methods within the marketplace resource, enabling users to retrieve detailed information on features supported by all leaf categories within a marketplace. Examples of these features include listing durations, shipping term requirements, and Best Offer support.

The following table maps fields from the Trading API calls to their equivalent fields in the relevant Metadata API methods: 

Note: The Metadata API methods only return metadata on leaf categories, so unlike the Trading API, there is no concept of site defaults. The endpoints contained in this guide return metadata for all leaf categories by default, or you can specify up to 50 leaf categories.

GetCategoryFeatures Field Metadata API Equivalent
Field 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

Note: Certified - Refurbished-eligible sellers, and sellers who are eligible to list with the new values (EXCELLENT_REFURBISHED, VERY_GOOD_REFURBISHED, and GOOD_REFURBISHED) must use an OAuth token created with the authorization code grant flow and https://api.ebay.com/oauth/api_scope/sell.inventory scope in order to retrieve the refurbished conditions for the relevant categories.

 getItemConditionPolicies
SpecialFeatures .Condition.ID

Note: Certified - Refurbished-eligible sellers, and sellers who are eligible to list with the new values (EXCELLENT_REFURBISHED, VERY_GOOD_REFURBISHED, and GOOD_REFURBISHED) must use an OAuth token created with the authorization code grant flow and https://api.ebay.com/oauth/api_scope/sell.inventory scope in order to retrieve the refurbished conditions for the relevant categories.

 getItemConditionPolicies
SpecialFeatures .ConditionHelpURL

Note: Certified - Refurbished-eligible sellers, and sellers who are eligible to list with the new values (EXCELLENT_REFURBISHED, VERY_GOOD_REFURBISHED, and GOOD_REFURBISHED) must use an OAuth token created with the authorization code grant flow and https://api.ebay.com/oauth/api_scope/sell.inventory scope in order to retrieve the refurbished conditions for the relevant categories.

 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 Metadata API 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)