Dubizzle.com Feed Documentation - Version 2
Version 2.1
Dubizzle Feeds 2.0 is a much quicker and leaner way of fetching your listings.
This feed must only contain listings which were updated within the past 24 hours!
The new <status> field tells Dubizzle what it needs to do with the listing (either keep it or remove it).
Dubizzle Feeds doesn't support bulk or group update feature and requires all the listings to be modified idividually in case an update is required.
The following is a list of supported tags and their attributes. Click here to see an example of an XML entry.
status
Type: String
Required: Yes
Possible Values:
deleted - This listing has been deleted
vacant - This listing is still available (an update may have been made)
Notes: If an entry has been removed from your system, you would need to set this value to 'deleted' to have it removed from Dubizzle. If the property is still available but updates were made, set this field to 'vacant'.
Also note that remaining structure of the entry must be valid even though you pass a 'deleted' status. The remaining fields are never used but need to exist in order to comply with our basic XML structure.
Example:<status>vacant</status>
type
Type: String
Required: Yes
Possible Values:
SP - Property for Sale
RP - Property for Rent
Notes: None
subtype
Type: String
Required: Yes
Possible Values:
AP - Apartment / Flat
VH - Villa / House
TH - Townhouse
PH - Penthouse
VC - Villa Compound
RB - Residential Buildings
RF - Residential Floors
RP - Residential Plot (Only for type RP)
CO - Commercial
LA - Land (Only for type SP,
Zoned/Zonedfor)
BU - Multiple Units for Sale (Only for type SP,
Zoned/Zonedfor)
Notes: None
Example:<subtype>AP</subtype>
commercialtype
Type: String
Required: Yes (only if subtype is CO - Commercial)
Possible Values:
RE - Retail
OF - Office
IN - Industrial
SR - Showroom
WH - Warehouse
FA - Factory
CB - Commercial Buildings
CV - Commercial Villa
CF - Commercial Floor
CP - Commercial Plot (Only for type RP)
IL - Industrial Land (Only for type RP)
ST - Staff Accommodation
OC - Other
BU - Multiple Units / Buildings (Only for type RP)
MUL - Mixed Use Land (Only for type RP)
SOP - Shop
Notes: If a subtype of CO is specified but no commercialtype, the listing will not be placed on Dubizzle. Commercial properties must have this additional field (after January 1, 2010). If the listing is residential, the value of this field will be skipped (whether it is empty or contains a value).
Example:<commercialtype>RE</commercialtype>
zoned/zonedfor
Type: String
Required: No
Possible Values:
RD - Residential
CO - Commercial
RE - Retail
MU - Mixed Use
IN - Industrial
Notes: Only used for "Land for Sale"/"Multiple Units for Sale" listings in Property For Sale.
Example:<zonedfor>RD</zonedfor>
refno
Type: String
Required: Yes
Notes: This must be a unique value - usually a property reference ID used throughout your system.
Example:<refno>A123</refno>
title
Type: String
Required: Yes
Notes: This is the posting heading and will be the main link to your posting when browsing or searching. All HTML will be stripped from this field. No of characters should not exceed 100.
Example:<title>Jumeirah Beach Residence - 5bdrm Penthouse</title>
description
Type: String
Required: Yes
Notes: This field should be well written and descriptive. Certain HTML tags will be stripped from this field. Please wrap the contents of this field with a CDATA tag. Refer to
http://en.wikipedia.org/wiki/CDATA for usage instructions. No of characters should not exceed 8000.
Example:<description>Affordable luxury on the sunny coast of Dubai, Jumeirah Beach Residence is one of the city's most affluent growing communities. Popular for it's spacious beachside apartments, the amenities are complimented by the unique lifestyle offered by the Marina Walk. Five-star hospitality, luxury brand retail, vast stretches of pristine beach and world-class leisure clubs surround the residences, all perfectly located on the natural coast of the warm, Arabian Gulf. Not only is JBR home to a multicultural mix of Dubai residents and holidaymakers, it continues to represent one of the strongest investment opportunities in Dubai.</description>
privateamenities
Type: String
Required: No (but highly recommended)
Possible Values:
MR - Maids Room
ST - Study
AC - Central A/C & Heating
BA - Balcony
PG - Private Garden
PP - Private Pool
PY - Private Gym
PJ - Private Jacuzzi
SP - Shared Pool
SS - Shared Spa
SY - Shared Gym
SE - Security
CS - Concierge Service
MS - Maid Service
CP - Covered Parking
BW - Built in Wardrobes
WC - Walk-in Closet
BK - Built in Kitchen Appliances
VW - View of Water
BL - View of Landmark
PA - Pets Allowed
GW - Double Glazed Windows
CC - Day Care Center
EB - Electricity Backup
MC - First Aid Medical Center
EL - Service Elevators
PR - Prayer Room
LR - Laundry Room
BI - Broadband Internet
CT - Satellite/Cable TV
BC - Business Center
IC - Intercom
AT - ATM Facility
KP - Kids Play Area
WR - Reception/Waiting Room
MN - Maintenance Staff
TV - CCTV Security
CN - Cafeteria or Canteen
SK - Shared Kitchen
FD - Facilities for Disabled
SA - Storage Areas
CE - Cleaning Services
BR - Barbeque Area
LB - Lobby in Building
WD - Waste Disposal
Notes:This may be a pipe separated list of amenity codes for residential listings. (ie. ST|BK|VW)
Example:<privateamenities>MR|AC|PA</privateamenities>
commercialamenities
Type: String
Required: No (but highly recommended)
Possible Values:
CR - Conference Room
CP - Covered Parking
AF - Available Furnished
AN - Availabe Networked
SY - Shared Gym
SS - Shared Spa
DB - Dining in Building
RB - Retail in Building
VW - View of Water
VL - View of Landmark
Notes:This may be a pipe separated list of amenity codes for commercial listings. (ie. CR|RB|VW)
Example:<commercialamenities>CR|AF</commercialamenities>
size
Type: Integer
Required: Yes
Notes: This field represents the built up area size
Example:<size>5500</size>
sizeunits
Type: String
Required: No
Possible Values:
SqFt - Square Feet
Sqm - Square meters
Notes: Defaults to Square Feet
Example:<sizeunits>SqFt</sizeunits>
price
Type: Integer/Float
Required: Yes
Notes: This should be the final price with all fees and commission included
Example:<price>9345876.27</price>
rentpriceterm
Type: String
Required: No
Possible Values:
YR - Yearly
MO - Monthly
Notes: This defines the "rental price term" as to whether the rent value(as sent in "price" tag) is annual/monthly. Only used for rental listings and defaults to yearly if not available.
Example:<rentpriceterm>MO</rentpriceterm>
totalclosingfee
Type: Integer/Float
Required: No
Notes: Only used for listings for Sale
Example:<totalclosingfee>10000</totalclosingfee>
annualcommunityfee
Type: Integer/Float
Required: No
Notes: Only used for listings for Sale
Example:<annualcommunityfee>35000</annualcommunityfee>
agencyfee
Type: Integer/Float
Required: No
Notes: Only used for listings for Rent
Example:<agencyfee>5500</agencyfee>
rentispaid
Type: String
Required: No
Possible Values:
YR - Yearly
BY - Bi-Yearly
QU - Quarterly
MO - Monthly
Notes: This is basically the number of cheques that can be given for a rental value. Defaults to "Yearly" if there is no "rentispaid" tag available
Example:<rentispaid>MO</rentispaid>
furnished
Type: Integer
Required: No
Possible Values:
1(Yes) or 0(No), defaults to "No" if there is no "furnished" tag available for a particular listing.
Notes: Only used for Rental listings
Example:<furnished>1</furnished>
bedrooms
Type: String
Required: Only for Villas and Apartments (subtype AP or VH)
Possible Values:
0 for Studio or the numbers 1 through 12 (or more) (0 not valid for Villas - type VH)
Notes: None
Example:<bedrooms>5</bedrooms>
bathrooms
Type: Integer
Required: No
Possible Values:
The numbers 1 through 12 (or more)
Notes: None
Example:<bathrooms>6</bathrooms>
developer
Type: String
Required: No
Notes: The name of the developer (if any) should be used here.
Example:<developer>Nakheel</developer>
readyby
Type: Date
Required: No
Notes: The date the unit is set to be complete. Used only for Properties for Sale. Any number based date format is acceptable:
examples:
2015-01-01 or 01-01-2020
Example:<readyby>2020-12-01</readyby>
lastupdated
Type: Datetime
Required: Yes
Notes: This is the last date/time this entry was updated on your system. We rely solely on you to provide accurate and legitimate timestamps.
Any number based date format is acceptable:
examples:
2015-01-01 15:35:35 or 2020-05-05 7:56:56 am
Example:<lastupdated>2020-11-11 11:20:20</lastupdated>
contactemail
Type: String
Required: No
Notes: This is where email inquiries regarding this listing are sent. If no contact email is passed, the default email tied to your account is used
Example:<contactemail>info@properties.com</contactemail>
contactnumber
Type: String
Required: No
Notes: This should be a valid contact number. We rely solely on you to provide accurate number.
Example:<contactnumber>0501234567</contactnumber>
locationtext
Type: String
Required: Yes
Notes: The name of the area where this listing is located. Dubizzle smart matches locations passed here to areas in our system. (ie. Dubai Marina, Downtown Burj Dubai, Bur Dubai).
DO NOT use building names in this field
If no <geopoint> field is entered, Dubizzle will use the centroid of the polygon specified by the <locationtext>
Example:<locationtext>Jumeirah Beach Residence</locationtext>
permit_number
Type: String
Required: No
Notes: RERA permit numbers (alphanumeric limited to 10 characters) as per the RERA's new Trakheesi system.
Example:<permit_number>2020202121</permit_number>
building
Type: String
Required: No
Notes: The name of the building where this listing is located. Dubizzle smart matches building names passed here to building information in our system.
Refer to this doc
Building Names for all the available building names.
The building information will only be processed for
Apartment listings in sales and rental (subtype 'AP')
Example:<building>Al Shams 4</building>
city
Type: Integer
Required: Yes
Possible Values:
2 - Dubai
3 - Abu Dhabi
11 - Ras al Khaimeh
12 - Sharjah
13 - Fujeirah
14 - Ajman
15 - Umm al Quwain
39 - Al Ain
Notes: The city where the property is located. dubizzle smart matches the city passed here to cities in our system and place it in the matching site. (ie. Dubai, Abu Dhabi etc).
photos
Type: String
Required: No
Notes: A list of URLs containing images/photos for this listing. Multiple photo urls should be seperated by a pipe (|). No of characters for each URL should not exceed 512.
See example.
Example:<photos>http://media.dubizzle.com/images/user_images/2008/09/07/IMAG0042___.jpg|http://media.dubizzle.com/images/user_images/2008/09/09/tmp_sp_9108844.jpg|http://media.dubizzle.com/images/user_images/2008/09/09/tmp_sp_9108804__.jpg</photos>
view360
Type: String
Required: No
Notes: A URL containing a link to a 360 tour hosted on one of the approved providers. For more information please visit
here.
Example:<view360>https://matterport.com/industries/gallery/pro2-cap-adriano-villa</view360>
video_url
Type: String
Required: No
Notes: A URL containing a link to a video hosted on YouTube. For more information please visit
here.
Example:<video_url>https://youtu.be/_Tk5Fni3LkM</video_url>
geopoint
Type: Location Float
Required: No
Notes: The latitude and longitude of the property. i.e. (25.046725356821184,55.24578094482422).
If this value is being passed, and it's contained in the polygon of the <locationtext>, Dubizzle ignores the locationtext's geopoint and uses this as the value as it is more accurate. If not, it uses the geopoint of the <locationtext>
Example:<geopoint>55.24578094482422,25.046725356821184</geopoint>
freehold
Type: Integer
Required: No
Possible Values:
1(Yes) or 0(No), defaults to "No" if there is no "freehold" tag available for a particular listing.
Notes: Only used for "Land for Sale" listings in Property For Sale.
Example:<freehold>1</freehold>
For a more detailed and full example: Click here.