GetCategoryFeatures Migration Guide | eBay Developers Program

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 now offers access through six distinct 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. Descriptions of the Metadata API methods are provided, including tables that map 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 six endpoints contained in this guide return metadata for all leaf categories by default, or you can specify up to 50 leaf categories.

getCategoryPolicies

This method returns eBay category policy metadata for all leaf categories on the specified marketplace. See getCategoryPolicies for details. Use this method to return metadata returned from the GetCategoryFeatures calls through the Metadata API methods.

The following table cross-references the GetCategoryFeatures fields returned in the Trading API, with the associated getCategoryPolicies field returned in the Metadata API.

Trading API call	Trading API field	getCategoryPolicies field
GetCategoryFeatures	IntangibleEnabled	intangibleEnabled
	MinimumReservePrice	minimumReservePrice
	ValueCategory	valueCategory
	PaymentMethods	paymentMethods

getClassifiedAdPolicies

This method returns eBay classified ad policy metadata for all leaf categories on the specified marketplace. See getClassifiedAdPolicies for details.

Note: This method does not support classified ads for eBay US Motors categories (EBAY_MOTORS_US). For eBay Motors Pro users, use getMotorsListingPolicies.

The following table cross-references the GetCategoryFeatures category fields returned in the Trading API, with the associated getClassifiedAdPolicies field returned in the Metadata API.

GetCategoryFeatures field	getClassifiedAdPolicies field
AdFormatEnabled	adFormatEnabled
SellerContactDetailsEnabled	sellerContactDetailsEnabled
ClassifiedAdPaymentMethodEnabled	classifiedAdPaymentMethodEnabled
ClassifiedAdShippingMethodEnabled	classifiedAdShippingMethodEnabled
ClassifiedAdBestOfferEnabled	classifiedAdBestOfferEnabled
ClassifiedAdCounterOfferEnabled	classifiedAdCounterOfferEnabled
ClassifiedAdContactByPhoneEnabled	classifiedAdContactByPhoneEnabled
ClassifiedAdContactByEmailEnabled	classifiedAdContactByEmailEnabled
ClassifiedAdAutoAcceptEnabled	classifiedAdAutoAcceptEnabled
ClassifiedAdAutoDeclineEnabled	classifiedAdAutoDeclineEnabled
ClassifiedAdStreetCount	classifiedAdPolicies.classifiedAdStreetCount Note: Returned if classifiedAdContactByAddressEnabled filter is enabled.

getListingTypePolicies

This method returns eBay listing type policy metadata for all leaf categories on the specified marketplace. See getListingTypePolicies for details. The following table cross-references the GetCategoryFeatures category fields returned in the Trading API, with the associated getListingTypePolicies field returned in the Metadata API.

GetCategoryFeatures field	getListingTypePolicies field
PickupDropOffEnabled	pickupDropOffEnabled
DigitalGoodDeliveryEnabled	digitalGoodDeliveryEnabled
ListingDurations	listingDurations

getMotorsListingPolicies

This method returns eBay listing type policy metadata for all leaf categories on the specified marketplace. See getMotorsListingPolicies for details. The following table cross-references the GetCategoryFeatures category fields returned in the Trading API, with the associated getMotorsListingPolicies field returned in the Metadata API.

GetCategoryFeatures field	getMotorsListingPolicies field
MaxGranularFitmentCount	maxGranularFitmentCount
eBayMotorsProAdFormatEnabled	eBayMotorsProAdFormatEnabled
eBayMotorsProAdFormatEnabled	eBayMotorsProPhoneCount
eBayMotorsProStreetCount	eBayMotorsProStreetCount
eBayMotorsProContactByEmailEnabled	eBayMotorsProContactByEmailEnabled
eBayMotorsProBestOfferEnabled	eBayMotorsProBestOfferEnabled
eBayMotorsProAutoAcceptEnabled	eBayMotorsProAutoAcceptEnabled
eBayMotorsProAutoDeclineEnabled	ebayMotorsProAutoDeclineEnabled
eBayMotorsProPaymentMethodCheckOutEnabled	eBayMotorsProPaymentMethodCheckOutEnabled
eBayMotorsProShippingMethodEnabled	eBayMotorsProShippingMethodEnabled
eBayMotorsProCounterOfferEnabled	eBayMotorsProCounterOfferEnabled
eBayMotorsProSellerContactDetailsEnabled	eBayMotorsProSellerContactDetailsEnabled
LocalMarketAdFormatEnabled	localMarketAdFormatEnabled
LocalMarketAutoAcceptEnabled	localMarketAutoAcceptEnabled
LocalMarketAutoDeclineEnabled	localMarketAutoDeclineEnabled
LocalMarketPhoneCount	localMarketPhoneCount
LocalMarketStreetCount	localMarketStreetCount
LocalMarketContactByEmailEnabled	localMarketContactByEmailEnabled
LocalMarketBestOfferEnabled	localMarketBestOfferEnabled
LocalMarketPaymentMethodCheckOutEnabled	localMarketPaymentMethodCheckOutEnabled
LocalMarketShippingMethodEnabled	localMarketShippingMethodEnabled
LocalMarketCounterOfferEnabled	localMarketCounterOfferEnabled
LocalMarketSellerContactDetailsEnabled	localMarketSellerContactDetailsEnabled
MaxCompatibleApplications	maxItemCompatibility
MinCompatibleApplications	minItemCompatibility
LocalMarketSpecialitySubscription	localMarketSpecialitySubscription
LocalMarketRegularSubscription	regularSubscription
LocalMarketPremiumSubscription	localMarketPremiumSubscription
LocalMarketNonSubscription	localMarketNonSubscription
VINSupported	vinSupported
SellerProvidedTitleSupported	sellerProvidedTitleSupported
DepositSupported	depositSupported
VRMSupported	vrmSupported
eBayMotorsProContactByPhoneEnabled	ebayMotorsProContactByPhoneEnabled
eBayMotorsProContactByAddressEnabled	ebayMotorsProContactByAddressEnabled
eBayMotorsProCompanyNameEnabled	ebayMotorsProCompanyNameEnabled
LocalMarketContactByPhoneEnabled	localMarketContactByPhoneEnabled
LocalMarketContactByAddressEnabled	localMarketContactByAddressEnabled
LocalMarketCompanyNameEnabled	localMarketCompanyNameEnabled
EpidSupported	epidSupported
KTypeSupported	kTypeSupported
LocalListingDistancesRegular	Access the REST equivalent for these three fields through its associated enumerated value in the distanceType field. distanceType
LocalListingDistancesNonSubscription
LocalListingDistancesSpecialty

getShippingPolicies

This method returns eBay shipping policy metadata for all leaf categories on the specified marketplace. See getShippingPolicies for details. The following table cross-references the GetCategoryFeatures fields returned in the Trading API, with the associated getShippingPolicies field returned in the Metadata API.

GetCategoryFeatures field	getShippingPolicies field
ShippingTermsRequired	shippingTermsRequired
HandlingTimeEnabled	handlingTimeEnabled
Group1MaxFlatShippingCost	group1MaxFlatShippingCost
Group2MaxFlatShippingCost	group2MaxFlatShippingCost
Group3MaxFlatShippingCost	group3MaxFlatShippingCost
GlobalShippingEnabled	globalShippingEnabled
MaxFlatShippingCost	maxFlatShippingCost

getSiteVisibilityPolicies

This method returns eBay international site visibility policy metadata for all leaf categories on the specified marketplace. See getSiteVisibilityPolicies for details. The following table cross-references the GetCategoryFeatures fields returned in the Trading API, with the associated getSiteVisibilityPolicies field returned in the Metadata API.

GetCategoryFeatures field	getSiteVisibilityPolicies field
CrossBorderTradeNorthAmericaEnabled	crossBorderTradeNorthAmericaEnabled
CrossBorderTradeGBEnabled	crossBorderTradeGBEnabled
CrossBorderTradeAustraliaEnabled	crossBorderTradeAustraliaEnabled

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
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
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
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
MaxFlatShippingCostCBTExempt	Deprecated feature (no longer applicable)