XML импорт для агентств недвижимости

Если Вы представляете интересы агентства недвижимости, заинтересованного в публикации большого количества объявлений на портале GVANGA.COM – для Вас существует сервис выгрузки объявлений XML.

Загрузка XML фида:

Шаг 1 - Создайте XML файл (фид) – структурированный, обновляемый каталог Вашего сайта.

Вы можете использовать формат XML фида для Яндекс.Недвижимости.

Требования к фиду

Актуальность - Фид должен содержать только актуальные данные об объявлениях.

Редактирование уже загруженных объявлений необходимо осуществлять путем обновления уже существующих данных. Обратите внимание, что удаление старого объявления и создание новой копии может привести к дублированию и последующей блокировке публикации данного объявления.

Технические требования к фиду

  • URL фида должен быть постоянным и доступным по протоколу HTTP.
  • Импорт данных Вашего XML фида будет производиться 1 раз в сутки.
  • Фид должен быть создан в кодировке UTF-8.
  • Не допускается наличие в фиде HTML-кода.
  • В текстовых полях не должны использоваться первые 32 символа с ASCII-кодами (за исключением значений 9, 10 и 13).
  • Кроме того, ряд символов для файла необходимо заменять кодами:

 

Символ  Код
"             "
&            &
>             >
<             &lt;
'              &apos;

 

Формат фида

Заголовок фида должен начинаться со стандартного XML-заголовка:
<?xml version="1.0" encoding="utf-8"?>

В файле должен быть корневой элемент realty-feed - <realty-feed>  </realty-feed> с датой создания фида:
<generation-date>YYYY-MM-DD HH:mm:ss+04:00</generation-date>

Каждое объявление в фиде формируется элементом offer, для которого необходимо указывать уникальный идентификатор internal-id:
<offer internal-id="Номер id"> ... </offer>

 

Описание обязательных параметров элемента offer:

ЭлементОписание
<type>Направление сделки («продать» или «продажа», «купить» или «покупка», «сдать» или «аренда», «снять» или «арендовать» )
<category>Категория объекта: «комната», «room», «квартира», «flat», «дом», «house», «дача»,   «коттедж», «cottage», «таунхаус», «townhouse», «земельный участок», «lot», «гараж», «garage».
Для коммерческой недвижимости: «офис», «office», «коворкинг», «coworking», «магазин», «shop», «торговые площади», «для красоты, отдыха, оздоровления», «склад», «производство и промышленность», «помещения свободного назначения», «здания, сооружения».
<url>Ссылка на страницу с объявлением
<creation-date>Дата создания объявления – формат даты: YYYY-MM-DDTHH:mm:ss+00:00
<location> … </location>Набор обязательных элементов для описания расположения объекта недвижимости:
<country>Страна
<locality-name>Город
<description>Текст объявления – дополнительная текстовая информация
<price> … </price>Элементы показателя «Цена».
<value>Сумма (без пробелов).
<currency>Валюта: «RUR» или «RUB», «USD», «EUR», «UAH»

 

Дополнительные параметры.

Рекомендуется включать в фид все элементы предложений, чтобы Ваши объекты лучше попадали в результаты поиска пользователей сайта – Ваших потенциальных клиентов.

 

ЭлементОписание
<last-update-date>Дата последнего обновления объявления (в формате даты)
<title>Заголовок объявления
<expire-date>Срок публикации объявления (до указанной даты – в формате даты)
<location> … </location>Дополнительный набор элементов для определения местоположения объекта.
<distance>Расстояние до города в километрах.
<distance-to-metro>Расстояние до метро в метрах.
<latitude>Географическая широта.
<longitude>Географическая долгота.
<image>Фотография - для каждой фотографии нужно создавать отдельный тег с адресом (может быть загружено до 4 изображений).
<video>Видео ролик к объявлению -  укажите URL ссылку на видеообъявление. С сайта YouTube.com.
<period>Срок аренды («день» или «day», «месяц» или «month», «долгосрочная» или «long-term»).
<new-flat>Параметр для квартир в новостройках («да», «true», «1», «+») - для квартир, в которых не фигурирует данный элемент по умолчанию будет применяться значение «вторичный рынок».
<is-elite>Элитность (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<floor>Этаж.

<floors-total>

Этажность.

<building-type>Тип дома («панельный», «монолит», «кирпичный», «блочный», «деревянный»).
<building-class>Класс здания – для коммерческой недвижимости («A», «B», «C», «D»)
<rooms>Количество комнат.
<area>Общая площадь объекта.
<living-space>Жилая площадь.
<room-space>Площадь комнаты – для каждой комнаты отдельный тег.
<kitchen-space>Площадь кухни.
<lot-area>Площадь земельного участка.
<value>Числовое значение площади.
<unit>Единица измерения площади: «кв. м», «м2», «sq.m», «ft2», «sq.ft», «cотка», «гектар», «hectare», «акр», «acre».
<ceiling-height>Высота потолков в метрах – разделитель точка.
<balcony>Наличие балкона или лоджии («балкон», «лоджия»).
<bathroom>Количество санузлов.
<phone>Наличие телефона (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<internet>       Наличие интернета (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<room-furniture>Наличие мебели (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<kitchen-furniture>Наличие кухонной мебели (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<television>Наличие телевизора (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<washing-machine>Наличие стиральной машины (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<refrigerator>Наличие холодильника (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<rubbish-chute>Наличие мусоропровода (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<lift>Наличие лифта (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<heating-supply>Отопление (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<аir-conditioning>Кондиционер (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<water-supply>Водопровод (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<sewerage-supply>Канализация (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<gas-supply>Газопровод (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<electricity-supply>Электричество (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<concierge>Консьерж (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<parking>Наличие парковки (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<parking-place>Количество машиномест.
<alarm>Наличие охраны (да - «да»,  «true», «1», «+»; нет -«нет», «false», «0», «-»).
<with-pets>

Для аренды: можно ли с животными («да»/ «нет», «true»/«false», «1»/«0», «+»/«-»).

<sales-agent>

Набор элементов контактных данных риэлтора - Вы можете заполнить контактные данные для объявлений в личном кабинете пользователя GVANGA, чтобы они фигурировали во всех загружаемых объявлениях без дополнительного заполнения данных элементов в фиде. Если же контакты агента отличаются от указанных ранее на нашем сайте, добавьте этот элемент в Ваш XML файл.
<name>Имя риэлтора
<email>Электронный адрес
<phone>Номер телефона агента
<country>Страна
<locality-name>Город
<address>Улица (или улица и дом)

Пример корректного XML фида:

<?xml version="1.0" encoding="UTF-8"?>
<realty-feed>
    <generation-date>2015-12-29T12:00:00+04:00</generation-date>
    <offer internal-id="7">
        <type>продажа</type>
        <property-type>жилая</property-type>
        <category>дом</category>
        <url>https://gvanga.com/ad/vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.html</url>
        <creation-date>2015-12-05T00:00:00+04:00</creation-date>
        <expire-date>2015-12-12T00:00:00+04:00</expire-date>
        <last-update-date>2016-12-14T00:00:00+04:00</last-update-date>
        <location>
            <country>Россия</country>
            <locality-name>Вышний Волочек</locality-name>
            <address>Новая улица</address>
            <distance>1</distance>
            <latitude>53.56414</latitude>
            <longitude>35.84554</longitude>
        </location>
        <price>
            <value>2300000</value>
            <currency>RUB</currency>
        </price>
        <image>https://gvanga.com/img/a/original/71778_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <image>https://gvanga.com/img/a/original/71777_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <image>https://gvanga.com/img/a/original/71776_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <image>https://gvanga.com/img/a/original/71775_vengriya-prodaetsya-dom-v-derevne-kurorte-deneshdiash-vblizi-ozera-balaton.jpg</image>
        <title>Продаю дом 80 кв.м с земельным участком 7 соток.</title>
        <description>Тверская область, г.Вышний Волочек (От МКАД 320км — по асфальтированной дороге.)
            Земельный участок разработан. На участке — гараж, баня, хоз.постройки.
        </description>
        <video>https://www.youtube.com/watch?v=y5SAqL7j8Yo</video>
        <is-elite>1</is-elite>
        <floor>1</floor>
        <floors-total>1</floors-total>
        <building-type>кирпичный</building-type>
        <rooms>2</rooms>
        <area>
            <value>80</value>
            <unit>кв.м</unit>
        </area>
        <kitchen-space>
            <value>9</value>
            <unit>кв.м</unit>
        </kitchen-space>
        <room-space>
            <value>20</value>
            <unit>кв.м</unit>
        </room-space>
        <room-space>
            <value>30</value>
            <unit>кв.м</unit>
        </room-space>
        <lot-area>
            <value>7</value>
            <unit>cот.</unit>
        </lot-area>
        <living-space>
            <value>61</value>
            <unit>кв.м</unit>
        </living-space>
        <ceiling-height>2.5</ceiling-height>
        <balcony>лоджия</balcony>
        <bathroom>2</bathroom>
        <phone>1</phone>
        <internet>1</internet>
        <room-furniture>1</room-furniture>
        <kitchen-furniture>1</kitchen-furniture>
        <television>1</television>
        <washing-machine>1</washing-machine>
        <refrigerator>1</refrigerator>
        <rubbish-chute>1</rubbish-chute>
        <heating-supply>1</heating-supply>
        <аir-conditioning>1</аir-conditioning>
        <water-supply>1</water-supply>
        <sewerage-supply>1</sewerage-supply>
        <gas-supply>1</gas-supply>
        <electricity-supply>1</electricity-supply>
        <parking-place>3</parking-place>
        <alarm>1</alarm>
        <sales-agent>
            <name>Алексей</name>
            <phone>8-903-000-00-53</phone>
            <organization>Агентство недвижимости РУССКИЙ ДОМ</organization>
            <url>http://agency.ru/</url>
            <email>rusdom@ya.ru</email>
            <country>Россия</country>
            <locality-name>Москва</locality-name>
            <address>Новая улица</address>
        </sales-agent>
    </offer>
</realty-feed>

Скачать: https://gvanga.com/examples/xml/realty.xml

 

Шаг 2 – Загрузите XML фид на GVANGA.COM

Чтобы осуществить загрузку XML фида Вам необходимо быть зарегистрированным пользователем нашего сайта. Обратите внимание, что сервис XML загрузки объявлений доступен только для организаций. 

После регистрации Вы можете заполнить обращение для загрузки XML фида через форму обратной связи.

Вы также можете отправить ссылку на Ваш XML фид из Личного кабинета – в разделе "XML фиды" - настройка XML загрузки. 

После добавления Вашего XML фида в течение 24 часов будет осуществлена проверка правильности создания файла и предмодерация, затем Ваши объявления начнут проходить модерацию и публиковаться на портале GVANGA.COM.

Обратите внимание, что все загружаемые из XML файла объявления должны соответствовать Правилам размещения объявлений на портале. Не допускается дублирование контактных данных и ссылок на интернет ресурсы в тексте объявления (<description>), а также наличие контактной информации и фотографических водяных знаков в изображениях фида.

Данные из Вашего XML фида будут автоматически обновляться на нашем сайте один раз в день. В Вашем Личном кабинете Вы сможете отслеживать и редактировать опубликованные объявления.

При возникновении вопросов и предложений по XML загрузке объявлений на портале GVANGA.COM, пожалуйста, обращайтесь к нам через форму «Обратная связь» ниже и мы свяжемся с Вами в ближайшее время.

Вы риелтор и у Вас нет своего XML фида, но Вы хотите автоматизировать размещение объявлений на разные интернет-ресурсы? Воспользуйтесь услугой от GVANGA по формированию XML файла экспорта для агентств недвижимости.

 

** Подключение автоматического импорта объявлений является платной услугой, стоимость которой включает тариф за подключение и ежемесячный платеж в период действия услуги (каждый фид оплачивается отдельно).

*** Для агрегаторов и информационных CMS систем действуют специальные платные условия подключения. Стоимость ежемесячного платежа зависит от общего количества активных для публикации объявлений.

Обратная связь

Поля, отмеченные * - обязательные для заполнения