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 three fields:
| You send | Works for | What the listing shows |
|---|---|---|
price | sale and rent | Exactly the number you send — nothing is multiplied. |
rental_price_per_day | rent only | Your daily rate × 7, as a weekly price: 350 → EUR 2,450. |
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).
Renting out per day? Send rental_price_per_day with one day's rate — JamesEdition does the
× 7. Don't multiply it yourself, or the shown price ends up 7 times too high. If you price your
rentals any other way, send that number in price — it is shown as-is.
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).