eBay Motors

The eBay Motors US site is a specialty eBay site on which vehicles and related items can be offered for sale. In the context of the eBay Motors US site, vehicles include cars, trucks, motorcycles, fire engines, tractors, boats, and even helicopters. In addition to vehicles, sellers can list vehicle parts and vehicle-centric memorabilia on the eBay Motors US site.

The eBay Motors CA site follows many of the same rules and supports many of the same features as the eBay Motors US site.

Only the US maintains a separate site for vehicle listings, with its own site ID. That is, there are no special eBay vehicle sites for other countries. Instead, other eBay sites treat vehicles like any other category.

The majority of this chapter covers information that is specific to eBay Motors US and CA, unless otherwise specified.

This section covers these topics:

Listing US and CA eBay Motors Items

Searching for eBay Motors US Listings

Working with eBay Motors Germany Listings

Working with eBay Motors Australia Listings

Listing US and CA eBay Motors Items

Certain rules for listing items to or retrieving items from the eBay Motors US site are different from the rules for listing to the main eBay US site.

To list a vehicle on the US eBay Motors site, make sure you specify a site ID of 100 (not 0). Then specify the following fields:

In addition, the following sections may be of interest:

Specifying Categories for eBay Motors Listings

eBay Motors has a distinct category hierarchy in which items are listed, and categories and their IDs are not the same as on any other eBay site. When you retrieve the eBay Motors category hierarchy and related category data using GetCategories, GetCategoryFeatures, and GetCategorySpecifics,you need to specify the eBay Motors site instead of the main eBay site. To do this, specify a value of 100 in the X-EBAY-API-SITEID header (for the XML API) or in the request URL (for the SOAP API) (see Routing the Request) and set CategorySiteID to "100".

Similarly, when you list an eBay Motors US item using a call like AddItem, you need to specify the eBay Motors site instead of the main eBay site. To do this, pass a site ID of 100 as described above, and set Item.Site to eBayMotors.

Listing eBay Motors Items in Two Categories

The rules for listing in one or two categories depends on the category:

Specifying a Listing Format for eBay Motors Listings

eBay Motors items within the Parts & Accessories and the Everything Else categories can be listed in Auction or Basic Fixed-Price formats.

When you list nationally, eBay Motors items within vehicle categories can be listed in an auction-style formats, but cannot be listed in the Fixed Price format.

See Local Market Listings for listing format rules when you list vehicles as Local Market listings.

eBay Motors and eBay Stores

Items that an eBay Stores seller lists to the eBay Motors US site also appear in the seller's eBay Store. As with any listing, Stores sellers can define custom store categories for their eBay Motors listings.

See Opening and Managing an eBay Store.

Shipping Details for eBay Motors

For eBay Motors listings, shipping details depend on the category:

Local Market Listings

eBay Motors Local Market listings are a type of classified ad vehicle listing on the eBay Motors US site (not eBayClassifieds.com). Only licensed vehicle dealers with a Local Market subscription can create these listings. The Local Market is defined as the area within a seller-specified radius about a specified postal code. Buyers can retrieve Local Market vehicle listings in searches only when they supply a postal code.

The following vehicle categories can be listed:

Note: Local Market listings are supported for these vehicle categories on the eBay Motors US site only, and for US postal codes only.

You can enable the Best Offer feature on a Local Market listing. However, options to list as "Fixed Price," "Buy It Now," or "Buy It Now + Best Offer" are no longer available. If you have existing Local Market listings that use these types, they will remain on the site and you can revise them until they expire.

Adding Local Market Listings

Note: The GetCategoryFeatures call does not return listing duration information for Local Market Listings.

Required Location and Contact Information

You must include the following information in your local market listing:

Other Local Market Listing Requirements

Your listing must comply with these requirements:

Revising and Relisting Local Market Listings

Note the following call-specific differences when revising or relisting a Local Market listing:

Relisting local vehicle listings is subject to the current restrictions for relisting items in eBay Motors, unless otherwise specified.

Best Offer Only

Best Offer Only listings are created using the Lead Generation format. This special format picks up all of the current functionality of a listing for which Best Offer has been enabled.

For example, GetBestOffers and RespondToBestOffer handle a Best Offer Only local market listing the same as the other listings that support best offers.

Additionally, GetMyeBayBuying handles a Best Offer Only local market listing the same as the other listings that support best offers. Local market listing items will be returned in BestOfferList of the GetMyeBayBuying response, and included in the BuyingSummary.BestOfferCount value. Likewise, GetMyeBaySelling handles a Best Offer Only local market listing the same as the other listings that support best offers and returns the listing in relevant lists: ScheduledList, ActiveList, SoldList, or UnsoldList.

Sellers cannot end a Best Offer Only local vehicle listing early if there are active best offers.

Retrieving Lead Information

When a buyer is interested in a Classified Ad vehicle listing in eBay Motors or Motors categories, he can leave information for the seller via the Ask Seller a Question or eBay lead form on the View Item page. This lead information includes data like name, email address, telephone, best time to contact, trade-in information, interest in financing, and the buyer's time frame for purchasing.

The seller can use the GetAdFormatLeads request to retrieve lead data for his listings.

Specifying the Vehicle Identification Number (VIN)

For the US eBay Motors site, a Vehicle Identification Number (VIN) is required for vehicles from model year 1981 or later. This VIN appears as VIN Number in the Item Specifics section of the View Item page.

Specify this data in Item.VIN (or Item.VRM for the UK site) instead of in item specifics.

For rules that are specific to Australia eBay Motors, see Specifying the VIN and Registration Date for eBay Australia.

eBay uses the VIN (or VRM) to create a link to the vehicle's Vehicle History Report.

In GetItem, the vehicle history report is returned in Item.VINLink (or Item.VRMLink for the UK site). In the Shopping API, GetSingleItem and GetMultipleItems return the report in VhrURL. If no vehicle history report is available, eBay may replace the Vehicle History Report link on the eBay Web site with a plain-text copy of the VIN.

Using Item Specifics in eBay Motors US Listings

On the eBay Motors US site, you use a combination of vehicle-specific fields and custom Item Specifics to fill in vehicle details like Mileage and Exterior Color.

The eBay Motors US Web site UI supports two listing flows:

If you are using the XML API or the SOAP API, the next sections describe the basic process you use to list vehicles to eBay Motors US.

Using GetCategories to Retrieve eBay Motors Categories

First, use GetCategories to retrieve all the available eBay Motors categories. Be sure to specify the eBay Motors US site instead of the main eBay site. To do this, specify a value of 100 in the X-EBAY-API-SITEID header (for the XML API) or in the request URL (for the SOAP API). (See Routing the Request.)

The following example shows a typical GetCategories request, using the XML API.

Example: GetCategories Request (XML API)
<?xml version="1.0" encoding="utf-8"?>
<GetCategoriesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>YOURTOKENHERE</eBayAuthToken>
  </RequesterCredentials>
  <CategorySiteID>100</CategorySiteID>
  <DetailLevel>ReturnAll</DetailLevel>
  <ViewAllNodes>true</ViewAllNodes>
</GetCategoriesRequest>

As usual for this call, store the response locally. In most cases, eBay Motors categories are associated with specific makes and models, like "Pontiac : Trans Am". You will use a category ID to identify the make and model in Item.PrimaryCategory.CategoryID when you list the item.

The following example shows the Pontiac category and the Trans Am category in the GetCategories response for the eBay Motors US site.

GetCategories doesn't specifically indicate "make" or "model", but for vehicles the leaf category is the model. (The example also shows that 6377's parent is 6001, which is Cars & Trucks, so we know this is a vehicle category.).

Example: Categories in the GetCategories Response (XML API)
<Category>
  <BestOfferEnabled>true</BestOfferEnabled>
  <AutoPayEnabled>true</AutoPayEnabled>
  <CategoryID>6377</CategoryID>
  <CategoryLevel>3</CategoryLevel>
  <CategoryName>Pontiac</CategoryName>
  <CategoryParentID>6001</CategoryParentID>
  <Expired>false</Expired>
  <IntlAutosFixedCat>false</IntlAutosFixedCat>
  <LeafCategory>false</LeafCategory>
  <Virtual>false</Virtual>
  <SellerGuaranteeEligible>true</SellerGuaranteeEligible>
  <ORPA>false</ORPA>
  <LSD>true</LSD>
</Category>
<Category>
  <BestOfferEnabled>true</BestOfferEnabled>
  <AutoPayEnabled>true</AutoPayEnabled>
  <CategoryID>6427</CategoryID>
  <CategoryLevel>4</CategoryLevel>
  <CategoryName>Trans Am</CategoryName>
  <CategoryParentID>6377</CategoryParentID>
  <Expired>false</Expired>
  <IntlAutosFixedCat>false</IntlAutosFixedCat>
  <LeafCategory>true</LeafCategory>
  <Virtual>false</Virtual>
  <SellerGuaranteeEligible>true</SellerGuaranteeEligible>
  <ORPA>false</ORPA>
  <LSD>true</LSD>
</Category>

Using GetCategoryFeatures and GetCategorySpecifics to Retrieve Item Specifics

Details about motorcycles are different from details about Cars & Trucks . A motorcycle would have details like "Engine Size (cc)", and truck would have details like "Cab type". In the API, these details are called Item Specifics.

To determine whether a vehicle category supports custom Item Specifics, call GetCategoryFeatures and look for ItemSpecificsEnabled in the response, for the specified category. If the category supports custom Item Specifics, call GetCategorySpecifics to retrieve the recommendations and any related rules. See Working with Custom Item Specifics.

Specifying the Vehicle Manufacturer and Model

When you submit a Cars & Trucks listing to the eBay Motors US site, we strongly recommend that you avoid specifying the Manufacturer and Model item specifics in most cases. In most cases, this information will be pre-filled based on the category you select.

Specifying a Subtitle for a Motors Vehicle Listing

On the eBay Motors site, the listing title is filled in automatically by eBay for certain vehicle categories (e.g., Cars & Trucks).

Use the Item.SellerProvidedTitle field to specify a seller's personalized title that will appear on the View Item page and that can be used to differentiate the item in search results. Choose keywords that help distinguish your vehicle in search results, such as color, condition, body style, and unique options.

For Cars & Trucks, the SellerProvidedTitle is a required field.

The subtitle appears in the Item Specifics section of a listing.

Payment Methods for Motors

Payment methods for items are defined by using Item.PaymentMethods, as you do with other listings. This code list includes several methods that can be used for items on the eBay Motors US site. There are specialized payment provisions and methods for selling vehicles on the eBay Motors US site (except in the Parts and Accessories category) and on the eBay Canada site for motors.

When you list a vehicle, at least one full payment method that applies to vehicle listings is required. Specifically, one or more of the following payment methods must be used: MOCC, PersonalCheck, LoanCheck, CashInPerson, and/or PaymentSeeDescription. The LoanCheck and CashInPerson payment methods are specific to vehicle listings. Buyers cannot make full payments by credit card or PayPal.

Note: If a vehicle listing offers PayPal or a credit card, then the listing must also specify deposit (because PayPal and credit cards cannot be used for full payments). See Specifying a Vehicle Deposit and Deposit Amount.

DaysToFullPayment can be used to specify the number of days after the auction closes that the buyer can take to pay for the item. The choices are 3, 7, 10, and 14, and the default is 7.

On the eBay Motors US site, a deposit can be specified. (The eBay Motors Canada site doesn't support deposits). If you specify a deposit, you can also use HoursToDeposit to specify the number of hours after an auction closes that the buyer can put down a deposit on the item. See Specifying a Vehicle Deposit and Deposit Amount.

Specifying a Vehicle Deposit and Deposit Amount

When you require a vehicle deposit, the completed listing displays an option (such as a Pay button) to enable the buyer to pay the deposit online.

Use the Item.PaymentDetails.DepositAmount field to specify the amount of a vehicle deposit (a non-zero value up to $2000.00) . Vehicle deposits must be paid for through PayPal.

If requiring a deposit on a vehicle, the seller must:

Also see Requiring Immediate Payment of a Vehicle Deposit.

When revising a vehicle listing, additional validation rules apply:

Requiring Immediate Payment of a Vehicle Deposit

When listing a vehicle on the eBay Motors US site, a seller who is eligible to offer Immediate Payment can choose to require Immediate Payment of the vehicle deposit for eligible listings.

If the seller chooses to require Immediate Payment of the deposit, follow all the same rules that are described in Specifying a Vehicle Deposit and Deposit Amount, and also set AutoPay to true (to indicate that Immediate Payment is required).

Vehicle Purchase Protection

eBay offers Vehicle Purchase Protection, which ensures that you receive the vehicle you paid for, with coverage up to $20,000 against fraud or material misrepresentation. (The seller does not choose this. It is offered by eBay.)

For information about vehicle categories that support Vehicle Purchase Protection, please refer to the following help pages:

Vehicle Purchase Protection (US)

http://pages.motors.ebay.com/services/purchase-protection.html

Passenger Vehicle Purchase Protection (CA)

http://pages.ebay.ca/ebaymotors/help/education/buying/purchase-protection.html

On the eBay Motors US site, when you use GetItem, the Purchase Protection item specific is returned false if no Vehicle Purchase Protection is available, or true if it is available. Other sites that support this feature and that use Item Specifics for vehicles return similar information.

Listing eBay Motors US Items in eBay Stores

Motor vehicles and parts and accesories listings that an eBay Stores seller lists to the eBay Motors US site also appear in the seller's eBay Store. These items can be listed in auction or fixed-price formats.

Revising US Motors Listings

See Revising US eBay Motors Listings.

Also see Revising and Relisting Local Market Listings.

Short-Term Service Agreement (Limited Warranty)

Note: This feature is not currently supported.

If you pass LimitedWarrantyEligible in your request, it is ignored as of June 2010. The following information is being provided as background information for developers who are removing support for this feature from their applications.

For certain vehicles, eBay previously offered a free 1 month/1,000 mile Short-Term Service Agreement (also referred to as a limited warranty). Only vehicles that are not disqualified as having certain modifications and that are not classified as special vehicle types (e.g., Corvette ZR1) were eligible for this limited warranty.

When listing a Motors vehicle, your application was required to provide the seller with an opportunity to indicate whether the vehicle has not been modified and is not a special type:

For a complete list of vehicle modifications and special vehicle types that are not eligible for the limited warranty, see the eBay Motors site:

Short Term Service Agreement Coverage Plan Details

http://pages.motors.ebay.com/help/buyandsell/lw_details.html

You were required to present the following options to the seller as part of the listing process. If you present the options as radio buttons, use this text (where the parentheses "( )" represent radio buttons):

Please check one of the following:

(X) The vehicle listed has no modifications and is not a special vehicle type.

( ) The vehicle listed has been modified and/or is a special vehicle type.

In listing requests, the LimitedWarrantyEligible flag was used to indicate the seller's selection. If LimitedWarrantyEligible is passed in, it means your application has presented the seller with options to indicate this information. If the value is true, the seller has verified that the vehicle has not been modified and is not a special type. If false, the seller has verified that vehicle has been modified or it is a special type.

Passing a value of true did not guarantee that eBay will offer a limited warranty. It only made the listing eligible for consideration.

On the eBay Motors US site, when you use GetItem, the Limited Warranty attribute (26738) is returned with a value of -14 (No) if the limited warranty is not available (it previously returned -13 (Yes) if it was available). Other sites that support this feature and that use Item Specifics for vehicles return similar information. Use GetAttributesCS to determine the applicable attribute and value IDs.

Searching for eBay Motors US Listings

To search for eBay Motors listings, use FindItemsAdvanced in the Finding API.

Be sure to specify the eBay Motors site (ID 100).

FindItemsAdvanced in the Finding API

http://developer.ebay.com/DevZone/finding/CallRef/findItemsAdvanced.html

GetMultipleItems in the Shopping API

http://developer.ebay.com/DevZone/Shopping/docs/CallRef/GetMultipleItems.html

Use category IDs for the eBay Motors site to search against a vehicle's make and model. A category ID of 6001 can be used to search all vehicle categories, 6024 to search just motorcycle categories, 6028 to search all parts categories, and 6038 to search other categories. These generic categories can also be used if the site ID is 0 (main eBay US site), in which case they automatically direct the search to eBay Motors. However, if you use site ID 0 instead of site ID 100, the API might not return data that is specific to the eBay Motors site, such as the vehicle's mileage and year.

Working with eBay Motors Germany Listings

This section provides brief notes about working with listings on eBay Motors Germany.

Cross-Promoting Vehicles on the Mobile.de Site

This listing upgrade is applicable to listings on the eBay Germany site only.

Mobile.de (a German Motors classifieds platform) cross-promotes items from eBay Germany's Car, Motorcycle, and Special Vehicle categories by displaying them to users who are browsing and searching on the mobile.de site. An eBay seller can purchase a listing upgrade to allow mobile.de to include the listing in mobile.de search results. To be eligible, the item must be a vehicle listed on the eBay Germany site (site ID 77) in a subcategory of one of the following mobile.de search-enabled categories.

Table: Mobile.de Search-Enabled Categories
Category Name Category ID
Automobile 9801
Spezielle Fahrzeuge 46159
Motorräder 9804

Usage of this feature is optional. It does not affect the visibility of the listing on eBay.com sites.

In AddItem and other requests that list items, pass the MotorsGermanySearchable flag with a value of true to indicate that the seller wants to purchase this listing upgrade. If the item and category are eligible, the item will be included in eBay search results on the mobile.de site. This flag is ignored if specified for other categories. It will trigger an error if specified for other sites.

This flag can be added to an active listing at any time by using ReviseItem, regardless of whether the listing has bids or how soon the listing ends, as long as the item and category are eligible for this feature. Once this flag set to true for a listing, you cannot reset it to false when revising an item that is still listed in a mobile.de search-enabled category.

You can set the MotorsGermanySearchable flag to false (and remove the listing from mobile.de site search results) when relisting the item, regardless of the category. Similarly, if the seller changes the category to one that is not mobile.de search-enabled, eBay resets the MotorsGermanySearchable flag to false.

Working with eBay Motors Australia Listings

This section provides brief notes about working with listings on eBay Motors Australia.

Specifying the VIN and Registration Date for eBay Australia

eBay Motors Australia uses different custom Item Specifics than the US, but you use the same calls and approach.

The VIN is a unique set of 17 characters found on all Australian vehicles manufactured after 1989.

When you specify VIN, always also specify the Date of 1st Registration in item specifics. There is a dependency between the VIN and the Date of 1st Registration. If you don't specify the Date of 1st Registration:

Copyright © 2005–2016 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.