Developer Hub

Introduction

This area of the site is designed to assist dealers and third parties working on their behalves to upload their entire vehicle inventories and associated photos into eBay Motors Pro.

If you're a dealer, there are several third party feed providers who can upload to eBay Motors Pro on your behalf.

Find out how to get up-and-running on eBay Motors Pro with third party companies and/or software...

If you're a developer, here you'll find all the technical specifications you need to send inventory files to eBay Motors Pro. Any updates to these specs will also be announced here.

Get an overview of uploading an inventory of listings as a dealer or as a third party...


How to get up-and-running on eBay Motors Pro with third party companies and/or software

Many dealers and marketing agencies use third party companies and/or software to manage sending their stock to publishers like eBay.

It's quick and easy to get your stock onto eBay using a third party, and you won't need to share your eBay User ID or password with anyone.

First, sign up for eBay Motors Pro, then check to see if the software or company you're already using is on the list below.

If they are in the list:

  1. Log into eBay Motors Pro, click on 'Settings' at the top of the screen, navigate to Upload & Publish » Upload Credentials and create an Upload username and password
  2. Use the contact details to inform an account manager or Dealer Support representative of your Upload username and password (you do not need to let them know your eBay username or password)

If they are not on the list:

  1. Contact your account manager for the software or company in question
  2. Direct them to this page (www.ebaymotorspro.co.uk/emp/developer.html)

Third parties who can send your listings to eBay as Classified Ads

We have multiple options to help you on our network. We accept vehicle feeds from multiple 3rd parties, as well as offering the ability to upload direct through our Dealer Centre tool.

Overview of uploading an inventory of listings as a dealer or as a third party

eBay Motors Pro has a simple and robust protocol for uploading your stock. Using a few straightforward tools, you could manage all your listings in an office tool like Excel, or with the assistance of a programmer or developer automatically send entire inventories on behalf of as many sites and dealers as you like.


The overview below will answer the majority of questions you might have while creating an upload file for eBay Motors Pro. We don't provide dedicated technical support for the Upload service, but if you have a question which is not covered here, please Contact Us and we'll update the information where possible.


Account requirements

Every dealer uploading their inventory, either through our webform or through the http upload URL, will need to have registered with eBay and activated their eBay Motors Pro account. Both trial-period and paying dealers can upload listings. A single account corresponds to a single dealer site - this means that a multiple-site franchise needs several accounts.


For someone else to upload their inventory on their behalf, a dealer must create a special Upload username and password, which protects a dealer's account by allowing them to authorise a third party to list on their behalf without actually sharing their eBay User ID and password. Upload usernames and passwords are created through the My Settings part of the eBay Motors Pro website.


Upload process & required files

The basic process is the same regardless of whether you're uploading through eBay Motors Pro (Create Listings> Bulk Upload/ Download), or sending files to the HTTP upload URL, and also whether you're sending listings for the first time or updating details of existing listings. Please refer to the box to the right entitled '3 steps to upload an entire inventory'.


You (and the dealer if you're uploading on someone's behalf) will receive status emails after each upload, detailing any errors which may occurred due to file formats, syntax or content.

See the Technical Specification for more information.

Contact us by email


Technical Specification

Make and Model list (full)

Last update: 24th May, 2017 This file is a CSV (comma-separated value) list of the eBay Motors Pro Make and Model IDs and their names.

Make and Model list for Commercial Trucks

Last update: 24th May, 2017 This file is a CSV (comma-separated value) list of the eBay Motors Pro Make and Model IDs and their names.

Make and Model list for Motorcycles

Last update: 30th August, 2017 This file is a CSV (comma-separated value) list of the eBay Motors Pro Make and Model IDs and their names.

Make list for Motorhomes

Last update: 12th June, 2017

This file is a CSV (comma-separated value) list of the eBay Motors Pro Make IDs and their names.

Note: model name is free text for Motorhomes.

Make and Model list for Classic Cars

Last update: 24th May, 2017 This file is a CSV (comma-separated value) list of the eBay Motors Pro Make and Model IDs and their names.

Make list for Minibuses/ Buses/ Coaches

Last update: 29th July, 2016

This file is a CSV (comma-separated value) list of the eBay Motors Pro Make IDs and their names

Note: model name is free text for Minibuses/ Buses/ Coaches.

3 steps to upload an entire inventory

  1. Create an XML file containing the entire inventory using the specs on this page, and validate it against the XSD (see Resources and Tips for more information)
  2. Place the XML file and digital photos into a ZIP file (See the Technical Specification for more information)
  3. Either upload the file via the webform found in eBay Motors Pro (Create Listings > Upload inventory) OR send the file via HTTP (POST) to https://www.ebaymotorspro.co.uk/emp/
    upload/upload.html

Resources & tips for developing in XML for eBay Motors Pro

If you're familiar with uploading your listings from Excel or other tools in CSV format, then these resources and tips could be helpful in helping you transition to using XML. Please note that the use of tools and websites not provided by eBay is at your own risk.


XML validators

You can save yourself development time by ensuring that your XML validates against the published XSD, available here. There are several online tools available free-of-charge of which we recommend www.validome.org. eBay is not responsible for the content of external sites.


To avoid test listings appearing on eBay while still developing,

make sure you set the "Unpublished" flags in the XML for each listing you upload. This way the listings will appear in your Inventory on eBay Motors Pro, but not on the eBay website. When you are ready to 'go live', simply clear that flag.


Listings on eBay are all subject to eBay's policies and User Agreement,

which all eBay Motors Pro Dealers will have agreed to. Make sure you're aware of what this means for you/ your clients.


If a user's inventory is inactive for 30 days or more,

their account will be deactivated until their inventory is updated.


If you're going to be uploading a lot of listings,

make sure you read the section in the documentation about file sizes. If you exceed the maximum upload file size, your upload will be rejected. There are several scaleable ways to reduce the size of your ZIP files, detailed in the documentation.


If a dealer changes their upload username and password,

and you're uploading via the HTTP URL on their behalf, your upload will fail. In this case, it is up to you to contact the dealer and ascertain why they have changed their details.