Retailer Data Feed Format
The retailer data feed file is a tab delimited text file. The first line in the file (the header) should state the fields used.
Retailers can submit a product and/or a bike feed. The product data feed is for listing clothing, helmets & accessories. The bike data feed is for listing new and used bikes for sale.
Product Data
| Field | Required | Alternatives | Format | Notes |
|---|---|---|---|---|
| ref | yes | id | text max: 20 |
A unique alphanumeric identifier for the item - e.g., your internal ID code. IMPORTANT: Once you submit an item with a unique id, this identifier must not change when you send in a new data feed. Each item must retain the same id in subsequent feeds. |
| url | yes | link | text max: 255 |
The URL of the web page associated with the item. This should not forward to another URL; it must point directly to the target page where customers can add the item to a basket. The domain name may not be an IP address and it must include the http:// portion. |
| price | yes | decimal | The price for the item. | |
| name | yes | title | text max: 80 |
The name or title of the item. |
| brand | no | text max: 25 |
The brand name of the product. | |
| ean | no | upc | text max: 13 |
Universal Product Code (UPC) is a 12 digit number or European Article Number (EAN) is a 13 digit number often below the bar code of the item. |
| shipping | no | decimal | The cost to ship the item, assuming the customer only buys this item. If shipping is free, use 0.00. If shipping is omitted from the feed we will use the maximum shipping cost listed on the retailers website when displaying prices. | |
| image | no | image_link | text max: 255 |
The URL of an associated image for the item. Use your full-sized images, not thumbnail images. Do not include logos or an image that says, "Image not available." |
You can see an example of a product data feed file here.
Bike Data
| Field | Required | Alternatives | Format | Notes |
|---|---|---|---|---|
| ref | yes | id | text max: 20 |
A unique alphanumeric identifier for the bike. IMPORTANT: Once you submit a bike with a unique id, this identifier must not change when you send in a new data feed. Each bike must retain the same id in subsequent feeds. We suggest using the registration number for used bikes and a model demoniker (e.g. GSXR600K7) for new bikes. |
| url | yes | link | text max: 255 |
The URL of the web page associated with the bike. This should not forward to another URL; it must point directly to the target page where customers can view full details about the bike. The domain name may not be an IP address and it must include the http:// portion. |
| price | yes | decimal | The requested price for the bike. | |
| name | yes | title | text max: 80 |
The name or title of the bike. |
| condition | yes | text max: 4 |
The condition of the bike. Valid values are new or used. | |
| make | yes | text max: 50 |
The make of the bike. e.g. Triumph | |
| model | yes | text max: 50 |
The model of the bike. e.g. Daytona 675 | |
| year | yes | numeric 4 digits |
4 digit year of first registration, e.g. 2007 | |
| colour | no | color | text max: 15 |
The colour of the bike. |
| image | no | image_link | text max: 255 |
The URL of an associated image for the bike. Use your full-sized images, not thumbnail images. Do not include logos or an image that says, "Image not available." |
| mileage | no | numeric | The total indicated mileage of the bike. Do not use commas (e.g. use 12500 rather than 12,500). | |
| vrm | no | reg | text max: 8 |
The vehicle registration mark (VRM) of the bike. We do not show this online, however it can be used by visitors when obtaining checks. |
| vin | no | text max: 20 |
The vehicle identification number (VIN) of the bike. We do not show this online, however it can be used by visitors when obtaining checks. |
You can see an example of a bike data feed file here.
General Information
When processing your data feed, we will ignore additional or surplus columns. It does not matter what order the fields are presented in the file as long as they are consistent with the order in the header.
The data feed is based on the Google Base format; this means we can use the same data feed you create to upload to Google/Froogle. Therefore, any third party tool you use to manage your website will probably already be able to create a file you can use in MotorcycleGold.
Please remember that we love data. Therefore, we prefer your data feed to include all products in your catalogue. Also, if you have different fitment or colours for your products, we're more than happy if you have multiple entries. For example, you might have an entry for each colour of Arai RX-7's in your catalogue.