Skip to main content
Legacy format

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

Introduction

Read these instructions before you build the feed. Bold text marks the parts that most often cause mistakes or unfinished listings.

Format Selection: Use the Multi Office format only if you have multiple offices and all of them will be listed in the <offices> section of the feed. If you have a single office and the feed will be attached to that specific office, you must use the Single Office format instead.

Feed Update Schedule: The feed is updated three times daily at approximately 00:11, 08:11, and 16:11 UTC.

These instructions are presented to visually show how the JamesEdition XML feed is built and showcases how the tags should be designed under their correct parent.

A green field symbolises the beginning of a branch and the bright red field shows the end of it. This is to ensure all subtitles and optional fields are under their correct headline.

Image URLs must be canonical and must not change over time.

Include no more than 100 images per listing. Each image file must be under 20 MB.

All elements marked as required must be present in the feed, though some can be empty-closed. If you choose to skip optional tags, or leave them empty, close them e.g. <zip />.

These include, for example, <price/> when <price_on_request> is set to 'yes'. XML encoded content in strings, e.g., & should be &amp;.

Supported Video Sources:

  • YouTube: https://www.youtube.com/watch?v=VIDEO_ID or https://youtu.be/VIDEO_ID
  • Vimeo: https://player.vimeo.com/video/VIDEO_ID
  • Brightcove: https://players.brightcove.net/00000000001/default_default/index.html?videoId=VIDEO_ID

Supported Virtual Tour Sources:

  • Matterport:
    • https://my.matterport.com/show/?m=ABCDEFG&play=1&brand=0&ts=1&mls=1&tourcta=2
    • https://gemelosdigitales.3dvirtualtours.es/scene.php?id=1234
    • https://realeyez360.com/v/ABCDEFG
    • https://matterport.com/discover/space/ABCDEFG
  • My360: https://vt.plushglobalmedia.com/tour/12345/embed?config=jamesedition
  • YouriGuide: https://youriguide.com/ABC123
  • Realistico: https://viewer.realisti.co/1234ABCD/?viewMode=embed
  • Nodalview: https://nodalview.com/s/ABCDEFGH
  • VT 3DVista:
    • https://360.pinkrealestate.pt/1234/
    • https://360exploravr.com/virtual-tours/123456/
    • https://storage.net-fs.com/hosting/path/to/virtualtour/
  • H4Life: https://h4l.site/360/virtualtour
  • Virtea: https://virtea.com/tours/12345/
  • CloudPano: https://app.cloudpano.com/tours/ABCDEFG/
  • BuyMeProperty: https://www.buymeproperty.pt/sharevirtualtour/12345/
  • Ego Real Estate:
    • https://websitesv4.egorealestate.com/sharevirtualtour/123-456
    • https://admin.egorealestate.com/egocore/vtour/123/456
  • Kuula: https://kuula.co/share/collection/XYZ123
  • Vale do Lobo: https://valedoloboproperties.com/360VirtualTour/Home/XYZ/
  • Theasys: https://theasys.io/viewer/ABCDEFG/
  • iStaging: https://livetour.istaging.com/XYZ-123
  • VirtualinkCY: https://tours.virtualinkcy.com/XYZ-123
  • Giraffe360: https://giraffe360.com/tour/12345678/
  • Floorfy: https://floorfy.com/tour/12345678/
  • arxftpserver: https://arxftpserver.com/XXX

Unique Access and Image Download Policies

Our service does not use a fixed IP address. When our crawler requests your feed and image files, it identifies itself using the following HTTP header: User-Agent: JamesEdition Feed Crawler 1.0

Allow requests with this User-Agent on your side.

We may also download the same image more than once, unless your integration is set up otherwise.

Supported Property Types:

Default list: House, Villa, Estate, Country house, Finca, Chalet, Townhouse, Bungalow, Apartment, Penthouse, Condo, Co op, Land, Castle, Chateau, Farm ranch, Private island

The property_type element allows any value to be presented. However, the provided value will be mapped to the default values on our end.

Supported Emission and Consumption Ratings:

Default list: A, B, C, D, E, F, G, X, A+, B-, NC, NI, A1, A2, A3, A4, B+

Example of XML:

```xml HM Properties 1234567 28210 US NC Charlotte
28210, Fairview Road
+123456789 +123456789 +123456789 hm.properties@example.com Main office in Charlotte City http://example.com/charlotte-office http://example.com/office-logo.png spa, eng, rus https://linkedin.com/in/jamesedition https://instagram.com/jamesedition https://facebook.com/jamesedition https://tiktok.com/@jamesedition
Stive Smith stive.smith@example.com +123456789 +123456789 +192837465 http://example.com/profile-pic.jpg 636289 spa, eng, rus https://linkedin.com/in/jamesedition https://instagram.com/jamesedition https://facebook.com/jamesedition https://tiktok.com/@jamesedition John Doe agent of the year 2022 REF124 mls124 yes 2014 no no 1607143 US NY 43.9732 -75.9108 Black River
123 Luxury St
12345
Luxury Villa in Exclusive Area This luxurious Mt. Vernon style villa features formal rooms, a gourmet kitchen, walnut hardwood floors, and a beautiful garden with pool and gazebo. Villa 5 4 2 217 361 A B yes ... see full list in Amenitites section on the left menu http://example.com/picture1.jpg http://example.com/picture2.jpg https://youtube.com/example https://my.matterport.com/show/?m=exampleID ag123 of123 no no
```