OptionsProfilLiens utiles

Domaza Immobilier

 
API usage: POST request to https://www.domaza.ru/api/properties with post fields:
  • username - login for Domaza ( email )
  • password - password for Domaza
  • xml - whole xml file for import as string
OR
  • id - Client id in Domaza
  • key - API key
  • secret - API secret
  • agency - agency identificator ( for platforms only )
  • xml - whole xml file for import as string
All text must be encoded in UTF-8
If you want to test your file and get response without importing anything use this https://www.domaza.ru/api/properties/test/1 url
The xml must contain root node "properties".
For every property in your database that you wish to import add "property" node.
Updating imported properties is done automatically by field "original_id" when you send new xml data.
If you want to delete a property from Domaza database, include "delete" node with children "original_id" for every property you want to delete.
If you only want to delete properties you can add only the "delete" node or if you only want to import properties you can omit the "delete" node.
Minimal Location information reqirement for importing a property in our system is to have at least one of the following specified:
  • field "dst_id" - District id in our base
  • field "district" - District as string ( must exist in specified city )
  • field "mst_id" - Metrostation in our base
  • field "metrostation" - Metrostation as string ( must exist in specified city )
  • field "postcode" - Postcode as string ( must be valid for a district/microdistrict/community in the specified city )
  • fields "gmap_latitude","gmap_longitude" - Latitude and longitude must be specified and must be in the specified location
If none of the above fields is specified and valid you will recieve an error in the response with key "location" and text "Location ERROR"
If you want to always include all active properties in the feed and all missing to be automatically paused, you can achieve this by one of the following ways:
  • Add attribute init="1" in the parent node ( "properties" )
  • POST to URL https://www.domaza.ru/api/properties/init/1/
Statistic API usage: POST request to https://www.domaza.ru/api/stats with post fields:
  • username - login for Domaza ( email )
  • password - password for Domaza
  • domain - Domaza domain. Example: domaza.ru *(optional)
  • datefrom - Format: Year-month-day - 2024-04-26 *(optional)
  • dateto - Format: Year-month-day - 2024-04-26 *(optional)
OR
  • id - Client id in Domaza
  • key - API key
  • secret - API secret
  • agency - agency identificator ( for platforms only )
  • domain - Domaza domain. Example: domaza.ru *(optional)
  • datefrom - Format: Year-month-day - 2024-04-26 *(optional)
  • dateto - Format: Year-month-day - 2024-04-26 *(optional)
In response you will recieve csv data in the following format (all counters are for last week, if datefrom or dateto are not posted) :
  • Property id in Domaza
  • Property id in source database (original_id)
  • URI for your property on our sites
  • Views counter ( property has been visited )
  • Shows counter ( property has been showed on our sites )
  • Queries counter ( requests have been made for this property )
  • Site redirects counter ( user has gone to your website for this property )
All areas and lengths are in metric system
  • 1 foot = 0.3048 meters
  • 1 square foot = 0.09290304 square meters
XML columns for properties API.
Types help:
string - expects text
int - expects integer
float - expects float with dot for delimiter
date - expects date in format Year-month-day (example: 2024-04-26)
datetime - expects UNIX timestamp (example: 1714164695)
pdf - expects full url to pdf file (example: http://example.com/example.pdf)
array - expects comma delimitted integers from allowed values see info page for ids
localized - container for translations, one per language
images - container for images, one per image
currency - by default price is in EUR, if different currency is passed price will be calculated based on current exchange rate and both will be saved
Column Child Type Required Default Value Min Value / Min Length Max Value / Max Length Max File Size Allowed extension Help Extra Help More Info
original_id   string Yes 1 255 Unique identifier of the property in the source database If records exists it will be overridden
mls_id   string No 1 255 MLS ID Info
refnum   string No 1 255 Identifier visible only for the uploader
country   string No 1 255 Country name
region   string No 1 255 Region name
city   string No 1 255 City name
district   string No 1 255 District name
metrostation   string No 1 255 Metrostation name
cit_id   int Yes City Id in domaza database Locations
dst_id   int No District Id in domaza database Locations
mst_id   int No Metrostation Id in domaza database Locations
distance_to_city   int No 0 255 Distance to city (km)
postcode   string No 1 255 Postal code
street_number   string No 1 255 Street number
gmap_latitude   float No -90 90 Latitude
gmap_longitude   float No -180 180 Longitude
gmap_zoom   int No 0 20 Zoom (Google maps) Info
broker_id   int No Broker for this property - Domaza ID
rent_sale   int Yes Deal type Info
propt_id   int Yes Prop type Info
area   float No Area
area_from   float No Area From (Complex)
area_to   float No Area To (Complex)
area_clear   float No Living area
area_common   float No Common areas
area_parcel   float No Plot
area_basement   float No Basement area
price   float No Price
price_from   float No Price from (Complex)
price_to   float No Price to (Complex)
rent_deposit   float No Deposit for rental
rent_neto   float No Rent net price
rent_max_duration   string No 1 128 Rent max duration
textprice   string No 1 256 Extra price info as text
broker_commision_text   string No 1 256 Extra commision info as text
rooms   int No Total rooms
bedrooms   int No Bedrooms
bathrooms   int No Bathrooms
dateready   date No Completion date
floor   int No Floor
buildingfloors   int No Building Floors
totalapartments   int No Total apatments
agent_comission   float No 0 100 Agent comission percent
notarial_tax   float No Notary fees
additional_tax   float No Additional fee
support_tax   float No Maintenance fee (currency/m2)
support_tax_total   float No Maintenance fee total
urbanization_cost   float No Urbanization cost
state_tax   float No State fee
heating_cost   float No Heating cost
communal_tax   float No Community fee
openview   bool No false Open for viewing
openview_datefrom   date No Open for viewing date from
openview_dateto   date No Open for viewing date to
datepublished   datetime No Date of first upload in UNIX timestamp
datelastedited   datetime No Date of last change in UNIX timestamp
openview_hourfrom   string No 1 255 Open for viewing hour from
openview_hourto   string No 1 255 Open for viewing hour to
ownername   string No 1 255 Owner name
ownerphone   string No 1 255 Owner phone
ownernotes   string No 1 10240 Owner notes
website   string No 1 1024 Property website
video   string No 1 1024 Youtube video - link
mjpegstream   string No 1 1024 Online camera (mjpeg)
view360   string No 1 1024 360 view
content   localized No   Content for different languages  
  lang string Yes       Lang code Info
CodeName
ruRussian
bgBulgarian
enEnglish
plPolish
ukUkrainian
trTurkish
nlDutch
esSpanish
deGerman
mtMaltese
czCzech
daDanish
frFrench
elGreek
huHungarian
gaIrish
itItalian
kyKyrgyz
kzKazakh
ltLithuanian
luLuxembourgish
ptPortuguese
roRomanian
svSwedish
slSlovene
skSlovak
lvLatvian
noNorwegian
viVietnamese
zhChinese
srSerbian
beBelarusian
arArabic
hrCroatian
etEstonian
klGreenlandic
sqAlbanian
fiFinnish
tlTagalog
urUrdu
isIcelandic
mnMongolian
faPersian
heHebrew
mkMacedonian
jaJapanese
koKorean
hyArmenian
bsBosnian
meMontenegrin
  street_text string No   1 255     Street / Popular place Text only
  title string No   1 255     Property Name Text only
  headline string No   1 255     Headline Text only
  description string No   1 500000     Description ( HTML ) Allowed Tags: h1,h2,h3,h4,h5,a,p,br,em,ul,li,i,b
  location_info string No   1 500000     Location Information ( HTML ) Allowed Tags: h1,h2,h3,h4,h5,a,p,br,em,ul,li,i,b
  epc string No   1 500000     Energy Performance Certificates ( HTML ) Allowed Tags: h1,h2,h3,h4,h5,a,p,br,em,ul,li,i,b
  text_features string No   1 500000     Property Features as text
  place_name string No   1 255     Place name Text only
  contact_phone string No   1 255     Contact phone number
  contact_name string No   1 255     Contact first name
  contact_family string No   1 255     Contact family name
  contact_email string No   1 255     Contact email
  available_from string No   1 255     Available from date as text
pdf_presentation   pdf No 20 MB pdf Presentation URL
pdf_floor_plan   pdf No 20 MB pdf Floor Plan URL
pdf_pricelist   pdf No 20 MB pdf Pricelist
image   images No   1 MB jpg Images  
  url string Yes       Image URL
  label string No   1 255     Label
labels   array No Property labels Info
features   array No Property features Info
images_changed   bool No true Flag to tell to download all images again Valid only for updating property
pdfs_changed   bool No true Flag to tell to download pdf files again Valid only for updating property
status   bool No true Show property in searches and personal site
top   bool No false Mark property as top
currency   string No 3 3 Currency code in english 3 symbols Example "EUR" Info
Supported currencies: EUR , USD , RUB , GBP , BGN , PLN , LVL , RON , CZK , TRY , LTL , DKK , CAD , HUF , CNY , INR , KZT , BRL , MXN , NZD , RSD , CHF , TWD , BYR , AED , UAH , QAR , HRK , NOK , AUD , BYN , THB , ILS
hide_on_sites   array No Sites on which to hide this property list of domains seperated by comma Info
Domain
au.domaza.com
cl.domaza.com
cn.domaza.com
co.domaza.com
co.ke.domaza.com
co.nz.domaza.com
co.za.domaza.com
domaza.ae
domaza.al
domaza.at
domaza.be
domaza.bg
domaza.by
domaza.ca
domaza.ch
domaza.cn
domaza.co.il
domaza.co.in
domaza.co.uk
domaza.com
domaza.com.br
domaza.com.cy
domaza.com.tr
domaza.com.ua
domaza.com.vn
domaza.cz
domaza.de
domaza.dk
domaza.ee
domaza.es
domaza.fi
domaza.fr
domaza.gr
domaza.hk
domaza.hr
domaza.hu
domaza.it
domaza.li
domaza.lt
domaza.lu
domaza.lv
domaza.me
domaza.nl
domaza.no
domaza.pl
domaza.pt
domaza.qa
domaza.ro
domaza.rs
domaza.ru
domaza.se
domaza.si
domaza.sk
domaza.tw
domaza.ua
domaza.vn
en.domaza.ae
ga.domaza.com
gl.domaza.com
gq.domaza.com
hk.domaza.com
ie.domaza.com
is.domaza.com
kz.domaza.com
kz.domaza.ru
ml.domaza.com
mn.domaza.com
mt.domaza.com
mx.domaza.com
ng.domaza.com
pe.domaza.com
ph.domaza.com
pk.domaza.com
ug.domaza.com
us.domaza.com
rent_duration_min_type   string No Min Rent duration type Allowed values are days,weeks,months,years
rent_duration_min_value   int No Min Rent duration value see rent_duration_min_type
rent_duration_max_type   string No Max Rent duration type Allowed values are days,weeks,months,years
rent_duration_max_value   int No Max Rent duration type see rent_duration_max_type
proptype_text   string No Prop type as text If propt_id is 0 we will try to use this field
year_built   int No Year built Year of construction
Votre pub ici