Caribe Scout
REES v0.2 · borrador

Feeds de ejemplo

Copie uno, cambie los valores y páselo por el validador. Cada ejemplo se comprueba en cada compilación con nuestra batería de pruebas, así que siempre son válidos.

Anunciantes e inmuebles inventados; valores realistas.

Qué muestran

  • ER-1002, villa de golf: nivel Completo: procedencia de precio y superficies, título y deslinde, edificio y techo, cuota mensual, un impuesto marcado como estimado.
  • ER-1003, unidad en planos: precio en DOP; REES nunca obliga a convertir. Enlazada a su proyecto con development_id y con exención CONFOTUR.
  • ER-1004, solar: basis: "per_m2" con superficie de terreno: el total se calcula, nunca se adivina.
  • ER-R-2001, alquiler: rental_terms (depósito, plazo mínimo, servicios incluidos), dirección oculta y licencia solo-mostrar.
  • Alquiler vacacional: licencia turística, huéspedes, estancia mínima, calendario iCal y tarifas por temporada.
  • Europa: certificado energético UE, superficie útil y construida, número total de piezas, piso y orientación.
  • Comercial: uso, altura libre, potencia eléctrica.

Ejemplos de v0.1 (siguen siendo válidos contra v0.1): v0.1-minimal.json · v0.1-full.json · v0.1-delta.json

Feed mínimo (nivel Básico)

Validador: válido · nivel del feed Básico · descargar · validar

{
  "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
        }
      ]
    }
  ]
}

Agencia del Caribe: villa, unidad en planos, solar, alquiler, proyecto

Validador: válido · nivel del feed Básico · 2 básico, 1 verificado, 1 completo · descargar · validar

{
  "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
      }
    }
  ]
}

Alquiler vacacional con licencia y temporadas

Validador: válido · nivel del feed Básico · descargar · validar

{
  "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
        }
      ]
    }
  ]
}

Anuncio europeo con certificado energético

Validador: válido · nivel del feed Completo · descargar · validar

{
  "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
        }
      ]
    }
  ]
}

Comercial: oficina en alquiler

Validador: válido · nivel del feed Básico · descargar · validar

{
  "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
        }
      ]
    }
  ]
}

Feed delta: una venta desde la última descarga

Validador: válido · nivel del feed Básico · descargar · validar

{
  "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
        }
      ]
    }
  ]
}