Listings Importer

REALSTACK XML Import Specification

Definition

External System - any external software platform that can send listings to REALSTACK

RS - REALSTACK system or company

RS Client - An individual or company with a REALSTACK account.

RS Subscriber - The REALSTACK Client who participates in the listing export program

RS Inventory Items - property listings within the REALSTACK system

Default Import Frequency

  • 365 days per year
  • Every day at 1:30 am

Requirements for Import Subscriber

  • An active RS Client account
  • Client admin user must send a request to (support@realstack.com) to set import settings for his/her RS Client.  Client admin users or standard users are unable to set up imports within their own RS account. RS Admins will set up a Realstack import for each necessary external service.
  • Required to set up on RS Side:
    • RS Client account name
    • Endpoint information & auth info (if needed)
    • External service info
      • Primary Corp Account ID
      • RS Client Admin Email
      • Sub Corp Account ID(s) 
      • RS Client User email(s)
  • Required to set up on Client side
    • Client application should provide an endpoint for RS Importer to access RS 2.0 Format XML file

Property Type

The Property Types use a bit-wise value to allow the association of one or more Property Types with a property using a single numeric value. The valid numeric values for each Property Type are:

Property Type    Value

Farms    1

Ranches    2

Recreational Land    4

Residential Land    8

Timberland    16

Undeveloped Land    32

Commercial Land    64

Hunting Land    128

Horse Property    256

Lakefront    512

Beachfront    1024

Riverfront    2048

To associate a property with the Ranches property type provide the value 2 in the propertytypes attribute (<item propertytypes="2">). To associate a property with the types Ranches (2) and Recreational Land (4), add their two values together and provide the sum of those values (2 + 4) in the propertytypes attribute to get <item propertytypes="6">. To associate a property with types Undeveloped Land (32), Hunting Land (128), and Horse Property (256), add their values together (32 + 128 + 256) to get <item propertytypes="416">.

A property may be associated with a maximum of three Property Types.

Status

Supported Statuses: New Listing, Available, Under Contract, Sold, Unavailable, Draft, Prospective, Off Market, Other

State

RS supports standard US state names & abbreviations https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States

County

RS supports standard US counties https://en.wikipedia.org/wiki/List_of_counties_by_U.S._state_and_territory

CIty

RS supports standard US cities https://www.britannica.com/topic/list-of-cities-and-towns-in-the-United-States-2023068

Name Description Element Required Data Type
division_name
rs_account_id
rs_account_email
id
rs_account_id
auction
title
url
address
city
state
date
description
title
address
address_2
featured
price_reduced
website_only
listed_date
expiration_date
website_url
gallery
image_link
files
arial_map
topo_map
locator_map
all_maps
brochure
documents
document
url
title
status
state
county
zip_code
city
latitude
longitude
acreage
price
dwelling_sq_ft
bedrooms
bathrooms
taxes_annually
hoa_annually
commission_percent
mls_id
co_rep_1_email
co_rep_2_email
embedded_video_url
embedded_video_url_2
embedded_map_url
virtual_tour_url
Division Name
Division identifier
Division Owner Email
Item identifier
Rs Account ID
Action block
Auction Title
Auction Url
Auction Address
Auction City
Auction State
Auction Date
Listing Description
Listing Title
Listing Address
Second Listing Address
Listing is featured
Listing Price is reduced
Listing displays on client website only
Date when listing been listed on market
Listing expiration date
Listing website url
Listing gallery
Gallery Image Link
Listing Files
Listing arial map file
Listing topo map file
Locator Map file
All Maps file
Brochure file
Listing Documents
Listing Document
Document Url
Document Title
Listing Status
Listing State
Listing County
Zip code
Listing City
Listing Latitude
Listing Longitude
Listing Acreage
Listing Price
Listing Square Feet
Bedrooms count
Bathrooms count
Taxes Annually 
Hoa Annually
Commission precent
Mls Number
Co Rep User Email
Co Rep 2 User Email
Embedded Video Url
Embedded Video Url 2
Embedded Map Url
Video Tour Url
channel.division_name
channel.rs_account_id
channel.rs_account_email
channel.item.id
channel.item.rs_account_id
channel.item.action
channel.item.action.title
channel.item.action.url
channel.item.action.address
channel.item.action.city
channel.item.action.state
channel.item.action.date
channel.item.description
channel.item.title
channel.item.address
channel.item.address_2
channel.item.featured
channel.item.reduced
channel.item.website_only
channel.item.listed_at
channel.item.expiration_date
channel.item.website_url
channel.item.gallery
channel.item.image_link
channel.item.files
channel.item.arial_map
channel.item.topo_map
channel.item.locator_map
channel.item.all_map
channel.item.brochure
channel.item.documents
channel.item.document
channel.item.document.url
channel.item.document.title
channel.item.status
channel.item.state
channel.item.county
channel.item.zip_code
channel.item.city
channel.item.latitude
channel.item.longitude
channel.item.acreage
channel.item.price
channel.item.dwelling_sq_ft
channel.item.bedrooms
channel.item.bathrooms
channel.item.taxes_annually
channel.item.hoa_annually
channel.item.commission_percent
channel.item.mls_id
channel.item.co_rep_1_email
channel.item.co_rep_2_email
channel.item.embedded_video_url
channel.item.embedded_video_url_2
channel.item.embedded_map_url
channel.item.virtual_tour_url

yes
yes
yes
yes
yes
yes
yes
no
yes
yes
no
no
no
yes
yes
yes
yes
yes
yes
yes
no
no
no
yes
no
no
no
no
no
no
no
no
yes
yes
yes
yes
yes
yes
yes
no
no
yes
yes
no
no
no
no
no
no
no
no
no
no
no
no
no		 string
integer
string
integer
integer
structure
string
string
string
string
string
Datetime in UTC TZ ISO 8601
string
string
string
string
string
string (yes / no)
string (yes / no)
Datetime in UTC TZ ISO 8601
Datetime in UTC TZ ISO 8601
string
structure
string
structure
string
string
string
string
string
structure
structure
string
string
string
string
string
string
string
float
float
float
float
integer
integer
float
float
float
integer
string(/[0-9]{4,32}/)
string (email)
string (email)
string (url)
string (url)
mapright or terrastridepro url
mapright or terrastridepro url

XML Example

<rss xmlns:g="http://base.google.com/ns/1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xsi:noNamespaceSchemaLocation="http://www.landsofamerica.com/LandFeed/schemas/LandFeedSchema1.0.xsd">
    <channel>
        <division_name><![CDATA[Realstack]]></division_name>
        <rs_account_id>1111111</rs_account_id>
        <rs_account_email>testest@noreply.com</rs_account_email>
        <item propertytypes="36">
            <id>222</id>
            <auction>
                <title>Auction 2</title>
                <url><![CDATA[https://app.realstack-actions.com/auction/at/1200]]></url>
                <address>State Hwy 20</address>
                <city>Williams</city>
                <state>CA</state>
                <date>2020-10-08T15:56:37</date>
            </auction>
            <rs_account_id>1111111</rs_account_id>
            <description><![CDATA[Realstack Sample Ranch Description]]></description>
            <featured>true</featured>
            <price_reduced>true</price_reduced>
            <website_only>true</website_only>
            <title>Realstack Sample Ranch</title>
            <listed_date>2011-05-26</listed_date>
            <expiration_date>2019-05-26</expiration_date>
            <website_url><![CDATA[https://realestate-catalog.com/111111]]></website_url>
            <gallery>
                <image_link><![CDATA[https://images.realstack.com/big/uploads/user/7/gallery-file/58a2fc6ed39fd083f55d4182bf88826d/610acc3623d35.jpg]]></image_link>
                <image_link><![CDATA[https://images.realstack.com/big/uploads/user/5/gallery-file/40AasJosgf36zqIt4JygzzcJ742eSLG5Bdhai5o3/61640d88409b2.png]]></image_link>
                <image_link><![CDATA[https://images.realstack.com/big/uploads/user/5/gallery-file/40AasJosgf36zqIt4JygzzcJ742eSLG5Bdhai5o3/61640d896ab1f.png]]></image_link>
            </gallery>
            <files>
                <arial_map><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></arial_map>
                <topo_map><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></topo_map>
                <locator_map><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></locator_map>
                <all_maps><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></all_maps>
                <brochure><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></brochure>
                <documents>
                    <document>
                        <url><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></url>
                        <title>Title 1</title>
                    </document>
                    <document>
                        <url><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></url>
                        <title>Title 2</title>
                    </document>
                </documents>
            </files>
            <status>Available</status>
            <address>TBD S of Nestoria Rd</address>
            <address_2>TBD S of Nestoria Rd</address_2>
            <state>Michigan</state>
            <county>Baraga</county>
            <zip_code>49800</zip_code>
            <city>Three Lakes</city>
            <latitude>46.117050</latitude>
            <longitude>-88.156900</longitude>
            <acreage>160.00</acreage>
            <price>79800</price>
            <dwelling_sq_ft>0</dwelling_sq_ft>
            <bedrooms>2</bedrooms>
            <bathrooms>3.5</bathrooms>
            <taxes_annually>10</taxes_annually>
            <hoa_annually>10</hoa_annually>
            <commission_percent>10</commission_percent>
            <mls_id>1043</mls_id>
            <co_rep_1_email>agents@user3.com</co_rep_1_email>
            <co_rep_2_email>again@user.com</co_rep_2_email>
            <embedded_video_url><![CDATA[https://www.youtube.com/embed/tgbNymZ7vqY]]></embedded_video_url>
            <embedded_video_url_2><![CDATA[https://www.youtube.com/embed/tgbNymZ7vqY]]></embedded_video_url_2>
            <embedded_map_url><![CDATA[https://mapright.com/ranching/maps/b21269cc50cbff7d5d44567d8182a398/embed]]></embedded_map_url>
            <virtual_tour_url/>
        </item>
        <item propertytypes="36">
            <id>223</id>
            <sales_data>
                <on_market_date>2018-01-22</on_market_date>
                <sale_price>70800</sale_price>
                <asking_price>79800</asking_price>
                <sale_date>2018-08-02</sale_date>
            </sales_data>
            <rs_account_id>2222222</rs_account_id>
            <description><![CDATA[Realstack Sample Ranch Description 2]]></description>
            <featured>false</featured>
            <price_reduced>false</price_reduced>
            <website_only>false</website_only>
            <title>Realstack Sample Ranch 2</title>
            <listed_date>2012-05-26</listed_date>
            <expiration_date>2020-05-26</expiration_date>
            <website_url><![CDATA[https://realestate-catalog.com/222222]]></website_url>
            <gallery>
                <image_link><![CDATA[https://images.realstack.com/big/uploads/user/7/gallery-file/58a2fc6ed39fd083f55d4182bf88826d/610acc3623d35.jpg]]></image_link>
                <image_link><![CDATA[https://images.realstack.com/big/uploads/user/5/gallery-file/40AasJosgf36zqIt4JygzzcJ742eSLG5Bdhai5o3/61640d88409b2.png]]></image_link>
                <image_link><![CDATA[https://images.realstack.com/big/uploads/user/5/gallery-file/40AasJosgf36zqIt4JygzzcJ742eSLG5Bdhai5o3/61640d896ab1f.png]]></image_link>
            </gallery>
            <files>
                <arial_map><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></arial_map>
                <topo_map><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></topo_map>
                <locator_map><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></locator_map>
                <all_maps><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></all_maps>
                <brochure><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></brochure>
                <documents>
                    <document>
                        <url><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></url>
                        <title>Title 1</title>
                    </document>
                    <document>
                        <url><![CDATA[https://files.realstack.com/uploads/user/177/listing-brochure/6b48bbb8f3f6c2573c761fb6de79102b/621df5c6056c0.pdf?download]]></url>
                        <title>Title 2</title>
                    </document>
                </documents>
            </files>
            <status>Sold</status>
            <address>TBD 2 S of Nestoria Rd</address>
            <address_2>TBD 2 S of Nestoria Rd</address_2>
            <state>Michigan</state>
            <county>Baraga</county>
            <zip_code>49800</zip_code>
            <city>Three Lakes</city>
            <latitude>46.117050</latitude>
            <longitude>-88.156900</longitude>
            <acreage>60.00</acreage>
            <price>19800</price>
            <dwelling_sq_ft>10</dwelling_sq_ft>
            <bedrooms>2</bedrooms>
            <bathrooms>3.5</bathrooms>
            <taxes_annually>20</taxes_annually>
            <hoa_annually>30</hoa_annually>
            <commission_percent>40</commission_percent>
            <mls_id>2044</mls_id>
            <co_rep_1_email>agents@user3.com</co_rep_1_email>
            <co_rep_2_email>again@user.com</co_rep_2_email>
            <embedded_video_url><![CDATA[https://www.youtube.com/embed/tgbNymZ7vqY]]></embedded_video_url>
            <embedded_video_url_2><![CDATA[https://www.youtube.com/embed/tgbNymZ7vqY]]></embedded_video_url_2>
            <embedded_map_url><![CDATA[https://mapright.com/ranching/maps/b21269cc50cbff7d5d44567d8182a398/embed]]></embedded_map_url>
            <virtual_tour_url/>
        </item>
    </channel>
</rss>

<br>
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us