Skip to main content
Published: June 11 2020, 11:35:00 AMUpdated: September 05 2022, 12:01:38 PM

What is the maximum number of application compatibilities I can include for eBay Motor accessory items?

You may include compatibilities in your AddItem family calls either using eBay catalog or specify them manually.  Regardless of which method you chose, eBay will limit the number of compatibilities you can list base on the category ID you specify.  You can find out the max number of compatibilities eBay will accept by making a call to GetCategoryFeatures:

 

Call GetCategoryFeatures to find out the maximum number of compatibilities you can specific in your Add request. 

 

Example Request:

<GetCategoryFeaturesRequest xmlns="urn:ebay:apis:eBLBaseComponents">

  ………etc………….

  <CategoryID>33716</CategoryID>

  <FeatureID>MaxGranularFitmentCount</FeatureID>

  <FeatureID>MaxCompatibleApplications</FeatureID>

  <FeatureID>MinCompatibleApplications</FeatureID>

  <DetailLevel>ReturnAll</DetailLevel>

</GetCategoryFeaturesRequest>

 

Example Response:

<GetCategoryFeaturesResponse xmlns="urn:ebay:apis:eBLBaseComponents">

  ………etc………….

   <Category>

      <CategoryID>33716</CategoryID>

      <MaxItemCompatibility>300</MaxItemCompatibility>

      <MaxGranularFitmentCount>1000</MaxGranularFitmentCount>

   </Category>

  ………etc………….

</GetCategoryFeaturesResponse>

MaxGranularFitmentCount tells you how many compatibilities eBay will accept for this category. 



Frequently Asked Questions

1.       What is the difference between MaxGranularFitmentCount and MaxItemCompatibililty in GetCategoryFeatures response?

eBay has the functionality to “auto-expand” a compatibility.  For example, you may specify your compatibility as a tuple of Year, Make, Model, without specifying Trim and Engine for your windshield wiper item:

 

        <Compatibility>

            <NameValueList>

               <Name>Year</Name>

               <Value>2003</Value>

            </NameValueList>

            <NameValueList>

               <Name>Make</Name>

               <Value>Dodge</Value>

            </NameValueList>

            <NameValueList>

               <Name>Model</Name>

               <Value>Ram 1500</Value>

            </NameValueList>

         </Compatibility>

eBay can then expand this for you to:

         <Compatibility>

            <NameValueList>

               <Name>Year</Name>

               <Value>2003</Value>

            </NameValueList>

            <NameValueList>

               <Name>Make</Name>

               <Value>Dodge</Value>

            </NameValueList>

            <NameValueList>

               <Name>Model</Name>

               <Value>Ram 1500</Value>

            </NameValueList>

            <NameValueList>

               <Name>Trim</Name>

               <Value>Laramie Crew Cab Pickup 4-Door</Value>

            </NameValueList>

            <NameValueList>

               <Name>Engine</Name>

               <Value>3.7L 226Cu. In. V6 GAS SOHC Naturally Aspirated</Value>

            </NameValueList>

         </Compatibility>

         <!—More Compatibility Nodes -- >

 

Your “compact” version of the compatibility may be expanded automatically into multiple granular level compatibilities.  Prior to Feb, 2017, eBay allow users to specify a maximum of <MaxItemCompatibility> number of “compact” compatibilities.  These “compact” compatibilities will then be expanded into a large number of granular level compatibilities.  The number of auto-expanded granular level compatibility can potentially be greater than the number you see in MaxGranularFitmentCount.

However, Feb 2017 eBay enforce strict rule on MaxGranularFitmentCount.  Even if the “compact” compatibilities you specify auto-expand into a set larger than MaxGranularFitmentCount, eBay will only list the item with number of compatibilities up to the number equal to MaxGranularFitmentCount.

Therefore, for any new listings after Feb 2017, regardless of whether you list your item with “compact” compatibility using eBay’s auto-expansion feature, or list each granular compatibilities manually, you are limit to a maximum number of < MaxGranularFitmentCount> compatibilities

Note after Feb 2017, MaxItemCompatibility is no longer in used. 

 

2.       Why do some existing listings on eBay site have a larger set of compatibilities than what’s indicated by MaxGranularFitmentCount for a specific category?

For listings started before Feb 2017, auto expand compatibilities can be expanded into a large number of granular level compatibilities that are greater than MaxGranularFitementCount.  eBay preserves the number of compatibilities for these old listings.

 

3.       Will listing items using eBay catalog result in a different maximum limit for compatibilities?

No.  For a given category, the maximum number of compatibilities remain the same (MaxGranularFitmentCount) regardless if you list via eBay catalog or manually

 

4.       How do I know if eBay had expanded my fitment count?

If you get an error code of 21916728, it's straight forward, no expansion occurred.  You simply indicated more number of fitment than indicated by MaxGranularFitmentCount

If you get an error code of 21917207, you may indicated a smaller number of fitment count than what's specified by MaxGranularFitmentCount.  However because of eBay's auto-expansion you are hitting the error.

Related link:

https://developer.ebay.com/devzone/guides/ebayfeatures/Development/CompatibleParts-Listing.html

 

How well did this answer your question?
Answers others found helpful

Got thoughts? Click the feedback button – your insights help us improve!