📘
El endpoint se encuentra en Properties dentro de nuestra referencia API.

Cómo consultar los detalles de una propiedad

Para obtener los detalles de una propiedad usa este endpoint con el public_id recibido en Listing Statuses.

En este ejemplo pedimos el detalle de la propiedad con public_id: EB-B0579

curl --request GET \
     --url https://api.stagingeb.com/v1/integration_partners/properties/EB-B0579 \
     --header 'Country-Code: MX' \
     --header 'X-Authorization: $API_KEY' \
     --header 'accept: application/json'

En el resultado obtendrás todos los detalles de la propiedad, incluyendo fotografías, descripción, tipo de operación, características y amenidades.

La respuesta incluye los identificadores que necesitas para consultar los datos de contacto de la agencia y, cuando aplique, del agente asignado.

Este es un ejemplo de la respuesta que podrías recibir:

{
  "public_id": "EB-B0579",
  "title": "Bosques de las Lomas, departamento a la renta en Residencial",
  "created_at": "2018-06-22T18:27:33-05:00",
  "updated_at": "2024-04-09T22:00:35-06:00",
  "url": "https://www.easybroker.com/mx/listings/7425-mcv-casa-en-venta-en-tenayuca-letran-valle-benito-juarez",
  "description": "Bosques de las Loma, departamento a la renta en Residencial Solarium . Cuenta con 325 mts, sala, comedor, cocina, desayunador, estudio, 3 recamaras con baño y vestidor, cuarto de lavado y servicio, mantenimiento incluido, 2 estacionamientos. Amenidades: gimnasio, elevador de servicio, sala de juegos, seguridad, spa, alberca, apto mascotas, circuito errado, juegos para niños, ludoteca, salón de fiestas, seguridad 24hs.\n\n_____________________________________________________\n\n \nLas medidas son ilustrativas y deben de corroborarse con los títulos de propiedad respectivos y/o las boletas predial. \nLos precios publicados y la disponibilidad pueden cambiar sin previo aviso por lo que se debe de verificar con la inmobiliaria y los propietarios de los inmuebles. \nLa publicación de la presente información No representa una oferta pública por lo que toda transacción debe de hacerse de forma personal de acuerdo a las practicas comerciales de la inmobiliaria y para poder ser valida requiere de la autorización expresa de los propietarios de los inmuebles. EasyBroker ID: EB-B0579",
  "property_type": "Departamento",
  "bedrooms": 3,
  "bathrooms": 3,
  "half_bathrooms": 1,
  "parking_spaces": 4,
  "lot_size": 0,
  "construction_size": 325,
  "expenses": "0",
  "lot_length": 0,
  "lot_width": 0,
  "floors": null,
  "floor": "1",
  "age": "1998",
  "agency_id": "1204",
  "agent_id": "edi_3",
  "location": {
    "region": "Ciudad de México",
    "city": "Benito Juárez",
    "city_area": "Del Valle Centro",
    "street": "Magdalena",
    "postal_code": null,
    "show_exact_location": true,
    "latitude": 19.3973722,
    "longitude": -99.1702142
  },
  "operations": [
    {
      "type": "sale",
      "amount": 1000883,
      "currency": "MXN",
      "formatted_amount": "$1,000,883",
      "unit": "total"
    }
  ],
  "videos": [
    "https://www.youtube.com/watch?v=vv_uy0miZgI"
  ],
  "virtual_tour": "https://my.matterport.com/show/?m=4dgjzfwSHG2",
  "features": [
    "Elevador",
    "Estacionamiento techado",
    "Gimnasio",
    "Seguridad 24 Horas",
    "Cocina integral",
    "Alberca",
    "Alberca Automática",
    "Salón de usos múltiples"
  ],
  "tags": [
    "publicadas"
  ],
  "ad_type": null,
  "property_images": [
    {
      "title": null,
      "url": "https://assets.stagingeb.com/property_images/20579/317458/EB-B0579.png?version=1666736750"
    },
    {
      "title": null,
      "url": "https://assets.stagingeb.com/property_images/20579/401196/EB-B0579.jpg?version=1692035838"
    },
    ...
    {
      "title": null,
      "url": "https://assets.stagingeb.com/property_images/20579/401209/EB-B0579.jpg?version=1692035848"
    }
  ]
}

Datos de contacto

En la respuesta de ejemplo encontrarás dos campos que te ayudarán a obtener los datos de contacto de la propiedad.

agency_id: Contiene el ID único de la agencia y que deberás usar para obtener sus datos de contacto usando el endpoint de Agencies.
agent_id: Contiene el ID único del agente y para obtener los datos de contacto del agente deberás usar el endpoint de Agents.

Escenarios posibles

Existen dos escenarios posibles a la hora de consultar los detalles de una propiedad, estos dependerán de acuerdo a las preferencias de la agencia y pueden cambiar cada vez que ellos lo decidan.

El primero es cuando una propiedad no está asignada a un agente, en este caso solo recibirás el ID de la agencia y lo verás en la respuesta de esta forma.
```
"agency_id": "1204",
"agent_id": null
```
Para este caso sólo es necesario consultar Agencies.
El segundo es cuando una propiedad sí tiene un agente asignado. Recibirás ambos IDs, el de la agencia y el del agente.
```
"agency_id": "1204",
"agent_id": "edi_3"
```
En este caso es necesario consultar Agents.

📘
Recuerda, te recomendamos relacionar esta información usando el agency_id.