Jump to: OpenImmo · RESO Data Dictionary · Kyero XML · WordPress themes · Amenities
OpenImmo (XML, Germany/Europe)
OpenImmo 1.2.x is XML shipped as a ZIP over FTP. We accept the file as it is; this is how its fields land in REES.
| Their field | REES | Notes |
|---|---|---|
verwaltung_techn/objektnr_extern | id | Stable per agency; openimmo_obid is the cross-system id |
verwaltung_techn/aktion @aktionart | status | DELETE → withdrawn (keep the record, do not drop it) |
objektkategorie/vermarktungsart | operation | KAUF → sale; MIETE_PACHT → rent_long |
objektkategorie/objektart | property_type | wohnung → apartment; haus → house/villa; grundstueck → land |
freitexte/objekttitel | title | OpenImmo has one language per file; REES keeps them together |
freitexte/objektbeschreibung | description | |
preise/kaufpreis, preise/kaltmiete | price.amountprice.basis | basis total (sale) or per_month (rent) |
preise/waehrung @iso_waehrung | price.currency | |
preise/hausgeld | costs.hoa | basis per_month |
flaechen/wohnflaeche | area.built | unit m2 |
flaechen/nutzflaeche | area.usable | |
flaechen/grundstuecksflaeche | area.plot | |
flaechen/anzahl_zimmer | rooms.total | |
flaechen/anzahl_schlafzimmer | rooms.bedrooms | |
flaechen/anzahl_badezimmer | rooms.bathrooms | |
geo/land @iso_land | location.country | Alpha-3 (DOM) → alpha-2 (DO) |
geo/ort, geo/plz, geo/strasse | location.citylocation.postal_codelocation.address | |
geo/etage, geo/anzahl_etagen | building.floorbuilding.floors_total | |
geo/geokoordinaten | location.geo.latlocation.geo.lng | Add precision; OpenImmo has none |
zustand_angaben/baujahr | delivery.year_built | |
zustand_angaben/zustand | building.condition | |
zustand_angaben/energiepass | energy | epart, energieverbrauchkennwert, wertklasse, gueltig_bis |
ausstattung/* | features | See the amenity table below |
anhaenge/anhang/daten/pfad | media[].url | Files from the ZIP are published at URLs instead |
kontaktperson | agent |
RESO Data Dictionary (North America)
Mostly one-to-one. The important difference is rights: MLS data under IDX rules is not republishable by a portal, and REES says so explicitly.
| Their field | REES | Notes |
|---|---|---|
ListingKey | id | |
StandardStatus | status | Active → active; Pending → reserved; Closed → sold; Withdrawn/Canceled/Expired → withdrawn |
PropertyType / PropertySubType | operationproperty_type | Residential Lease → rent_long |
ListPrice | price.amount | Currency from the market; RESO assumes one |
LivingArea + LivingAreaUnits | area.built | Square Feet → ft2 |
LotSizeArea + LotSizeUnits | area.plot | Acres → acre |
BedroomsTotal, BathroomsTotalInteger | rooms.bedroomsrooms.bathrooms | |
Latitude, Longitude | location.geo.latlocation.geo.lng | precision exact unless the MLS masks it |
City, StateOrProvince, Country, PostalCode | location.citylocation.regionlocation.countrylocation.postal_code | |
PublicRemarks | description | |
AssociationFee + AssociationFeeFrequency | costs.hoa | Monthly → per_month; Annually → per_year |
YearBuilt | delivery.year_built | |
StoriesTotal, EntryLevel | building.floors_totalbuilding.floor | |
ConstructionMaterials, Roof | building.constructionbuilding.roof | |
ModificationTimestamp | updated_at | |
ListOfficeName | listing_office.name | |
ListAgentFullName, ListAgentEmail | agent | |
Media[].MediaURL, Order | media[].urlmedia[].order | |
Furnished, PetsAllowed, LeaseTerm | rental_terms.furnishedrental_terms.petsrental_terms.min_term_months | |
GreenBuildingVerificationType | energy.scheme | |
View, PoolFeatures, AssociationAmenities… | features | See the amenity table below |
(IDX participation rules) | license.use | "idx-personal-use", unless the MLS grants portal display rights in writing |
Kyero XML (Spain, Portugal, Caribbean agencies)
Common among European agencies selling abroad. Very close in spirit; REES adds units, basis and provenance.
| Their field | REES | Notes |
|---|---|---|
id / ref | id | |
date | updated_at | |
price + currency | price.amountprice.currency | |
price_freq (sale / month / week) | operationprice.basis | sale → total; month → per_month; week → per_week |
new_build | delivery.status | 1 → under_construction or off_plan: ask the publisher |
type | property_type | |
town, province, country | location.citylocation.regionlocation.country | Kyero country is a name; convert to ISO |
location/latitude, longitude | location.geo.latlocation.geo.lng | |
beds, baths | rooms.bedroomsrooms.bathrooms | |
surface_area/built, surface_area/plot | area.builtarea.plot | Kyero implies m²; REES states it |
energy_rating/consumption | energy.rating | |
desc/<lang> | description | Same shape |
pool, features/feature | features | Free text → our vocabulary where it matches |
images/image/url | media[].url | |
url/<lang> | url | The canonical-language page |
WordPress themes (schema.org JSON-LD)
What we read today when an agency has no feed. It works, with the corrections below — each one found on a live site.
| Their field | REES | Notes |
|---|---|---|
offers.price + priceCurrency | price.amountprice.currency | Check the currency: themes default to USD |
offers.seller (RealEstateAgent) | agent | |
geo.latitude / longitude | location.geo | Often the theme default — Houzez ships 25.68654,-80.431345 (Miami). Omit rather than send it. |
floorSize.unitText | area.built.unit | Themes mislabel m² as SQFT; trust the spec table on the page |
@type LandParcel | property_type | → land |
Price postfix "/m2" | price.basis | Usually decoration on the total, not a per-m² price; check against the area |
/es/, /fr/, /de/ page copies | titledescription | One listing, many languages — not many listings |
Amenities
The 132 amenities with a direct equivalent. These are hints for importers: MLS lookup values vary, so check yours.
| REES | RESO | OpenImmo <ausstattung> |
|---|---|---|
ocean_view | View: Ocean | — |
partial_ocean_view | View: Ocean | — |
golf_view | View: Golf Course | — |
mountain_view | View: Mountain(s) | — |
city_view | View: City | — |
lake_view | View: Lake | — |
river_view | View: River | — |
marina_view | View: Marina | — |
garden_view | View: Garden | — |
pool_view | View: Pool | — |
beachfront | WaterfrontFeatures: Beach Front | — |
beach_access | WaterfrontFeatures: Beach Access | — |
waterfront | WaterfrontYN | — |
lakefront | WaterfrontFeatures: Lake Front | — |
riverfront | WaterfrontFeatures: River Front | — |
golf_front | LotFeatures: On Golf Course | — |
private_dock | WaterfrontFeatures: Dock | — |
boat_slip | DockType: Slip | — |
pool | PoolPrivateYN or AssociationAmenities: Pool | swimmingpool |
private_pool | PoolPrivateYN: true | swimmingpool |
shared_pool | AssociationAmenities: Pool | — |
heated_pool | PoolFeatures: Heated | — |
infinity_pool | PoolFeatures: Infinity | — |
jacuzzi | SpaYN | — |
garden | — | gartennutzung |
private_garden | — | gartennutzung |
terrace | PatioAndPorchFeatures: Terrace | — |
rooftop | PatioAndPorchFeatures: Rooftop | — |
balcony | PatioAndPorchFeatures: Balcony | — |
patio | PatioAndPorchFeatures: Patio | — |
covered_porch | PatioAndPorchFeatures: Covered | — |
outdoor_kitchen | ExteriorFeatures: Outdoor Kitchen | — |
outdoor_shower | ExteriorFeatures: Outdoor Shower | — |
gazebo | ExteriorFeatures: Gazebo | — |
fire_pit | ExteriorFeatures: Fire Pit | — |
fenced_yard | Fencing: Full | — |
furnished | Furnished: Furnished | — |
semi_furnished | Furnished: Partially | — |
equipped_kitchen | — | kueche (EBK) |
open_kitchen | — | kueche (OFFEN) |
kitchen_island | InteriorFeatures: Kitchen Island | — |
pantry | InteriorFeatures: Pantry | — |
walk_in_closet | InteriorFeatures: Walk-In Closet(s) | — |
built_in_wardrobes | InteriorFeatures: Built-in Features | — |
laundry_room | LaundryFeatures: Laundry Room | waschtrockenraum |
washer | Appliances: Washer | — |
dryer | Appliances: Dryer | — |
dishwasher | Appliances: Dishwasher | — |
fireplace | FireplaceYN | kamin |
high_ceilings | InteriorFeatures: High Ceilings | — |
hardwood_floors | Flooring: Wood | boden (PARKETT/DIELEN) |
marble_floors | Flooring: Marble | boden (MARMOR) |
tile_floors | Flooring: Tile | boden (FLIESEN) |
storage | — | abstellraum |
basement | Basement | unterkellert |
attic | InteriorFeatures: Attic | — |
home_office | InteriorFeatures: Office | — |
guest_house | OtherStructures: Guest House | — |
guest_toilet | — | gaestewc |
wine_cellar | InteriorFeatures: Wine Cellar | — |
home_cinema | InteriorFeatures: Media Room | — |
sauna | InteriorFeatures: Sauna | sauna |
steam_room | InteriorFeatures: Steam Shower | — |
air_conditioning | CoolingYN | klimatisiert |
central_air | Cooling: Central Air | klimatisiert |
ceiling_fans | Cooling: Ceiling Fan(s) | — |
heating | HeatingYN | heizungsart |
underfloor_heating | Heating: Radiant Floor | heizungsart (FUSSBODEN) |
heat_pump | Heating: Heat Pump | befeuerung (WAERMEPUMPE) |
generator | Electric: Generator | — |
solar | Electric: Photovoltaics Seller Owned | befeuerung (SOLAR) |
solar_water_heater | WaterHeaterFeatures: Solar | — |
water_well | WaterSource: Well | — |
water_filtration | WaterSource: Filtration | — |
septic_tank | Sewer: Septic Tank | — |
mains_sewer | Sewer: Public Sewer | — |
natural_gas | Utilities: Natural Gas Connected | befeuerung (GAS) |
lpg_tank | Utilities: Propane | — |
fiber_internet | Utilities: Fiber Optic | — |
satellite_tv | — | kabel_sat_tv |
ev_charger | ParkingFeatures: Electric Vehicle Charging Station(s) | — |
smart_home | InteriorFeatures: Smart Home | — |
double_glazing | WindowFeatures: Double Pane Windows | — |
elevator | AssociationAmenities: Elevator(s) | fahrstuhl |
concierge | AssociationAmenities: Concierge | — |
lobby | CommunityFeatures: Lobby | — |
bike_storage | AssociationAmenities: Bike Storage | fahrradraum |
intercom | SecurityFeatures: Intercom | — |
trash_chute | AssociationAmenities: Trash | — |
parking | ParkingTotal > 0 | stellplatzart |
covered_parking | ParkingFeatures: Covered | stellplatzart (CARPORT) |
garage | GarageYN | stellplatzart (GARAGE) |
underground_parking | ParkingFeatures: Underground | stellplatzart (TIEFGARAGE) |
visitor_parking | AssociationAmenities: Visitor Parking | — |
gated | CommunityFeatures: Gated | — |
security_24h | SecurityFeatures: 24 Hour Security | — |
cctv | SecurityFeatures: Security Camera(s) | — |
alarm_system | SecurityFeatures: Security System | alarmanlage |
safe | SecurityFeatures: Safe Room | — |
hurricane_shutters | WindowFeatures: Hurricane Shutters | — |
impact_windows | WindowFeatures: Impact Glass | — |
fire_sprinklers | SecurityFeatures: Fire Sprinkler System | — |
smoke_detectors | SecurityFeatures: Smoke Detector(s) | — |
gym | AssociationAmenities: Fitness Center | — |
spa | AssociationAmenities: Spa/Hot Tub | — |
clubhouse | AssociationAmenities: Clubhouse | — |
tennis_court | AssociationAmenities: Tennis Court(s) | — |
golf_course | AssociationAmenities: Golf Course | — |
private_beach | AssociationAmenities: Beach Access | — |
marina | AssociationAmenities: Marina | — |
playground | AssociationAmenities: Playground | — |
restaurant | AssociationAmenities: Restaurant | — |
coworking | AssociationAmenities: Business Center | — |
event_room | AssociationAmenities: Party Room | — |
jogging_track | AssociationAmenities: Jogging Path | — |
dog_park | AssociationAmenities: Dog Park | — |
shared_garden | AssociationAmenities: Landscaping | — |
housekeeping | AssociationFeeIncludes: Maid Service | — |
hoa_managed | AssociationYN | — |
equestrian | AssociationAmenities: Stable(s) | — |
pet_friendly | PetsAllowed: Yes | — |
investment_tenanted | — | vermietet |
rainwater_harvesting | GreenWaterConservation: Water Recycling | — |
green_certified | GreenBuildingVerificationType | — |
low_energy_lighting | GreenEnergyEfficient: Lighting | — |
step_free_access | AccessibilityFeatures: No Stairs | barrierefrei |
wheelchair_accessible | AccessibilityFeatures: Accessible Entrance | rollstuhlgerecht |
accessible_bathroom | AccessibilityFeatures: Accessible Bathroom | — |
walk_in_shower | AccessibilityFeatures: Walk-In Shower | — |
ground_floor_bedroom | InteriorFeatures: Main Level Primary | — |
wide_doorways | AccessibilityFeatures: Accessible Doors | — |
stairlift | AccessibilityFeatures: Stair Lift | — |
What none of them carry
Whatever the source, these REES fields have no equivalent and are what lift a listing to Verified and Complete: price.basis, provenance, location.geo.precision, location.address_visibility, license,
legal.title_status, legal.survey_done, legal.tax_exemption, building.design_wind_speed_kmh, and developments as their own objects.
Mappings describe OpenImmo 1.2.x, RESO Data Dictionary 2.x and Kyero feed v3 as commonly implemented. Found a mistake? Tell us on the changelog page.