Skip to main content

Field Reference

Value formats and allowed values used across the feed.

Value formats

ConceptFormatExamples
CountryISO 3166-1 alpha-2US, ES, GB, DE
Region / stateName (matched by name, not a code)Colorado, Arizona, Andalusia
CurrencyISO 4217EUR, USD, GBP, CHF
Language codesISO 639-3, comma-separatedeng,fra,deu
Booleansyes / noyes
Living area unitsqm | sqftunit="sqm"
Land area unitsqm | sqft | ha | acunit="ha"
Year4-digit2021

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:

A B C D E F G · A+ B+ B- · A1 A2 A3 A4 · X NC NI

  • AG are the standard efficiency classes — A best, G worst.
  • A+, B+, B- are half-step variants; A1A4 are sub-bands. Send the literal + / -.
  • X, NC, NI are 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

  • For a sale, send a price with a currency attribute (ISO 4217).
  • For a rental (type=rent), send rental_price_per_day with a currency attribute instead.
  • Or set price_on_request=yes — the price is then hidden on the public listing.

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).