The publishers and properties are invented; the values are realistic.
- Minimal feed (Basic level) · minimal.json ↓
- Caribbean agency: villa, off-plan unit, lot, long let, development · full.json ↓
- Holiday rental with licence and seasons · holiday.json ↓
- European listing with energy certificate · europe.json ↓
- Commercial: office to let · commercial.json ↓
- Delta feed: a sale since the last pull · delta.json ↓
What they show
- ER-1002, a golf villa: Complete level — provenance on price and areas, title and survey, building and roof, HOA per month, a property tax marked as an estimate.
- ER-1003, an off-plan unit: priced in
DOP— REES never forces a conversion. Linked to its development withdevelopment_id, with a CONFOTUR exemption. - ER-1004, a lot:
basis: "per_m2"with a plot area, so the total is computed, never guessed. - ER-R-2001, a long let:
rental_terms(deposit, minimum term, utilities included), hidden address, display-only licence. - Holiday rental: tourist licence, guests, minimum stay, iCal calendar, seasonal rates.
- Europe: EU energy certificate, usable and gross area, total rooms, floor and orientation.
- Commercial: use, ceiling height, power supply.
v0.1 examples (still valid against v0.1): v0.1-minimal.json · v0.1-full.json · v0.1-delta.json
Minimal feed (Basic level)
Validator: valid · feed level Basic · download · validate
{
"rees": "0.2",
"publisher": {
"id": "example-realty",
"name": "Example Realty",
"website": "https://example-realty.test"
},
"generated_at": "2026-10-01T08:00:00Z",
"listings": [
{
"id": "ER-1001",
"url": "https://example-realty.test/listings/er-1001",
"status": "active",
"updated_at": "2026-09-30T16:20:00-04:00",
"operation": "sale",
"property_type": "apartment",
"title": {
"en": "2-bed condo near Los Corales beach"
},
"price": {
"amount": 189000,
"currency": "USD",
"basis": "total"
},
"location": {
"country": "DO",
"city": "Punta Cana",
"area": "Los Corales"
},
"media": [
{
"url": "https://example-realty.test/media/p1.jpg",
"type": "photo",
"order": 1
}
]
}
]
}Caribbean agency: villa, off-plan unit, lot, long let, development
Validator: valid · feed level Basic · 2 basic, 1 verified, 1 complete · download · validate
{
"rees": "0.2",
"publisher": {
"id": "example-realty",
"name": "Example Realty",
"website": "https://example-realty.test",
"kind": "agency",
"country": "DO",
"contact": {
"name": "Front desk",
"email": "listings@example-realty.test",
"phone": "+1 809 555 0100",
"languages": [
"en",
"es",
"fr"
]
}
},
"generated_at": "2026-10-01T08:00:00Z",
"license": {
"use": "republish-with-credit",
"credit_required": true,
"backlink_required": true,
"url": "https://example-realty.test/terms"
},
"developments": [
{
"id": "DEV-MAREA",
"name": "Marea Residences",
"url": "https://example-realty.test/developments/marea",
"developer": "Marea Developers SRL",
"location": {
"country": "DO",
"region": "La Altagracia",
"city": "Punta Cana",
"area": "Cap Cana",
"geo": {
"lat": 18.4561,
"lng": -68.392,
"precision": "street"
}
},
"delivery": {
"status": "off_plan",
"expected": "2028-Q2"
},
"units_total": 48,
"units_available": 31,
"price_from": {
"amount": 245000,
"currency": "USD",
"basis": "from"
},
"description": {
"en": "Four low-rise buildings around a lagoon pool, 400 m from the beach.",
"es": "Cuatro edificios de baja altura alrededor de una piscina laguna, a 400 m de la playa."
},
"media": [
{
"url": "https://example-realty.test/media/p20.jpg",
"type": "photo",
"order": 20
}
],
"features": [
"lagoon_pool",
"gated",
"security_24h",
"gym",
"beach_club"
],
"building": {
"floors_total": 4,
"construction": "concrete",
"roof": "concrete",
"design_wind_speed_kmh": 250
},
"energy": {
"scheme": "edge",
"status": "in_process"
}
}
],
"listings": [
{
"id": "ER-1002",
"url": "https://example-realty.test/listings/er-1002",
"status": "active",
"updated_at": "2026-09-30T16:20:00-04:00",
"listed_at": "2026-08-14",
"operation": "sale",
"property_type": "villa",
"title": {
"en": "4-bed golf villa with private pool",
"es": "Villa de 4 habitaciones en campo de golf con piscina privada",
"fr": "Villa de 4 chambres sur le golf avec piscine privée"
},
"description": {
"en": "Single-level villa on the 7th fairway, renovated 2024."
},
"price": {
"amount": 865000,
"currency": "USD",
"basis": "total",
"includes": [
"furniture"
],
"provenance": {
"source": "owner",
"date": "2026-08-14",
"confidence": "stated"
}
},
"area": {
"built": {
"value": 312,
"unit": "m2",
"provenance": {
"source": "survey",
"date": "2019-03-02",
"confidence": "verified"
}
},
"terrace": {
"value": 85,
"unit": "m2"
},
"plot": {
"value": 1150,
"unit": "m2",
"provenance": {
"source": "registry",
"confidence": "verified"
}
}
},
"rooms": {
"bedrooms": 4,
"bathrooms": 4.5,
"parking": 2
},
"location": {
"country": "DO",
"region": "La Altagracia",
"city": "Punta Cana",
"area": "Cocotal Golf & Country Club",
"geo": {
"lat": 18.6606,
"lng": -68.4151,
"precision": "exact",
"provenance": {
"source": "agent",
"confidence": "stated"
}
}
},
"delivery": {
"status": "built",
"year_built": 2016
},
"building": {
"floors_total": 1,
"orientation": "sw",
"condition": "excellent",
"year_renovated": 2024,
"construction": "concrete_block",
"roof": "concrete",
"ground_elevation_m": 21
},
"features": [
"private_pool",
"golf_front",
"golf_view",
"gated",
"security_24h",
"generator",
"inverter",
"cistern",
"furnished",
"air_conditioning",
"outdoor_kitchen",
"service_quarters",
"hurricane_shutters",
"golf_cart_parking"
],
"media": [
{
"url": "https://example-realty.test/media/p1.jpg",
"type": "photo",
"order": 1
},
{
"url": "https://example-realty.test/media/p2.jpg",
"type": "photo",
"order": 2
},
{
"url": "https://example-realty.test/media/p3.jpg",
"type": "photo",
"order": 3
},
{
"url": "https://example-realty.test/media/er-1002-plan.pdf",
"type": "floorplan"
}
],
"costs": {
"hoa": {
"amount": 480,
"currency": "USD",
"basis": "per_month",
"provenance": {
"source": "agent",
"date": "2026-08-14",
"confidence": "stated"
}
},
"property_tax": {
"amount": 5900,
"currency": "USD",
"basis": "per_year",
"provenance": {
"source": "estimate",
"confidence": "estimated",
"note": "IPI 1% above the exemption threshold"
}
},
"transfer_tax_pct": 3
},
"legal": {
"title_status": "titled_individual",
"survey_done": true,
"foreign_buyers": "allowed"
},
"agent": {
"name": "Ana Pérez",
"email": "ana@example-realty.test",
"whatsapp": "+1 829 555 0144",
"languages": [
"es",
"en"
]
}
},
{
"id": "ER-1003",
"url": "https://example-realty.test/listings/er-1003",
"status": "active",
"updated_at": "2026-09-28T10:00:00-04:00",
"operation": "sale",
"property_type": "apartment",
"development_id": "DEV-MAREA",
"unit": "B-204",
"title": {
"es": "Apartamento de 2 habitaciones en Marea Residences",
"en": "2-bed apartment at Marea Residences"
},
"price": {
"amount": 16900000,
"currency": "DOP",
"basis": "total",
"provenance": {
"source": "developer",
"date": "2026-09-01",
"confidence": "stated"
}
},
"area": {
"built": {
"value": 104,
"unit": "m2",
"provenance": {
"source": "developer",
"confidence": "stated"
}
}
},
"rooms": {
"bedrooms": 2,
"bathrooms": 2
},
"location": {
"country": "DO",
"region": "La Altagracia",
"city": "Punta Cana",
"area": "Cap Cana",
"geo": {
"lat": 18.4561,
"lng": -68.392,
"precision": "street"
}
},
"delivery": {
"status": "off_plan",
"expected": "2028-Q2"
},
"building": {
"floor": 2,
"floors_total": 4
},
"legal": {
"tax_exemption": {
"scheme": "CONFOTUR",
"until_year": 2043,
"provenance": {
"source": "developer",
"confidence": "stated",
"note": "Classification granted to the project; per-unit certificate issued at delivery."
}
}
},
"media": [
{
"url": "https://example-realty.test/media/p21.jpg",
"type": "photo",
"order": 21
},
{
"url": "https://example-realty.test/media/p22.jpg",
"type": "photo",
"order": 22
}
],
"features": [
"lagoon_pool",
"gated",
"balcony"
]
},
{
"id": "ER-1004",
"url": "https://example-realty.test/listings/er-1004",
"status": "active",
"updated_at": "2026-09-20T09:00:00-04:00",
"operation": "sale",
"property_type": "land",
"title": {
"en": "Residential lot, 900 m², 5 min to the beach"
},
"price": {
"amount": 230,
"currency": "USD",
"basis": "per_m2"
},
"area": {
"plot": {
"value": 900,
"unit": "m2"
}
},
"location": {
"country": "DO",
"region": "Puerto Plata",
"city": "Cabarete",
"area": "Encuentro",
"geo": {
"lat": 19.7631,
"lng": -70.438,
"precision": "neighbourhood"
}
},
"legal": {
"title_status": "titled",
"survey_done": false
},
"media": [
{
"url": "https://example-realty.test/media/p30.jpg",
"type": "photo",
"order": 30
}
]
},
{
"id": "ER-R-2001",
"url": "https://example-realty.test/rentals/er-r-2001",
"status": "active",
"updated_at": "2026-09-27T12:00:00-04:00",
"operation": "rent_long",
"property_type": "apartment",
"title": {
"en": "Furnished 1-bed in Bávaro, 12-month lease",
"es": "Apartamento amueblado de 1 habitación en Bávaro, contrato de 12 meses"
},
"price": {
"amount": 950,
"currency": "USD",
"basis": "per_month",
"includes": [
"hoa"
]
},
"area": {
"built": {
"value": 68,
"unit": "m2"
}
},
"rooms": {
"bedrooms": 1,
"bathrooms": 1
},
"location": {
"country": "DO",
"city": "Punta Cana",
"area": "Bávaro",
"address_visibility": "area_only"
},
"rental_terms": {
"deposit_months": 2,
"min_term_months": 12,
"available_from": "2026-11-01",
"furnished": "fully",
"utilities_included": [
"hoa",
"internet",
"water"
],
"pets": "on_request",
"smoking_allowed": false
},
"features": [
"shared_pool",
"inverter",
"pet_friendly",
"fiber_internet"
],
"media": [
{
"url": "https://example-realty.test/media/p40.jpg",
"type": "photo",
"order": 40
}
],
"listing_office": {
"name": "Partner Rentals SRL",
"website": "https://partner-rentals.test"
},
"license": {
"use": "display-only",
"credit_required": true,
"backlink_required": true
}
}
]
}Holiday rental with licence and seasons
Validator: valid · feed level Basic · download · validate
{
"rees": "0.2",
"publisher": {
"id": "example-stays",
"name": "Example Stays",
"kind": "agency",
"website": "https://example-stays.test",
"country": "DO"
},
"generated_at": "2026-10-01T08:00:00Z",
"license": {
"use": "republish-with-credit",
"credit_required": true,
"backlink_required": true
},
"listings": [
{
"id": "ES-H-77",
"url": "https://example-stays.test/villas/es-h-77",
"status": "active",
"updated_at": "2026-09-29T09:00:00-04:00",
"operation": "rent_short",
"property_type": "villa",
"title": {
"en": "Beachfront 3-bed villa with pool",
"es": "Villa de 3 habitaciones frente al mar con piscina"
},
"price": {
"amount": 420,
"currency": "USD",
"basis": "per_night"
},
"rooms": {
"bedrooms": 3,
"bathrooms": 3
},
"location": {
"country": "DO",
"city": "Las Terrenas",
"area": "Playa Bonita",
"geo": {
"lat": 19.3238,
"lng": -69.5652,
"precision": "neighbourhood"
},
"address_visibility": "area_only"
},
"short_term": {
"license_number": "MITUR-VR-2026-00417",
"license_authority": "Ministerio de Turismo (MITUR)",
"max_guests": 6,
"min_nights": 3,
"check_in": "15:00",
"check_out": "11:00",
"calendar_url": "https://example-stays.test/ical/es-h-77.ics",
"rates": [
{
"name": "High season",
"from": "2026-12-15",
"to": "2027-04-15",
"price": {
"amount": 520,
"currency": "USD",
"basis": "per_night"
}
},
{
"name": "Low season",
"from": "2027-04-16",
"to": "2027-12-14",
"price": {
"amount": 380,
"currency": "USD",
"basis": "per_night"
}
}
],
"cleaning_fee": {
"amount": 90,
"currency": "USD",
"basis": "total"
}
},
"features": [
"beachfront",
"private_pool",
"ocean_view",
"air_conditioning",
"generator",
"housekeeping",
"fiber_internet",
"bbq"
],
"media": [
{
"url": "https://example-realty.test/media/p70.jpg",
"type": "photo",
"order": 70
},
{
"url": "https://example-realty.test/media/p71.jpg",
"type": "photo",
"order": 71
}
]
}
]
}European listing with energy certificate
Validator: valid · feed level Complete · download · validate
{
"rees": "0.2",
"publisher": {
"id": "example-lisboa",
"name": "Example Lisboa Imóveis",
"kind": "agency",
"website": "https://example-lisboa.test",
"country": "PT",
"license_number": "AMI 99999"
},
"generated_at": "2026-10-01T08:00:00Z",
"license": {
"use": "republish-with-credit",
"credit_required": true,
"backlink_required": true
},
"listings": [
{
"id": "LX-5521",
"url": "https://example-lisboa.test/imoveis/lx-5521",
"status": "active",
"updated_at": "2026-09-30T11:00:00+01:00",
"operation": "sale",
"property_type": "apartment",
"title": {
"pt": "T2 renovado com varanda em Campo de Ourique",
"en": "Renovated 2-bed with balcony in Campo de Ourique"
},
"price": {
"amount": 545000,
"currency": "EUR",
"basis": "total",
"provenance": {
"source": "owner",
"date": "2026-09-15",
"confidence": "stated"
}
},
"area": {
"gross": {
"value": 96,
"unit": "m2"
},
"usable": {
"value": 84,
"unit": "m2",
"provenance": {
"source": "registry",
"confidence": "verified",
"note": "Caderneta predial"
}
},
"built": {
"value": 84,
"unit": "m2",
"provenance": {
"source": "registry",
"confidence": "verified"
}
},
"standard": "local"
},
"rooms": {
"bedrooms": 2,
"bathrooms": 2,
"total": 4
},
"location": {
"country": "PT",
"region": "Lisboa",
"city": "Lisboa",
"area": "Campo de Ourique",
"postal_code": "1350-000",
"geo": {
"lat": 38.7172,
"lng": -9.1666,
"precision": "neighbourhood"
},
"address_visibility": "area_only"
},
"delivery": {
"status": "built",
"year_built": 1948
},
"building": {
"floor": 3,
"floors_total": 5,
"orientation": "s",
"condition": "excellent",
"year_renovated": 2023,
"construction": "masonry"
},
"energy": {
"scheme": "eu_epc",
"rating": "B",
"primary_kwh_m2_year": 96,
"status": "issued",
"valid_until": "2033-05-31",
"provenance": {
"source": "certificate",
"date": "2023-06-01",
"confidence": "verified"
}
},
"costs": {
"hoa": {
"amount": 85,
"currency": "EUR",
"basis": "per_month"
}
},
"legal": {
"title_status": "titled",
"survey_done": true,
"foreign_buyers": "allowed"
},
"features": [
"balcony",
"elevator",
"equipped_kitchen",
"double_glazing",
"hardwood_floors",
"built_in_wardrobes",
"heat_pump"
],
"media": [
{
"url": "https://example-realty.test/media/p80.jpg",
"type": "photo",
"order": 80
},
{
"url": "https://example-realty.test/media/p81.jpg",
"type": "photo",
"order": 81
}
]
}
]
}Commercial: office to let
Validator: valid · feed level Basic · download · validate
{
"rees": "0.2",
"publisher": {
"id": "example-commercial",
"name": "Example Commercial",
"kind": "agency",
"website": "https://example-commercial.test",
"country": "DO"
},
"generated_at": "2026-10-01T08:00:00Z",
"listings": [
{
"id": "EC-310",
"url": "https://example-commercial.test/oficinas/ec-310",
"status": "active",
"updated_at": "2026-09-25T10:00:00-04:00",
"operation": "rent_long",
"property_type": "commercial",
"title": {
"es": "Oficina de 220 m² en Piantini",
"en": "220 m² office in Piantini"
},
"price": {
"amount": 4400,
"currency": "USD",
"basis": "per_month"
},
"area": {
"built": {
"value": 220,
"unit": "m2"
}
},
"rooms": {
"parking": 6
},
"location": {
"country": "DO",
"region": "Distrito Nacional",
"city": "Santo Domingo",
"area": "Piantini"
},
"building": {
"floor": 8,
"floors_total": 14
},
"commercial": {
"use": "office",
"ceiling_height": {
"value": 2.9,
"unit": "m"
},
"power_kva": 45,
"tenanted": false
},
"rental_terms": {
"deposit_months": 3,
"min_term_months": 24
},
"features": [
"elevator",
"generator",
"central_air",
"security_24h",
"covered_parking",
"fiber_internet"
],
"media": [
{
"url": "https://example-realty.test/media/p90.jpg",
"type": "photo",
"order": 90
}
]
}
]
}Delta feed: a sale since the last pull
Validator: valid · feed level Basic · download · validate
{
"rees": "0.2",
"publisher": {
"id": "example-realty",
"name": "Example Realty",
"website": "https://example-realty.test"
},
"generated_at": "2026-10-01T20:00:00Z",
"since": "2026-10-01T08:00:00Z",
"listings": [
{
"id": "ER-1001",
"url": "https://example-realty.test/listings/er-1001",
"status": "sold",
"updated_at": "2026-10-01T14:05:00-04:00",
"operation": "sale",
"property_type": "apartment",
"title": {
"en": "2-bed condo near Los Corales beach"
},
"price": {
"amount": 182500,
"currency": "USD",
"basis": "total"
},
"location": {
"country": "DO",
"city": "Punta Cana",
"area": "Los Corales"
},
"media": [
{
"url": "https://example-realty.test/media/p1.jpg",
"type": "photo",
"order": 1
}
]
}
]
}