Caribe Scout
REES v0.2 · borrador

REES: el Estándar de Intercambio Inmobiliario

Un formato abierto y gratuito para enviar anuncios inmobiliarios entre agencias, promotores y portales. Nacido en el Caribe, para los problemas reales: precios que no dicen su moneda, superficies que no dicen su unidad, ubicaciones en el país equivocado y nadie sabiendo quién puede publicar qué.

¿Por qué otro estándar?

Europa tiene OpenImmo (XML, desde 2002) y Norteamérica tiene RESO (pensado para sistemas MLS). Ambos funcionan donde nacieron. Ninguno se diseñó para un mercado donde un apartamento se cotiza en dólares, tributa en pesos, se vende en planos, lo comercializan tres agencias a la vez y se anuncia en un tema de WordPress.

Construimos Caribe Scout leyendo sitios web de agencias, y cada error de esta tabla salió de un feed real:

Lo que decía el feedLo que significabaCómo lo evita REES
$1,250,000A veces pesos: un error de 60×Todo precio lleva un código de moneda ISO: USD, DOP. No se aceptan símbolos.
$230 /m²Un solar con precio por metro, guardado como una casa de $230Todo precio indica su basis: total, por m², "desde", rango, por mes…
157 SQFT157 m², mal etiquetados por un temaToda superficie indica su unidad, y el validador avisa de pies cuadrados donde lo normal son m².
Un punto en MiamiEl centro de mapa por defecto de un tema, en 118 de 120 anunciosLas coordenadas indican su precisión; los puntos por defecto conocidos se señalan.
"Datos IDX solo para uso personal" en un pie de páginaUna licencia que ninguna máquina podía leerLos derechos son un campo: republicar con crédito, solo mostrar, MLS/IDX o ninguno.
"Desde $245,000"La unidad más barata de un proyecto, no un anuncioLos proyectos son objetos propios, con sus unidades enlazadas.

Principios

  1. Ningún número ambiguo. El dinero lleva moneda y base; las superficies, unidad; las coordenadas, precisión.
  2. Cada cifra puede decir de dónde sale. Cualquier precio, superficie o dato legal puede llevar su procedencia: quién lo dijo, cuándo y si se comprobó.
  3. El dueño de los datos sigue siendo el dueño. Anunciante, oficina, licencia y reglas de enlace viajan con cada anuncio.
  4. Internacional desde el principio. 154 comodidades en 12 categorías, etiquetadas en 7 idiomas; certificado energético, alquiler vacacional, comercial.
  5. Fácil de empezar, gratificante de completar. Quince campos forman un feed válido. El resto sube de nivel.
  6. Abierto y gratuito. Sin cuota de licencia ni membresía. JSON por HTTPS: un archivo en una URL basta.

Tres niveles

Un feed se revisa anuncio por anuncio. Cada anuncio alcanza un nivel, y los receptores como Caribe Scout lo muestran.

Básico

Válido según el esquema, con al menos una foto. Identidad, estado, precio con moneda y base, ciudad y país.

Verificado

Básico, más licencia declarada, procedencia del precio y de la superficie principal, y coordenadas con precisión.

Completo

Verificado, más título y deslinde, estado de construcción, habitaciones y cuota de mantenimiento con su periodo.

Así es un feed

El feed válido más pequeño: un anuncio, nivel Básico.

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

Vea ejemplos completos, la referencia de campos o pegue su propio feed en el validador.

Por dónde empezar

REES es un borrador mantenido por Caribe Scout. El texto de la especificación se publica con licencia CC BY 4.0; el esquema y el código del validador, con Apache 2.0. Los cambios se proponen en abierto: vea las versiones.