Feed Export Annunci
This document describes the interchange XML feed format used by immobiliare.it for partner
use
The feed is generated daily and contains all the active ads in immobiliare.it at the time
of generation. If an ad is not present in the feed, it is intended to be deleted. The encoding of
the feed is UTF-8.
You can download the XSD schema definition from: schema
You can browse the full list of typologies at (values are in italian only): [html] [xml]
You can browse the full list of business types at : [html]
A redirect service implementation is required in order to find exported listings on your website.
Leads can be sent through proxy-mail service. Docs available here: [proxy-mail]
The following translations for this page are available: it es
You may find a sample XML feed at the following url: feed
Root node
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| metadata | publisher | | 1 | Additional metadata describing the feed |
| properties | properties | | | The list of published ads |
Additional metadata describing the feed
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| name | string | | | Feed source (defaults to immobiliare.it) |
| version | string | | 1 | Schema version |
| site | string | | | Source base-url for ads in the feed |
| email | emailType | | | Technical contact email |
| phone | string | | | Technical contact phone |
| build-date | boundedDateType | | | Feed generation datetime in RFC-3339 / ISO-8601 format |
The following nodes and attributes are allowed in this section
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| price | priceType | required | 1 | The sale / rental price |
| @ | type | saleOrRent | required | 1 | For sale / for rent |
| @ | auction | boolean | | 1 | Property for auction |
| @ | for-revenue | boolean | | 1 | Property for real estate investment |
| @ | on-redeem | boolean | | 1 | On redeem rental property |
| @ | ownership | ownershipType | | 1 | Title of ownership and possession |
Type: string
The primary typology of the property
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | id | string | | 1 | The property typology ID. See table for values. |
Other property typologies that apply
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| type | buildingType | required | 1 | The primary typology of the property |
| status | status | | 1 | Conservation status |
| building-class | building-class | | 1 | Property class |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| country-code | country-code | required | 1 | ISO 3166-alpha-2 country code of the property |
| administrative-area | string | | | Location of the property: administrative-level-1 |
| sub-administrative-area | sub-administrative-area | | | Location of the property: administrative-level-2 |
| city | city | required | 1 | Location of the property (city) |
| locality | locality | | | Location of the property: neighborhood or district |
Type: string
Location of the property: administrative-level-2
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | code | string | | 1 | The administrative-level-2 locality of the property. E.g., the 2-digit province-id in Italy |
Type: string
Location of the property: city
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | code | string | | 1 | City name or equivalent unambiguous classification (e.g. ISTAT code in Italy) |
Detailed location of the property
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| neighbourhood | string | | 1 | Neighborhood or district |
| thoroughfare | thoroughfare | | 1 | The street address of the property |
| postal-code | string | | 1 | ZIP code |
| latitude | double | | 1 | Coordinates: latitude value |
| longitude | double | | 1 | Coordinates: longitude value |
| @ | map | map-type | | 1 | Map visualization mode |
Type: string
The street address of the property
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | display | boolean | required | 1 | Whether to publish or not the street address of the property |
Type: long
Surface area of the property
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | unit | | | 1 | Measurement unit used for surface area. This values is a fixed 'm2'. |
Type: long
Surface area of the real estate
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | unit | | | 1 | Measurement unit used for surface area. This values is a fixed 'm2'. |
Type: long
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | currency | string | required | 1 | Currency. This value is a fixed 'EUR' |
| @ | display | boolean | required | 1 | Whether to publish or not the sell or rent price of the property |
Type: string
ISO 639-1 language code
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | language | langcode | | 1 | ISO 639-1 codes of accepted languages |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| title | string | | 1 | Ad title |
| content | string | required | 1 | Ad description |
| @ | language | langcode | required | 1 | ISO 639-1 code of the language used in the description |
Type: int
Type and number of garages
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | type | string | | 1 |
The following values are accepted:
No
No garage
Box
Garage
PostoAuto
Parking space
|
Floor number and type
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | type | string | | 1 |
The following values are accepted:
Intermedio
Middle floor
Interrato
Basement
Controterra
Cement floor
Seminterrato
Semi-basement
PianoTerra
Ground floor
Rialzato
Raised ground floor
PianoNobile
Noble floor
Multipiano
Multi-storey
Ultimo
Top floor
Attico
Actic
Edificio
Entire building
|
Energy class
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| energy-performance | energy-performance | | no limit | Energy performance index |
| energy-season | energy-season | | no limit | Represents the efficiency of the air conditioning/heating system, according to the season of the year (summer / winter). Complements the APE classification |
| @ | zero | boolean | | 1 | Net zero-energy building |
| @ | scale | energy-scale | | 1 | The type of Energy Efficiency Directive in use. The APE type refers EU directive 2010/31/UE, IPE refers to EU directive 92/75/EC |
| @ | value | string | | 1 | Energy efficiency class |
| @ | certified | boolean | | 1 | Whether the building has been certified or is still awaiting certification |
Type: double
Energy performance index
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | unit | string | required | 1 |
The following values are accepted:
kWh/m2anno
kWh/m2/year
kWh/m3anno
kWh/m3/year
|
| @ | type | string | required | 1 | Whether the index derives from renewable energy (ren) or not (nren) |
Represents the efficiency of the air conditioning/heating system, according to the season of the year (summer / winter). Complements the APE classification
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | season | string | | 1 |
The following values are accepted:
summer
winter
|
| @ | level | string | | 1 |
The following values are accepted:
low
normal
high
|
Type: double
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | currency | string | required | 1 | Currency. This value is a fixed 'EUR' |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| rooms | int | | | Number of rooms |
| size | sizeType | | 1 | Surface area of the property |
| descriptions | descriptions | | 1 | The list of announcement descriptions (one for each language) |
| energy-class | classEnergy | required | | Energy class |
The list of announcement descriptions (one for each language)
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| description | description | required | no limit | |
The list of published ads
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| property | property | | no limit | A published ad |
Description of the real estate agency that publishes the ads
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| name | string | | 1 | Name of the real estate agency |
| email | pmailType | required | 1 | Proxy mail of the real estate agency, to be used exclusively for commercial communications intended for the agency and NOT for sending leads. |
| phone | string | | 1 | The real estate agency's landline number |
| phone2 | string | | 1 | |
| mobile-phone | string | | 1 | |
| fax | string | | 1 | The company fax number |
| description | langtxt | | | Company description text |
| location | locationStructure | | 1 | The real estate agency's geographical references |
| logo | string | | 1 | The real estate agency's logo download url |
| target-account | string | | 1 | The real estate agency's unique-id used in the interchange feeds |
| extra | agent-extra | | 1 | Additional data about the real estate agency |
| @ | id | long | required | 1 | Additional data about the agency |
| @ | date-updated | dateTime | | 1 | Agency last update time |
| @ | group | string | | 1 | |
| @ | watermark | boolean | | 1 | |
Ad description
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| internal-reference | string | required | 1 | The internal reference code used by the real estate agency to identify the ad |
| published-on | boundedDateType | | 1 | The publication date of the ad |
| date-updated | boundedDateType | | 1 | The last modification date of the ad |
| agent | agent | required | 1 | The real estate agency owner of the ad |
| location | locationStructure | required | 1 | The geographical references of the ad |
| pictures | pictures | | 1 | The image gallery of the ad |
| videos | videos | | 1 | The video gallery of the ad |
| @ | ID | long | required | 1 | The unique-id of the ad |
| transactions | transactions | | 1 | Type of conctract |
| building | building | required | 1 | Other property typologies that apply |
| features | features-property | required | 1 | Ad details |
| extra-features | extra-features | | 1 | Additional details |
| documents | documents | | 1 | Attachments |
| blueprints | blueprints | | 1 | Floor plans |
| extended | extended | | 1 | |
| site-url | anyURI | | 1 | Link to the ad listing on immobiliare.it |
| contact-email | pmailType | | 1 | Proxy mail to be used for lead forwarding |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| original-email-hash | original-email-hash | | 1 | Deprecated |
| code | string | | 1 | Internal reference code |
| original-email | emailType | | 1 | Deprecated |
Type: string
Deprecated
The following nodes and attributes are allowed in this section
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| blueprint | picture | | no limit | Link to a floor plan |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| bedrooms | int | | | Number of bedrooms |
| bathrooms | int | | | Number of bathrooms |
| garage | box | | | Description and number of garages |
| kitchen | kitchen | | | Kitchen description |
| garden | garden | | | Garden description |
| terrace | boolean | | | Has one or more terraces |
| balcony | boolean | | | Has one or more balconies |
| elevator | boolean | | | Elevator |
| floor | floor | | | Floor number and description |
| num-floors | int | | | Number of floors |
| available-now | boolean | | | Whether the property is immediately available or not |
| virtual-tour | string | | | Virtual tour gallery url |
| rent-contract | rental | | | Terms of the rental contract |
| additional-costs | additionalCostsType | | | |
| additional-heating-costs | additionalCostsType | | | |
| furniture | furniture | | | Furniture |
| security-alarm | boolean | | | Whether the building is equipped with an alarm system or not |
| reception | boolean | | | Wheter the property has a reception or concierge or not |
| net | boolean | | | Wheter the property is equipped with network wiring or not |
| external-area | landSizeType | | | External areas |
| build-year | year | | | Year of construction |
| doc-specification | string | | | |
| doc-description | string | | | |
| free-conditions | free-conditions | | | Property availability constraints |
| available-date | boundedDateType | | | Date of availability of the property |
| minimum-stay | int | | | Minumum rent period, in months |
| bills-included | | | 1 | |
| costs | | | 1 | |
| flatmate | | | 1 | |
| sleeping-accommodation | int | | 1 | |
| ambience | ambience | | | Characteristics related to air conditioning and heating |
| luxury | boolean | | | |
Type: string
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | free | boolean | | 1 | |
Characteristics related to air conditioning and heating
The following nodes and attributes are allowed in this section
Heating system
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| system | string | | |
The following values are accepted:
a radiatori
Radiators
a pavimento
Underfloor heating
ad aria
Air heating
a stufa
Stove
|
| source | heating-source | | | Heating fuel |
| @ | type | heat | | 1 | Heating system |
Air conditioning
The following nodes and attributes are allowed in this section
Video gallery
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| video | video | required | 5 | Link to the video |
Type: string
Link to the video
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | type | string | | 1 |
The following values are accepted:
local
remote
|
Attachments
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| document | document | required | no limit | Attachment description |
Type: string
Attachment description
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | position | int | | 1 | Item order |
| @ | mimetype | string | | 1 | MIME-type of the attachment |
| @ | url | anyURI | | 1 | Download url |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| picture | picture | required | no limit | Image caption |
Type: string
Image caption
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| @ | id | long | | 1 | |
| @ | position | int | | 1 | Item order |
| @ | url | string | required | 1 | Download url |
| @ | etag | string | | 1 | image etag |
| @ | thumb-s | string | | 1 | Download 'small' thumb url |
| @ | thumb-m | string | | 1 | Download 'medium' thumb url |
| @ | thumb-xl | string | | 1 | Download 'extra large' thumb url |
| @ | cdn-template | string | | 1 | Cdn template path |
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| amount-parking | int | | 1 | |
| amount-terrace | int | | 1 | |
| amount-balcony | int | | 1 | |
| inner-exposition | boolean | | 1 | |
| outer-exposition | boolean | | 1 | |
| entrance | boolean | | 1 | |
| closet | boolean | | 1 | |
| basement | boolean | | 1 | |
| penthouse | boolean | | 1 | |
| tavern | boolean | | 1 | |
| fireplace | boolean | | 1 | |
| security-door | boolean | | 1 | |
| tub | boolean | | 1 | |
| security-alarm | boolean | | 1 | |
| swimming-pool | boolean | | 1 | |
| tennis | boolean | | 1 | |
| electric-gate | boolean | | 1 | |
| optical-fiber | boolean | | 1 | |
| concierge | boolean | | 1 | |
| video-intercom | boolean | | 1 | |
| external-frames | external-frames | | 1 | |
| tv | tv | | 1 | |
| registry | registry | | 1 | |
| sharable | boolean | | 1 | |
| certified | boolean | | 1 | |
| building-site-status | string | | 1 | |
| ranking | int | | 1 | |
| visibility | advert-visibility | | 1 | |
The following nodes and attributes are allowed in this section
The following nodes and attributes are allowed in this section
The following nodes and attributes are allowed in this section
| name | type | | max | description |
| income | | | | |
| @ | class | string | | 1 |
The following values are accepted:
A/1
A/2
A/3
A/4
A/5
A/6
A/7
A/8
A/9
A/10
A/11
B/1
B/2
B/3
B/4
B/5
B/6
B/7
B/8
C/1
C/2
C/3
C/4
C/5
C/6
C/7
D/1
D/2
D/3
D/4
D/5
D/6
D/7
D/8
D/9
D/10
D/11
D/12
E/1
E/2
E/3
E/4
E/5
E/6
E/7
E/8
E/9
F/1
F/2
F/3
F/4
F/5
F/6
T
|
Definitions and types used in the schema definition
A string value (defaults to null)
An integer value (defaults to null)
Type: dateTime. A lower bound 2000-12-31T00:00:00is expected for this value
Must respect the pattern[^@]+@pmail\.ekbl\.net
Must respect the pattern[^@]+@[^\.]+\..+
For sale / for rent
Must respect the patternsale|rent
Title of ownership and possession
The following values are accepted:
intera proprietà
Entire estate
nuda proprietà
Bare ownership
parziale proprietà
Partial ownership
usufrutto
Usufruct
multiproprietà
Timeshare
diritto di superficie
Landlease or leasehold
Year of construction
Type: int. A lower bound 1000An upper bound 2050is expected for this value
Conservation status
The following values are accepted:
in costruzione
Under construction
nuovo
New
abitabile
Sufficient condition
ottimo
Very good condition
buono
Good condition
ristrutturato
Renovated
da ristrutturare
To be restructured
Property class
The following values are accepted:
di lusso
Luxury
signorile
Stately or high-end
media
Average
economica
Economic
ISO 3166-alpha-2 country code of the property
Must respect the pattern[a-zA-Z]{2}
Map visualization mode
Must respect the patternexact|near|no
Must respect the patternm2
ISO 639-1 codes of accepted languages
The following values are accepted:
it
en
de
fr
es
pt
ru
gr
el
Kitchen type
The following values are accepted:
abitabile
Eat-in-kitchen
semi abitabile
Kitchen/diner
cucinotto
Kitchenette
angolo cottura
Kitchen nook
a vista
Open kitchen
Heating system
The following values are accepted:
Assente
n/a
Autonomo
Autonomous
Centralizzato
Central unit
Garden
The following values are accepted:
Privato
Private
Comune
Communal
Nessuno
n/a
Entrambi
Both
Terms of the rental contract
The following values are accepted:
3+2
4+4
6+6
9+9
Transitorio
Temporary
Concordato
Regulated tenancy / Controlled rent
Libero
Agreed upon
Studenti
Student lease
Furniture
The following values are accepted:
Arredato
Furnished
Non Arredato
Unfurnished
Parzialmente Arredato
Partially furnished
Solo Cucina Arredata
Furnished kitchen only
The type of Energy Efficiency Directive in use. The APE type refers EU directive 2010/31/UE, IPE refers to EU directive 92/75/EC
Must respect the patternIPE|APE
The following values are accepted:
md5
Heating fuel
The following values are accepted:
gas
Gas
metano
Methane
gpl
Lpg
gasolio
Diesel
pellet
Pellet
legna
Wood
solare
Solar
fotovoltaico
PV
teleriscaldamento
District healing
pompa di calore
Heating pump
elettrica
Electric
Air conditioning type
The following values are accepted:
freddo
Cold conditioning
caldo
Hot conditioning
freddo/caldo
Hot and cold conditioning
Air conditioning system
The following values are accepted:
autonomo
Autonomous
centralizzato
Central unit
predisposizione impianto
System predisposition
assente
No air conditioning
The following values are accepted:
free
premium
extra
The following values are accepted:
nd
centralized
private
satellite
The following values are accepted:
0
1
2
3
The following values are accepted:
nd
glass/wood
glass/metal
double glass/wood
double glass/metal
triple glass/wood
triple glass/metal
glass/pvc
double glass/pvc
triple glass/pvc
The following values are accepted:
0
1
2
3
4
5
6
7
8
9
Must respect the pattern[a-zA-Z]{3}
Must respect the patternDoesntMatter|Male|Female