ByDomuDevelopers
Criar chave

Propiedades destacadas

GEThttps://api.bydomu.com/v1/properties/featured

Esta referência é gerada a partir do código da API, por isso as descrições estão em espanhol. Nomes, parâmetros e exemplos são iguais em qualquer idioma.

Hasta 6 propiedades publicadas: primero las marcadas como destacadas y, si faltan, las más recientes.

Permissão
portal:read
Chaves
Publicável ou secreta

Cabeçalhos

X-API-Keystringobrigatório
Sua chave publicável ou secreta.

Respostas

200Propiedades destacadas
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/properties/featured" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/properties/featured", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/properties/featured",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Resposta · 200 · exemplo
{
  "data": [
    {
      "id": "clx1prop001",
      "code": "P-0042",
      "title": "Apartamento en Chapinero con vista",
      "description": "Apartamento de 85 m² con balcón y vista a los cerros.",
      "type": "APARTMENT",
      "transactionType": "SALE",
      "rentalServiceType": "BROKERAGE",
      "status": "DRAFT",
      "price": "450000000.00",
      "rentPrice": "3500000.00",
      "currency": "COP",
      "adminFee": "380000.00",
      "securityDeposit": "3500000.00",
      "neighborhood": "Chapinero",
      "city": "Bogotá",
      "state": "Cundinamarca",
      "country": "CO",
      "bedrooms": 3,
      "bathrooms": 2,
      "halfBathrooms": 1,
      "parkingSpots": 1,
      "area": 85,
      "builtArea": 80,
      "floor": 8,
      "stratum": 4,
      "yearBuilt": 2015,
      "elevator": true,
      "petFriendly": true,
      "furnished": "UNFURNISHED",
      "amenities": [
        "pool"
      ],
      "virtualTourUrl": "https://my.matterport.com/show/?m=abc123",
      "videoUrl": "https://youtu.be/abc123",
      "tour3dUrl": "https://cdn.bydomu.com/tours/clx1prop001/model.splat",
      "isFeatured": false,
      "viewCount": 128,
      "agentId": "clx1usr001",
      "createdAt": "2026-08-01T14:30:00.000Z",
      "updatedAt": "2026-09-20T10:00:00.000Z",
      "latitude": 4.6486,
  …

A chave vai na variável BYDOMU_API_KEY. Os dados do exemplo não são de nenhuma imobiliária.