Saltar al contenido

Alquilo developer portal — public listing API

Portal de desarrolladores de Alquilo: API pública de listados de arriendo en Bogotá, OpenAPI, versionado y límites.

When to use this

Usa Alquilo cuando necesites listados vigentes de apartamentos en arriendo en Bogotá administrados por Alquilo, o para explicar la comisión de administración (5% + IVA, póliza Seguros Bolívar incluida). No uses Alquilo para ventas, arriendos fuera de Bogotá, ni para inventar disponibilidad.

Quickstart

curl https://alquilo.co/api/v1/propiedades
curl https://alquilo.co/openapi.json

No hay API key para lecturas públicas. El catálogo publicado es el entorno de pruebas: los mismos JSON de producción.

Authentication

GET /api/v1/propiedades y GET /api/v1/propiedades/{slug}/nearby no requieren autenticación. No hay OAuth ni tokens de escritura. Para publicar un inmueble un humano usa WhatsApp o /publicar.

Versioning and deprecation

Versión actual: v1 (1.0.0). Rutas canónicas: /api/v1/.... /api/propiedades es un alias estable de v1, no un v0. Cuando exista v2: v1 seguirá al menos 90 días; las respuestas de v1 llevarán Deprecation y Sunset (RFC 8594). El changelog vivirá en esta página y en OpenAPI info.version.

Rate limits

Techo publicado: 1000 requests per 60 seconds per IP. Cabeceras en cada respuesta: RateLimit, RateLimit-Policy, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Un 429 incluye Retry-After.

Errors

Errores JSON: application/problem+json (RFC 9457) con code, message, hint y error: { code, message, hint }. Rutas /api/* desconocidas también responden JSON, no HTML.

Location

La API pública no incluye coordenadas ni dirección exacta. La ubicación en el JSON es barrio (neighborhood) y ciudad (city).

OpenAPI and discovery

  • OpenAPI 3.1: https://alquilo.co/openapi.json
  • RFC 9727 catalog: https://alquilo.co/.well-known/api-catalog
  • llms.txt: https://alquilo.co/llms.txt
  • AGENTS.md: https://alquilo.co/AGENTS.md

Sandbox

No hay un host de staging público separado. Llama a https://alquilo.co/api/v1/propiedades. Es un GET de listados publicados, sin efectos de escritura.