Developers

API pública REST

Todo el inventario del buscador está disponible como JSON en el edge, con CORS abierto, cache en el CDN y paginación estable. Ideal para integrar portales, apps, chatbots o tableros de datos.

Base URL https://real-estate-broker.pages.dev/api

Endpoints

GET /api/health

Healthcheck del servicio. Devuelve estado, versión y uptime.

GET /api/properties

Listado de publicaciones con filtros, ordenamiento y paginación.

GET /api/properties/{id}

Detalle de una publicación por id (p001) o slug.

POST /api/leads

Recepción de consultas (leads) de contacto desde portales terceros.

Parámetros de búsqueda

Aplican a GET /api/properties y a los resultados del buscador web.

Parámetro	Tipo	Descripción
operacion	string	venta \| alquiler
tipo	string	departamento \| casa \| ph \| terreno \| oficina \| local (repetible o coma-separado)
zona	string	Nombre de zona, case-insensitive (repetible o coma-separado)
ambientes	number	Cantidad exacta de ambientes (1–10)
precio_min	number	Precio mínimo
precio_max	number	Precio máximo
superficie_min	number	Superficie total mínima en m²
orden	string	recientes \| precio-asc \| precio-desc \| superficie-desc
page	number	Página (default 1)
limit	number	Resultados por página (default 12, máx. 48)

Ejemplo

GET /api/properties?operacion=venta&tipo=departamento&zona=palermo&ambientes=3&precio_max=200000&orden=precio-asc&page=1

{
  "ok": true,
  "data": [
    {
      "id": "p001",
      "slug": "departamento-venta-palermo-3-ambientes",
      "titulo": "Departamento luminoso de 3 ambientes con balcón",
      "operacion": "venta",
      "tipo": "departamento",
      "precio": 189000,
      "moneda": "USD",
      "expensas": 95000,
      "ambientes": 3,
      "dormitorios": 2,
      "banios": 1,
      "superficieTotal": 78,
      "zona": "Palermo",
      "localidad": "CABA",
      "lat": -34.5885,
      "lng": -58.4269,
      "imagenes": ["/images/properties/depto-exterior.svg"],
      "inmobiliaria": {
        "nombre": "Nueva Espacio Propiedades",
        "telefono": "+54 11 4832-1000",
        "email": "contacto@nuevaespacio.example.com"
      }
    }
  ],
  "meta": { "total": 1, "page": 1, "limit": 12, "totalPages": 1 },
  "links": { "self": "...", "first": "..." }
}

Errores

404 NOT_FOUND El id o slug solicitado no existe.

400 VALIDATION_ERROR Datos inválidos en el cuerpo del request.

400 INVALID_JSON El body no es JSON válido.

Consideraciones

CORS habilitado con Access-Control-Allow-Origin: * para lectura pública.
Las respuestas de listado se cachean 60 s en el cliente y 300 s en el edge (Cloudflare).
Límite máximo de 48 resultados por página para mantener latencias bajas.
En el roadmap: autenticación por API key con rate limiting y webhooks de sincronización.

¿Querés el motor completo con tu marca? Conocé el ERP white-label.

Ver propuesta para inmobiliarias