The import of real estate
The link (URL) to your xml FEED Biksiko or Kyero, Yandex, Avito
Questions and answers:
1. What will I get by exporting properties from my site?
This will speed up the process of publishing your properties on our website. There will be no need to add items manually any longer, they will be exported from your site automatically after clicking on the button Update Import. It will save you a lot of time.
2. How do I install FEED?
At the bottom there is an instruction explaining how to import to our portal.
3. I do not have a programmer, what do I do, as I do not understand this?
In this case you need to submit your application, and our programmers will contact you.
4. We have questions about importing to your site, where should we address them?
5. I have my own XML, but it is not suitable to Biksiko what do I do?
Send us an email and specify the link to your XML feed, we will try to help you.
Description of feed format
The feed should be written in the XML markup language. All supported marking elements are described below.
Document title
XMLdocument must start (with a null character of the first line) of the standard XMLheader.
<?xml version="1.0" encoding="utf-8"?>
<!--Root element-->
<realty_feed xmlns=" http://biksiko.com/realty/feed">
<generation_date>2010-10-05T16:36:00+04:00</generation_date>
<offer>
...
</offer>
...
</realty_feed>
The root element of the XML feed realty_feed must contain a generation_date indicating the feed creation and elements offer, en each of which must be places the information of an ad (a property). The attribute xmlns = "http://biksiko.com/realty/feed" is needed to specify a namespace in XML.
|
generation_date |
The date and time must be specified in the format YYYY-MM-DDTHH:mm:ss+00:00, where YYYY — year; MM — month; DD — day; HH — hour; mm — minute; ss — second; +00:00 — time zone. Example: 2015-06-04T10:00:00+02:00 |
General information about the ad
The offer element has a required attribute internal_id , which must be unique for each ad. This attribute can be filled, for example, with the ID of your ad in your database.
<offer internal_id=“2”>
…
Items marked «Strictly limited value» , should contain only values of the given options. Using other values results in an error while processing the feed. The items marked with «*» - obligatory
The categories of objects
, used in the Biksiko site:
- «apartment» - Apartment.
- «house»- House.
- «ground_floor» - Ground floor apartment.
- «duplex» - Duplex.
- «studio» - Studio.
- «top_floor» - Top floor apartment.
- «plot» - Plot.
- «garage» - Garage.
- «dacha» - Cottage.
- «realty_office» - Office.
- «business_premise» - Business premise.
|
Elements |
Description |
|
|
creation_date* |
Ad creation date (in format YYYY-MM-DDTHH:mm:ss+00:00). |
|
|
last_update_date* |
Last update date (in format YYYY-MM-DDTHH:mm:ss+00:00). |
|
|
type* |
Type of transaction Strictly limited value:
|
|
|
category* |
Object category («apartment», «house», «ground_floor», «duplex», «studio», «top_floor», «plot», «garage», «dacha», «realty_office», «business_premise») |
|
|
url |
Link to the ad in your website |
|
|
sku* |
Property reference. Required field. If not specified, it uses the value of the attribute «internal_id» |
|
|
image* |
Link to the photo on the Internet. At least one photo, up to 4 photos, in format jpeg, jpg |
|
|
description* |
Description of the property |
|
|
location* |
Set of elements that describe the object's location. |
|
|
- country* |
The country where the object is located. Strictly limited value:
|
|
|
- region* |
Region of the indicated country |
|
|
- city* |
City of the indicated region |
|
|
- address* |
Street and house number. |
|
|
- coord |
Set of elements that describe the object's location by coordinates on the map. If the coordinates are not indicated, the ad will not be shown on the map. |
|
|
- - lat |
latitude |
|
|
- - lng |
longitude |
|
Information about the object for SALE
|
Element |
Description |
Category |
|
price* |
Set of elements describing the price of the object. |
|
|
-currency* |
The currency in which the object price is listed. Strictly limited value:
|
|
|
-value* |
Price |
|
|
-discount |
Discount if applicable |
|
|
mortgage |
Mortgage. Mortgage interest, only the figure |
|
|
from_bank |
Properties of the bank. If the property is sold by the bank, specify "1" |
|
|
type_construction* |
Construction type ONLY for REAL ESTATE SALE Strictly limited value:
|
All, except «plot» |
Information about the object for RENT
The rental price must be specified by indicating an option, "per day", "per week", "per month"
|
Element |
Description |
Region |
Category |
|
price* |
Set of elements describing the price of the object. |
|
|
|
-currency* |
|
|
|
|
-per_day |
Rental price for a day |
|
|
|
-per_week |
Rental price for a week |
|
|
|
-per_month |
Rental price for a month. Specify the number |
|
|
|
min_stay |
Minimum stay in days. Specify the number |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor», «garage», «dacha», «realty_office», «business_premise» |
|
max_quest* |
Maximum number of people |
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
count_beds |
Number of beds |
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
pet |
If pets admitted, specify "1" |
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
checkin |
Time of check-in Strictly limited value:
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «top_floor» |
|
checkout |
Time of check-out Strictly limited value:
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «top_floor» |
General characteristics of the property
|
Element |
Description |
Region |
Category |
|
status |
Set of elements describing the state property listings Strictly limited value: «publish», «trash» |
|
|
|
built_year* |
Set of elements describing the year of construction of the object. If the building is still under construction, indicate the year and month of the end of construction |
|
|
|
- year* |
Year, 4 digits. |
|
|
|
- month* |
Month, ordinal number, from 1 to 12. |
|
|
|
count_room* |
Number of rooms Strictly limited value: «1», «2», «3», «4», «5», «6», «7», «8» and «9», where «9» means more than 8 |
|
|
|
count_bath* |
Number of bathrooms Strictly limited value: «1», «2», «3», «4», «5», «6» and «7», where «7» means more than 6 |
|
|
|
total_area* |
Total area. Specify the number (in square meters) |
|
|
|
floor_area* |
Floor area. Specify the number (in square meters) |
|
|
|
plot_area |
The plot. Specify the number of units – m2 (square meters). |
|
This field is mandatory for the following categories: Home, Parcel. |
|
floor |
Floor. Specify the number. |
|
|
|
num_storeys |
Number of floors. Specify the number. |
|
|
|
realty_state* |
Property condition. Strictly limited value:
|
|
|
|
type_object |
Type of the object. Strictly limited value for office::
trictly limited values for business premise:
|
Ukraine, Russia, Kazakhstan |
«office», «business_premise» |
|
type_building |
Type of construction. Strictly limited value:
|
Ukraine, Russia, Kazakhstan |
«apartment», «house», «dacha», «office», «business_premise» |
|
count_levels |
Set of elements describing the number of levels (floors) of the object. |
Spain, Ukraine, Russia, Kazakhstan |
«house», «dacha» |
|
- value |
Number of levels (floors). Strictly limited value:
|
|
«house», «dacha» |
|
- basement |
If there is no basement, specify "1" |
|
«house», «dacha» |
|
elevator |
Elevator Strictly limited value:
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «studio», «top_floor» |
|
proximity_sea |
Set of elements describing the proximity of objects to the sea. |
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
- value |
Distance. Specify the number |
|
|
|
- units |
Units Strictly limited value (in Latin letters):
|
|
|
|
pool |
Pool. Strictly limited value:
|
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
parking |
Parking place. Strictly limited value:
|
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
garage |
Garage Strictly limited value:
|
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
garden |
Garden. Strictly limited value:
|
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
balcony |
Balcony, or balconies Strictly limited value:
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor», «dacha», «office», «business_premise» |
|
terrace |
Terrace, or terraces. Strictly limited value:
|
Spain |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor» |
|
house_appliances |
Home appliances. Strictly limited value:
To specify multiple white goods it is sufficient to list the values separating them by commas. |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
furniture |
Furniture. Strictly limited value:
To specify multiple units of furniture it is sufficient to list the values separating them by commas. |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
internet |
Internet. Strictly limited value:
To specify various types of connection it is sufficient to list the values separating them by commas. |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
telephone |
Telephone. Strictly limited value
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
tv |
Television Strictly limited value:
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
heated_water |
Heating of water Strictly limited value:
To specify multiple options is sufficient to list the values separating them by commas, except «1» |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
heating |
Heating Strictly limited value:
To specify multiple options is sufficient to list the values separating them by commas, except «1» |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
air |
Air conditioning Strictly limited value:
|
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
|
security |
Security Strictly limited value:
To specify multiple options is sufficient to list the values separating them by commas |
Spain, Ukraine, Russia, Kazakhstan |
«apartment», «house», «ground_floor», «duplex», «studio», «top_floor»,«dacha», «office», «business_premise» |
Example XML :
<?xml version="1.0" encoding="UTF-8"?>
<realty_feed xmlns="http://biksiko.com/realty/feed">
<generation_date>2010-12-12T10:00:00+02:00</generation_date>
<offer internal_id="1">
<creation_date>2015-03-04T09:00:00+01:00</creation_date>
<last_update_date>2015-03-04T10:00:00+01:00</last_update_date>
<type>sale</type>
<category>apartment</category>
<sku>apartment</sku>
<type_construction>1</type_construction>
<url>http://biksiko.com</url>
<location>
<country>Украина</country>
<region>Днепропетровская обл.</region>
<city>Кривой рог</city>
<address>ул. Ленина, д.1</address>
<coord>
<lat>10</lat>
<lng>10</lng>
</coord>
</location>
<price>
<value>230000</value>
<discount>220000</discount>
<currency>EUR</currency>
</price>
<count_room>2</count_room>
<count_bath>2</count_bath>
<total_area>80</total_area>
<type_object>1</type_object>
<type_building>1</type_building>
<built_year>
<year>2010</year>
<month>1</month>
</built_year>
<realty_state>1</realty_state>
<energy_class>1</energy_class>
<elevator>1</elevator>
<house_appliances>1</house_appliances>
<furniture>2,3</furniture>
<internet>2,3</internet>
<telephone>1</telephone>
<tv>1</tv>
<heated_water>2,3</heated_water>
<heating>2,3</heating>
<image>http://biksiko.com/themes/biksiko/images/logo.png</image>
<description>Description</description>
</offer>
</realty_feed>
