The compatibility list on an eBay Motors listing is the table of vehicles a part fits: year, make, model, and sometimes trim and engine. You can show the same data on your own store, both as a year, make and model finder and as a “fits these vehicles” list on each product page. There is no simple export button for it, though. The list comes out through eBay’s APIs, and how you read it depends on how the listing got its fitment in the first place.
Below is how the data is stored, how a developer reads it, and how to turn thousands of rows into something a buyer can use. We built this for a live parts store that mirrors more than 34,000 eBay listings, so the advice comes from doing it, not from a spec sheet. For the bigger picture of a parts store, see our page for auto parts sellers.
What eBay’s compatibility list is
eBay calls it parts compatibility or fitment. A seller adds it in one of two ways, as eBay’s Seller Center page for parts sellers explains:
- From eBay’s parts catalog. You find your part in the catalog while listing, and the matching vehicles fill in. eBay’s fitment guide for sellers says catalog listings get prefilled vehicles and automatic updates, such as new model years. The catalog covers most Auto Parts & Accessories categories.
- By hand. You enter the vehicles yourself. Year, make and model are the minimum. Trim and engine are optional, and leaving them out means the part fits every trim and engine of that model.
The same guide says a listing can hold up to 1,000 or 3,000 vehicles depending on the category. That matters later, because a single alternator can fit hundreds of vehicles.
Where the list lives in a listing
Buyers see the list on the item page, in the compatibility section. Behind the page, it is stored one of two ways:
- A link to a catalog product. The listing carries an eBay product ID (ePID), and the vehicle list belongs to that catalog product, not to the listing itself.
- A list saved on the listing. Each row is a set of name and value pairs (Year 2001, Make Ford, Model F-150) plus an optional notes field.
Knowing which kind you have decides which API call reads it.
How to read it for your own store
Lists typed in by hand
The Trading API’s GetItem call, with IncludeItemCompatibilityList set to true, returns the listing’s ItemCompatibilityList. eBay’s guide to retrieving compatibility for listed items shows the shape: a Compatibility entry per vehicle, each with Year, Make, Model, Trim and Engine, and a CompatibilityNotes field. Two catches from eBay’s own pages: outside the US and Canada the list is returned only to the seller or an app acting for the seller, and GetItem doesn’t return compatibility for items listed with a K type vehicle number.
Lists from the catalog
An eBay developer knowledge base article says GetItem doesn’t return fitment for catalog fitment listings, only for lists entered by hand. For catalog-linked parts, you read the list from the product with the Metadata API’s getProductCompatibilities method, using the listing’s ePID. eBay added it to the Metadata API in version 1.9.0 in December 2024. eBay has retired the older Product API version of this call, so build on the Metadata API. Results come back a page at a time, so a part with a long list takes several calls.
Call limits and terms
eBay sets daily call limits per API. The Metadata API’s default was 5,000 calls a day on eBay’s Sell API call limits page when we checked, but limits change, so read the current page before you plan. Before any of this, read eBay’s API License Agreement. It restricts building a site that competes with eBay from eBay content without written consent. Our guide on selling on your own website and eBay covers the options.
One more file to know about: eBay’s master vehicle list. It’s tempting for building dropdowns, but the Seller Center page says its user agreement limits it to matching vehicles to your eBay Motors listings. Build your finder from the vehicles your parts actually fit.
Turn the rows into year, make and model
Raw compatibility data is long and repetitive. Store it as one row per part and vehicle, and keep where it came from:
item year make model trim engine source
2049xxxx 2006 Honda Civic EX 1.8L catalog
2049xxxx 2007 Honda Civic EX 1.8L catalog
2049xxxx 2008 Honda Civic LX 1.8L catalogThen clean it before anything uses it:
- One spelling per make and model. Decide on “Chevrolet,” not “Chevy,” and fix it once in the data, not in the finder.
- Treat a blank trim or engine as “all.” A row with no trim fits every trim of that model year.
- Collapse years into ranges for display. Ten rows for one model become “2006-2011 Honda Civic.”
- Keep the notes. Notes such as front or rear, left or right, belong on the product page next to the vehicle.
Build the year, make and model finder
The finder asks three questions in order: year, then make, then model. Trim and engine can follow when the data has them. A few rules keep it useful:
- Fill each dropdown only from vehicles that have parts in stock. A buyer who picks a vehicle and gets zero results stops trusting the finder.
- Remember the vehicle. Keep the buyer’s choice as they move between pages, and show “Fits your 2009 Honda Civic” on matching product pages. eBay does something similar with My Garage.
- Combine the vehicle with categories and part-number search. A mechanic often knows the vehicle and the job (“brakes”) but not the part number. Our guide to organizing a large parts catalog covers the categories and search side.
- Don’t publish a page for every vehicle and category pair. Thousands of near-empty pages help nobody. Keep vehicle filtering as a filter, and index the category and brand pages.
Show “fits these vehicles” on product pages
On each product page, list one line per make and model with its years, sorted by make. When a list runs to hundreds of lines, show the first group with a “show all vehicles” button, and keep the full list in the page so search engines and buyers on slow phones can read it. Put the vehicle list in the product’s structured data too, using schema.org’s isAccessoryOrSparePartFor property.
Add one plain line under the list: where the data came from and a reminder to match the part number. Compatibility is the seller’s responsibility on eBay, and it stays yours on your own site.
Listings with no compatibility list
Many used parts have none: industrial items, parts that never matched a catalog product, or listings that were rushed. Don’t guess. A “may also fit” list built from similar models brings returns.
For these parts:
- Show the part number, photos of the tag and connectors, and measurements.
- Offer an “ask if it fits” form that fills in the part number for the buyer.
- When a shopper has a vehicle selected, keep these parts out of “fits your vehicle” results, and show them in their own “fit not confirmed” group in the category.
The best fix is upstream. Add compatibility on eBay, by catalog or by hand, and the next sync brings it to your site.
Keep it in sync
Fitment isn’t a one-time import. It changes in three ways, and each needs a rule:
- Catalog lists grow. eBay adds model years to catalog products, so refresh catalog-linked parts on a rolling schedule.
- Hand-entered lists change when you edit a listing. Re-read the list whenever a listing is revised.
- Listings end. When a part sells, remove it and its vehicles from the finder the same day.
The first full pass is the slow one. On a large catalog, expect it to take several days inside eBay’s daily limits, with each day’s parts going live as they finish. Treat errors differently by type: an ePID that eBay says it doesn’t know can be marked as done, while an empty reply or server error should be retried the next day. A daily check that counts parts with fitment against the day before will tell you when something breaks. That kind of sync is what our eBay and inventory integration work covers.
How we can help
If your listings already carry fitment, most of the work is reading it within eBay’s rules and presenting it well. Send us your eBay store name and tell us roughly how many of your parts have a compatibility list. We’ll tell you how a finder would work on your own store and how long the first pass would take. Start on our auto parts sellers page or reach us through the contact page.
