Watches

A Watches feed has an <agents> section and an <adverts> section; each <advert> uses category="watch" and points at its agent by reference.

Read first

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

Example

<?xml version="1.0" encoding="UTF-8"?>
<jamesedition_feed version="3.9">
  <agents>
    <agent reference="ag123">
      <first_name>John</first_name>
      <last_name>Doe</last_name>
      <email>john.doe@example.com</email>
      <phone1>+1234567890</phone1>
    </agent>
  </agents>

  <adverts>
    <advert reference="watch-001" category="watch">
      <type>sale</type>
      <price currency="USD">12000</price>
      <price_on_request>no</price_on_request>
      <title>Brand New Rolex Submariner</title>
      <description>A classic dive watch with exceptional water resistance.</description>
      <preowned>no</preowned>
      <location>
        <country>US</country>
        <region>New York</region>
        <city>New York</city>
        <address>123 Luxury Lane</address>
        <zip>10001</zip>
      </location>
      <hide_address>no</hide_address>

      <brand>Rolex</brand>
      <model>Submariner</model>
      <gender>Men</gender>
      <case_material>Stainless Steel</case_material>
      <dial_color>Black</dial_color>
      <dial_shape>Round</dial_shape>
      <strap_color>Silver</strap_color>
      <strap_material>Metal</strap_material>
      <water_resistance unit="m">300</water_resistance>
      <movement>Automatic</movement>
      <reference_number>124060</reference_number>
      <crystal>Sapphire</crystal>
      <case_diameter>41</case_diameter>
      <thickness>12.5</thickness>
      <functions>
        <chronograph>yes</chronograph>
        <date>yes</date>
      </functions>
      <features>
        <luminous_hands>yes</luminous_hands>
        <rotating_bezel>yes</rotating_bezel>
      </features>

      <media>
        <image>
          <image_url>https://example.com/watch1.jpg</image_url>
        </image>
        <image>
          <image_url>https://example.com/watch2.jpg</image_url>
        </image>
      </media>
      <agent_reference>ag123</agent_reference>
    </advert>
  </adverts>
</jamesedition_feed>

Required fields

• the reference and category="watch" 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	watch-001	Unique advert ID, on the <advert> element.
category (attribute)	Yes	watch	watch	Asset category, on the <advert> element.
type	Yes	sale | rent	sale	Sale or rent.
price (currency attribute)	Yes¹	int	12000 currency="USD"	currency = ISO 4217.
price_on_request	No	yes/no	no	When yes, price hidden on the public listing.
title	No	string	Brand New Rolex…
description	No	text	A classic dive watch…
preowned	No	yes/no	no	no for new.
location/country	Yes	ISO 3166-1 alpha-2	US
location/region	No	text (name)	New York	State / region name (matched by name, not a code).
location/city	Yes	string	New York
location/address	No	string	123 Luxury Lane	Hidden if hide_address=yes.
location/zip	No	string	10001
location/latitude · longitude	No	float	40.71	Optional.
hide_address	No	yes/no	no	Hide the public address.
media/image/image_url	Yes (≥2)	url	https://…/watch1.jpg	JPEG/PNG/WEBP, ≤100, ≤20 MB each.
agent_reference	No	string	ag123	Links the listing to an <agent> (optional).

¹ Required unless price_on_request=yes.

Watch fields

Field	Required	Type	Example	Description
brand	Yes	string	Rolex
model	Yes	string	Submariner
gender	No	enum	Men	Men / Women / Unisex.
case_material	No	string	Stainless Steel
dial_color · dial_shape	No	string	Black / Round
strap_color · strap_material	No	string	Silver / Metal
water_resistance (unit attribute)	No	int	300 unit="m"	Units: m, ft.
movement	No	enum	Automatic	Automatic, Manual (hand-winding), Quartz.
reference_number	No	string	124060	Manufacturer reference.
crystal	No	string	Sapphire
case_diameter · thickness	No	number (mm)	41 / 12.5	Millimetres; decimals allowed.
functions	No	wrapper of yes/no	<chronograph>yes</chronograph>	Named functions — see values below.
features	No	wrapper of yes/no	<luminous_hands>yes</luminous_hands>	Free-form yes/no children; no fixed list. Use clear names (e.g. luminous_hands, rotating_bezel).

Watch functions

Inside <functions>, send any of these as yes/no children. Omit the ones that don't apply.

alarm · chronograph · date · day · gmt · month · moonphase · perpetual_calendar

<features> has no fixed list — send any relevant detail as a yes/no child (for example luminous_hands, rotating_bezel, tachymeter).

Agent fields

Field	Required	Type	Example
reference (attribute)	Yes	string	ag123
first_name · last_name	Yes	string	John / Doe
email	Yes	string	john.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