Property Schema

Overview

The property object is the core data structure containing all information about a real estate listing. It is accessed via data.property in the JSON response.

Top-Level Structure

Property data is returned in a nested structure:

data

object

required

Top-level wrapper object

Show properties

property

object

required

Contains all property listing information

icon_details

object

Structured data for UI icon displays (building, distribution, other details)

sitios_interes

object

Points of interest near the property (shopping centers, supermarkets, parks)

success

boolean

required

Indicates if the request was successful

Property Object Fields

The data.property object contains the following fields:

Identification

property_uuid

string

required

Unique identifier for the propertyExample: "bbb8185d-2ee3-48a4-ba7f-8fecaba6e549"

property_id

string

required

Numeric property identifierExample: "5157395"

nid

number

required

Node ID from the source systemExample: 49695472717

Basic Information

titulo

string

required

Property listing titleExample: "Apartamento en Venta en Las Cabañas, Bello"

descripcion

string

required

Detailed property description including features, location, and nearby amenitiesExample: "Apartamento en venta de 79m2, con vista exterior..."

Media

images

array

required

Array of image objects for the property. See Image Schema for details.Images are sorted by the order field before display.

url_360

string

URL to a 360-degree virtual tour of the propertyExample: "https://apartamento-dubai.vercel.app/?m=bE7cSwnyKad"

Services & Features

servicios

array

required

Array of utility service objects with costs. See Services Schema for details.

caracteristicas_propiedad

array

required

Array of property feature stringsExample: ["Interior", "Balcón", "Conjunto Cerrado", "Instalación de gas"]

Property Details

detalles_propiedad

object

required

Nested object containing detailed property information

Show fields

area

number

required

Property area in square meters (m²)Example: 79.0

tipo_inmueble

string

required

Property typeExample: "Apartamento", "Casa", "Local Comercial"

estrato

string

required

Socioeconomic stratum (1-6 in Colombia)Example: "3"

conjunto

string

required

Building or complex nameExample: "Dubai"

conjunto_edificio

string

Alternative field for building/complex name

direccion

string

required

Street addressExample: "CARRERA 58AA 31-166"

barriocomun

string

required

Neighborhood nameExample: "Las Cabañas"

ciudad

string

required

City nameExample: "Bello"

zona_metropolitana

string

Metropolitan areaExample: "Valle de Aburrá"

zona_mediana

string

Mid-level zone classificationExample: "LA CABAÑA"

precio_venta

number

required

Sale price in Colombian pesos (COP)Example: 328000000.0

precio_anterior

number

Previous price if the property was discountedExample: null (no previous price)

discount_rate

number

Discount percentage if applicable

num_habitaciones

number

required

Number of bedroomsExample: 3

baños

number

required

Number of bathroomsExample: 2

garajes

number

required

Number of parking spacesExample: 0

num_piso

number

Floor numberExample: 5

flat

number

Alternative field for floor numberExample: 5

num_ascensores

number

Number of elevators in the buildingExample: 0

anos_antiguedad

number

Property age in yearsExample: 10

remodelation

number

Remodeling status (0 = not remodeled, 1 = remodeled)Example: 0

last_admin_price

number

Monthly administration/HOA fee in COPExample: 0

latitud

number

required

Latitude coordinateExample: 6.319948999999999

longitud

number

required

Longitude coordinateExample: -75.565495

telefono

string

required

Contact phone numberExample: "3015637932"

contacto_zona

string

Alternative zone contact numberExample: "+57 3025673648"

correo

string

required

Contact email addressExample: "tati7214@gmail.com"

meta_title

string

SEO meta title

inventory_type_id

number

Internal inventory type identifierExample: 2

property_moment_id

number

Property lifecycle status identifierExample: 2

publicado

number

Publication status (2 = published)Example: 2

is_private

number

Private listing flag (0 = public, 1 = private)Example: 1

date_publication

string

Publication date and timeExample: "2025-12-30 12:08:20"

date_publication_full

string

Full publication timestampExample: "2025-12-30 12:08:20"

Data Normalization

The normalizeProperty() function in app.js transforms the raw property data into a flattened structure for easier rendering:

const normalizeProperty = (raw) => {
  const property = raw?.property || raw?.data?.property || raw;
  const details = property?.detalles_propiedad || {};
  
  return {
    titulo: property?.titulo,
    descripcion: property?.descripcion,
    tipo_inmueble: details?.tipo_inmueble || property?.tipo_inmueble,
    estrato: details?.estrato || property?.estrato,
    precio: details?.precio_venta ?? property?.precio,
    area_privada: details?.area ?? property?.area_privada,
    habitaciones: details?.num_habitaciones ?? property?.habitaciones,
    banos: details?.baños ?? details?.banos ?? property?.banos,
    // ... additional fields
  };
};

Key Normalization Rules

Field Merging: Top-level and detalles_propiedad fields are merged, with detalles_propiedad taking precedence
Fallback Values: Multiple field names are checked (e.g., conjunto, conjunto_edificio)
Image Sorting: Images are sorted by the order field ascending
Null Coalescing: Uses ?? operator to handle null/undefined values

Example Response

{
  "data": {
    "property": {
      "property_uuid": "bbb8185d-2ee3-48a4-ba7f-8fecaba6e549",
      "property_id": "5157395",
      "nid": 49695472717,
      "titulo": "Apartamento en Venta en Las Cabañas, Bello",
      "descripcion": "Apartamento en venta de 79m2, con vista exterior...",
      "url_360": "https://apartamento-dubai.vercel.app/?m=bE7cSwnyKad",
      "images": [...],
      "servicios": [...],
      "caracteristicas_propiedad": ["Interior", "Balcón"],
      "detalles_propiedad": {
        "area": 79.0,
        "tipo_inmueble": "Apartamento",
        "precio_venta": 328000000.0,
        "num_habitaciones": 3,
        "baños": 2,
        "ciudad": "Bello"
      }
    }
  },
  "success": true
}

Usage in Application

The property data is loaded and rendered in app.js:665-687:

const loadData = async () => {
  initLightbox();
  
  if (window.PROPERTY_DATA) {
    populatePage(window.PROPERTY_DATA);
    return;
  }
  
  const response = await fetch('./property-5157395.json');
  const data = await response.json();
  populatePage(data);
};

JavaScript Functions

Data Structure

Overview

Top-Level Structure

Property Object Fields

Identification

Basic Information

Media

Services & Features

Property Details

Data Normalization

Key Normalization Rules

Example Response

Usage in Application

Build docs developers (and LLMs) love

JavaScript Functions

Data Structure

​Overview

​Top-Level Structure

​Property Object Fields

​Identification

​Basic Information

​Media

​Services & Features

​Property Details

​Data Normalization

​Key Normalization Rules

​Example Response

​Usage in Application

Build docs developers (and LLMs) love

Overview

Top-Level Structure

Property Object Fields

Identification

Basic Information

Media

Services & Features

Property Details

Data Normalization

Key Normalization Rules

Example Response

Usage in Application