Legacy format

This is an older feed format kept for reference. New integrations should use the current Real Estate docs: Single Office / Multi Office.

Fields Description

Field	Required/Optional	Value	Description
jameslist_feed	Required	version="3.8"	Root node with version attribute
└ adverts	Required		Wrapper for individual adverts
└── advert	Required	reference, category="real estate"	Contains details of a real estate advert
└─── mls_number	Optional	VarChar	MLS number if exists
└─── preowned	Required	Yes/No	Whether the property is preowned
└─── type	Required	Sale/Rent	Type of listing (sale or rent)
└─── brand	Optional	VarChar	Brand name, if applicable
└─── model	Optional	VarChar	Model name, if applicable
└─── year	Required	Four-digit year	Year of construction
└─── price_on_request	Required	Yes/No	If the price is available on request
└─── price	Required	Integer, currency, vat_included	Price in specified currency
└─── vat	Optional	Float (0.0-100.0)	VAT percentage
└── location	Required		Property location details
└─── country	Required	VarChar	Country
└─── region	Required	VarChar	Region or state
└─── city	Required	VarChar	City
└─── zip	Required	VarChar	Postal/zip code
└─── address	Required	VarChar	Street address
└─── longitude	Optional	Double	Longitude
└─── latitude	Optional	Double	Latitude
└── headline, title	Required	VarChar	Headline/title of the advert
└── description	Required	Text	Detailed description
└── property_type	Required	Enum	Type of property (e.g., Villa, House, Apartment)
└── bedrooms	Optional	Integer	Number of bedrooms
└── bathrooms	Optional	Integer	Number of bathrooms
└── floors	Optional	Integer	Number of floors
└── living_area	Optional	Integer, unit="sqm/sqft"	Indoor living area
└── land_area	Optional	Integer, unit="sqm/sqft/ha/ac"	Outdoor land area
└── emission_rating	Optional	String (A-E)	Property emission rating
└── consumption_rating	Optional	String (A-E)	Property consumption rating
└── licence_id	Optional	VarChar	License ID for the property
└── amenities	Optional		Wrapper for amenities
└─── mountain_view	Optional	Yes/No	Mountain view available
└─── ...	Optional		See full list in Amenitites section
└── media	Required		Wrapper for media links
└─── image	Required		Wrapper for individual image URLs
└──── image_url	Required	VarChar	URL for an image JPEG, PNG or WEBP (up to 100)
└─── video	Optional		Wrapper for video URL
└──── video_url	Optional	VarChar	URL for a property video from supported sources (YouTube, Vimeo, Brightcove)
└─── virtual_tour_url	Optional	VarChar	URL for virtual tour (e.g., Matterport)
└── contact_person	Optional		Wrapper for contact person details
└─── name	Required*	VarChar	Contact person's name (* if using contact_person tag)
└─── title	Optional	VarChar	Contact person’s title
└─── email	Required*	VarChar	Contact email (* if using contact_person tag)
└─── phone	Required*	VarChar	Contact phone number (* if using contact_person tag)
└─── cell	Optional	VarChar	Contact cell number
└─── fax	Optional	VarChar	Contact fax number
└─── address	Required*	VarChar	Contact address (* if using contact_person tag)
└─── reference	Optional	VarChar	Contact reference ID
└─── image	Optional	VarChar	URL to contact person's image
└─── language_codes	Optional	VarChar	Three-letter languages code that agent speaks. See https://en.wikipedia.org/wiki/ISO_639-3
└─── linkedin	Optional	VarChar	Agent's Linkedin account URL
└─── instagram	Optional	VarChar	Agent's Instagram account URL
└─── facebook	Optional	VarChar	Agent's Facebook account URL
└─── tiktok	Optional	VarChar	Agent's TikTok account URL
└─── biography	Optional	VarChar	Agent's biography