Parts compatibility is supported by the following APIs:

Note: The Finding API has been decommissioned and replaced by the Browse API.

For buyer-facing item discovery, use the Browse API instead of the old Finding API. For compatible-parts search, use the Browse API search method with compatibility_filter.

Trading API

Parts compatibility is supported in select Parts & Accessories categories only for the following marketplaces:

  • eBay US Motors (100)
  • Canada (2)
  • UK (3)
  • Australia (15)
  • Germany (77)

The Trading API still supports listing or revising items with parts compatibility and retrieving item compatibility information for active listings.

Listing items with parts compatibility is supported by the following calls:

Use GetItem to retrieve parts compatibility information for an active item listing.

For more information about listing items with parts compatibility using the AddItem family of calls, refer to Create a parts and accessories listing.

Use the Metadata API, not GetCategoryFeatures, to determine whether categories support parts compatibility. Refer to Category Support for additional information.

Inventory API

Use the Inventory API to create, retrieve, and delete the product-compatibility data associated with a parts or accessory inventory item.

Use createOrReplaceProductCompatibility to attach a list of compatible vehicles to the inventory item identified by its SKU. In the request payload, define the compatible vehicles in the productFamilyProperties container. After the compatibility data is attached to the inventory item, publish the related offer to create or update the eBay listing.

Use the related Inventory API methods to retrieve or delete the compatibility data for an inventory item when needed.

Metadata API

Use the Metadata API to determine whether categories support parts compatibility and to retrieve Motors-specific compatibility policy data for supported leaf categories.

Use getAutomotivePartsCompatibilityPolicies to determine whether a leaf category supports parts compatibility and whether the compatibility model for that category is based on ASSEMBLY or SPECIFICATIONS.

Use getMotorsListingPolicies to retrieve Motors listing limits and related policy metadata, including maxItemCompatibility and minItemCompatibility.

Taxonomy API

For categories that use compatibility by specification, use the Taxonomy API method getItemAspectsForCategory to determine which item specifics are returned for the category and whether those aspects are required, recommended, or optional.