Field Reference
Value formats and allowed values used across the feed.
Value formats
| Concept | Format | Examples |
|---|---|---|
| Country | ISO 3166-1 alpha-2 | US, ES, GB, DE |
| Region / state | Name (matched by name, not a code) | Colorado, Arizona, Andalusia |
| Currency | ISO 4217 | EUR, USD, GBP, CHF |
| Language codes | ISO 639-3, comma-separated | eng,fra,deu |
| Booleans | yes / no | yes |
| Living area unit | sqm | sqft | unit="sqm" |
| Land area unit | sqm | sqft | ha | ac | unit="ha" |
| Year | 4-digit | 2021 |
Property types (property_type)
House · Villa · Estate · Country house · Finca · Chalet · Townhouse · Bungalow · Apartment · Penthouse · Condo · Co op · Land · Castle · Chateau · Farm ranch · Private island
Energy ratings (emission_rating, consumption_rating)
emission_rating and consumption_rating both accept the same set of codes:
ABCDEFG·A+B+B-·A1A2A3A4·XNCNI
A–Gare the standard efficiency classes —Abest,Gworst.A+,B+,B-are half-step variants;A1–A4are sub-bands. Send the literal+/-.X,NC,NIare special markers carried over from some national energy certificates (e.g. "not classified" / "not communicated"). Send one only if it appears on the certificate.
Codes are matched case-insensitively. A value outside this list is dropped (the rating is left empty), so send a code exactly as listed.
Price
Every listing needs one of these:
| You send | Works for | How we read it |
|---|---|---|
price | sale and rent | Exactly the number you send. Nothing is multiplied. |
price + rental_period | rent | The number you send, for the period you name: 4000 + month = EUR 4,000 per month. |
rental_price_per_day | rent only | Your daily rate, exactly as sent. Always a price per day. |
price_on_request=yes | sale and rent | "Price on request" instead of a number. |
price and rental_price_per_day need a currency attribute (ISO 4217).
Rental period
rental_period tells us what period the rent price covers. Rent only: we ignore it on sale
listings.
| Value | Also accepted | Period |
|---|---|---|
day | daily | 1 day |
week | weekly | 7 days |
month | monthly | 30 days |
year | yearly, annually | 365 days |
- Values aren't case-sensitive.
- We don't recognize any other value, so we import the price without a rental period.
rental_price_per_dayis always a price per day, whateverrental_periodsays. Send one or the other, not both.- Send the real amount for the period. We no longer multiply a daily rate by 7.
This page lists shared value formats and allowed values. The full field list for each format is on its own page (Real Estate Single/Multi Office, Cars, Watches).