Public Property API
Acceso público de sólo lectura al inventario publicado. Sin clave, sin datos personales.
Endpoints
GET/api/public/properties
Listado paginado de propiedades publicadas. Alias: /properties.json.
https://www.belga.com.ar/api/public/properties?operation=venta&property_type=casa&neighborhood=belgrano-r&bedrooms_min=3&pool=true&price_max=850000
GET/api/public/properties/{id}
Ficha completa: descripción, fotos, superficies y características.
GET/api/public/search
Devuelve exact_matches y, por separado, alternatives en nearby_area, budget_stretch, fewer_bedrooms y feature_compromise. Las alternativas nunca se mezclan con las coincidencias exactas e indican siempre alternative_reason.
GET/api/public/meta
Valores válidos de operación, tipo, barrio, características y orden.
GET/api/openapi.json
Descripción OpenAPI 3.1 de todos los accesos públicos.
Estados
active · reserved · sold · rented · inactive
El sistema de publicaciones entrega únicamente propiedades activas, por lo que hoy todas las fichas devuelven status: "active". Usá sólo esas para búsquedas actuales.
Filtros
operation, property_type, neighborhood (varios separados por coma), q, rooms_min/max, bedrooms_min/max, bathrooms_min, garages_min, price_min/max, currency, covered_m2_min/max, total_m2_min/max, land_m2_min/max, page, limit (máx. 100) y sort (price_asc, price_desc, updated_desc).
Características booleanas: pool, garden, patio, terrace, balcony, grill, quincho, garage, storage, sum, gym, security, amenities, laundry, air_conditioning, heating, furnished, professional_use, mortgage_eligible, pet_friendly, brand_new, bright, open_view.
Los precios se expresan en unidades completas y en USD. Las superficies en m².
Límites
300 consultas por minuto por IP. Respuestas cacheadas 5 minutos. CORS abierto.
Permitimos la lectura automatizada razonable y la cita con atribución y enlace. No permitimos la extracción masiva para republicar el catálogo.