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 Single Office format only if you have a single office and the feed will be attached to that specific office. If you have multiple offices that will all be listed in the feed, you must use the Multi 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

Supported Real Estate 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 real_estate_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+

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.

Example of XML:

```xml mls123 no sale 2021 no 5000000 15.0 United States California Los Angeles 90001
123 Sunset Blvd
-118.2437 34.0522
Luxurious Villa in Beverly Hills This stunning villa offers breathtaking views, modern architecture, and unmatched amenities for a luxurious lifestyle. Villa 5 6 3 850 1.5 A A LICENSE yes ... see full list in Amenitites section on the left menu https://example.com/images/property1.jpg https://example.com/images/property2.jpg https://example.com/virtual-tour John Doe Agent johndoe@example.com +1234567890 +0987654321 +1234567891
456 Realty Street, Los Angeles, CA 90001
Agent-123 https://example.com/images/agent.jpg 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
```