Skip to main content

Getting category information and other metadata

Creating inventory items often requires you to have specific information about the eBay marketplaces into which you sell. You need to target the correct category for your items and you must create business policies that adhere to the policies of the categories into which you list. In addition, when you create an item, the condition ID and string used to define the condition must match the values for the marketplace where you're listing your item.

The topics in this section address how to get specific information about eBay categories, and other types of metadata that you might need as you configure the items that you place into inventory.

Finding the correct category ID and item condition for your item

For the best selling results, you should list your items in the categories that most closely match the items you list. The following topics have information where to list your items, and the condition values you should use when listing:

Getting listing policies for different categories

When you list an item in a specific eBay category, you must be sure you follow the listing policies associated with that category.

For example, if you are listing automotive parts, you must list into specific categories that allow for automotive-parts-compatibility items and you must follow the policies for listing the parts in those categories. In this case, you can use the getAutomotivePartsCompatiblityPolicies method to retrieve the policies for the specific categories into which you plan to list your automotive parts.

The Metadata API provides the following methods for retrieving the eBay policies that govern how you can list items in the different categories on the different eBay marketplaces:

  • getAutomotivePartsCompatibilityPolicies - Returns the policies that define how to list automotive-parts-compatibility items in the categories of a specific marketplace.
  • getItemConditionPolicies - Returns the policies that define how to specify item conditions in the categories of a specific marketplace.
  • getListingStructurePolicies - Returns the policies that define the allowed listing structures (i.e. whether item variations are supported) for the categories of a specific marketplace.
  • getNegotiatedPricePolicies - Returns the policies that define the supported negotiated price (best offer) features for the categories of a specific marketplace.
  • getProductAdoptionPolicies - Returns the policies that define which categories require you to supply an ePID value from the eBay Catalog for the items you list.
  • getReturnPolicies - Returns the policies that define whether or not you must include a return policy for the items you list in the categories of a specific marketplace.

Getting a list of tax jurisdictions

The Metadata API has a method that retrieves the tax jurisdictions for several countries that have different sales tax percentage rates for the different jurisdictions within the country. For details, see getSalesTaxJurisdictions to retrieve details on a county's different sales tax jurisdictions, then use the sales_tax resource of the Accounts API to set up and manage your sales tax tables.