Cars

A Cars feed has an <agents> section and an <adverts> section; each <advert> uses category="car" and points at its agent by reference. (For a dealer group with several offices, use the multi-office layout with an <offices> section.)

Read first

Getting Started covers the shared rules — fetch schedule, the JamesEdition Feed Crawler 1.0 User-Agent, image rules, and supported video sources.

Example

<?xml version="1.0" encoding="UTF-8"?>
<jamesedition_feed version="3.9">
  <agents>
    <agent reference="ag123">
      <first_name>Jane</first_name>
      <last_name>Doe</last_name>
      <email>jane.doe@example.com</email>
      <phone1>+1234567890</phone1>
      <profile_picture_url>https://example.com/jane.jpg</profile_picture_url>
    </agent>
  </agents>

  <adverts>
    <advert reference="car-001" category="car">
      <type>sale</type>
      <price currency="USD">280000</price>
      <price_on_request>no</price_on_request>
      <title>Exquisite Ferrari F8 Tributo</title>
      <description>A 710 HP V8 with a premium interior.</description>
      <year>2021</year>
      <preowned>yes</preowned>
      <location>
        <country>US</country>
        <region>California</region>
        <city>Los Angeles</city>
        <address>123 Luxury Avenue</address>
        <zip>90001</zip>
      </location>
      <hide_address>no</hide_address>

      <brand>Ferrari</brand>
      <model>F8 Tributo</model>
      <car_type>Coupe</car_type>
      <certified>yes</certified>
      <gearbox>Automatic</gearbox>
      <drivetrain>RWD</drivetrain>
      <engine>8 Cylinder</engine>
      <drive>LHD</drive>
      <color>Red</color>
      <interior_color>Black</interior_color>
      <fueltype>Petrol</fueltype>
      <mileage unit="km">8000</mileage>
      <vin>12345VIN67890</vin>
      <fuel_consumption>12.4</fuel_consumption>
      <co2_emission>292.0</co2_emission>
      <co2_efficiency>A</co2_efficiency>

      <media>
        <image>
          <image_url>https://example.com/car1.jpg</image_url>
        </image>
        <image>
          <image_url>https://example.com/car2.jpg</image_url>
        </image>
        <video>
          <video_url>https://youtu.be/example</video_url>
        </video>
      </media>
      <agent_reference>ag123</agent_reference>
    </advert>
  </adverts>
</jamesedition_feed>

Required fields

• the reference and category="car" attributes on <advert>
• brand and model
• location/country and location/city
• a price — price (with currency) or price_on_request=yes
• at least 2 images
• agent_reference matching an <agent>

Advert fields

Field	Required	Type	Example	Description
reference (attribute)	Yes	string	car-001	Unique advert ID, on the <advert> element.
category (attribute)	Yes	car	car	Asset category, on the <advert> element.
type	Yes	sale | rent	sale	Sale or rent.
price (currency attribute)	Yes¹	int	280000 currency="USD"	currency = ISO 4217.
price_on_request	No	yes/no	no	When yes, price hidden on the public listing.
title	No	string	Exquisite Ferrari…
description	No	text	A 710 HP V8…
year	No	int	2021	Manufacturing year.
preowned	No	yes/no	yes	no for new.
location/country	Yes	ISO 3166-1 alpha-2	US
location/region	No	text (name)	California	State / region name (matched by name, not a code).
location/city	Yes	string	Los Angeles
location/address	No	string	123 Luxury Avenue	Hidden if hide_address=yes.
location/zip	No	string	90001
location/latitude · longitude	No	float	34.05	Optional.
hide_address	No	yes/no	no	Hide the public address.
media/image/image_url	Yes (≥2)	url	https://…/car1.jpg	JPEG/PNG/WEBP, ≤100, ≤20 MB each.
media/video/video_url	No	url	https://youtu.be/…	Supported video sources.
agent_reference	Yes	string	ag123	Must match an <agent> reference.

¹ Required unless price_on_request=yes.

Car fields

Field	Required	Type	Example	Description
brand	Yes	string	Ferrari	Make.
model	Yes	string	F8 Tributo	Model.
car_type	No	enum	Coupe	See values below.
certified	No	yes/no	yes	Manufacturer-certified.
gearbox	No	enum	Automatic	See values.
drivetrain	No	enum	RWD	See values.
engine	No	enum	8 Cylinder	Cylinder count — see values.
drive	No	enum	LHD	LHD / RHD.
color	No	string	Red	Exterior colour.
interior_color	No	string	Black
fueltype	No	enum	Petrol	See values.
mileage (unit attribute)	No	int	8000 unit="km"	Units: km, mi (default km).
vin	No	string	12345VIN67890
fuel_consumption	No	number	12.4	Combined, litres per 100 km (L/100 km).
co2_emission	No	number	292.0	Combined, g/km.
co2_efficiency	No	string	A	Free text — the EU energy-efficiency class as printed (e.g. A, B, D). Not validated against a fixed list.

Car field values

Send one of the canonical values below. Other values still import — we map common variants (e.g. Estate → Station/Estate wagon) — but a canonical value avoids gaps.

Field	Allowed values
car_type	Cabriolet, Coupe, Hot rod, Limousine, Pickup, Race car, Roadster, RV, Sedan, Station/Estate wagon, SUV, Other
gearbox	Automatic, Manual, Semi-automatic, CVT, Dual-clutch, Tiptronic, E-Gear, F1, Other
drivetrain	RWD, FWD, AWD, 4x4, 6x6
drive	LHD, RHD
engine	3 Cylinder, 4 Cylinder, 5 Cylinder, 6 Cylinder, 8 Cylinder, 10 Cylinder, 12 Cylinder, 16 Cylinder, Electric, Other
fueltype	Petrol, Diesel, Electric, Hybrid, Ethanol, Other

Agent fields

Field	Required	Type	Example
reference (attribute)	Yes	string	ag123
first_name · last_name	Yes	string	Jane / Doe
email	Yes	string	jane.doe@example.com
phone1	No	string	+1234567890
phone2 · fax	No	string
agent_license_id	No	string	636289
profile_picture_url	No	url
language_codes	No	string	eng,spa
linkedin / instagram / facebook / tiktok	No	url
biography	No	text