---
title: "Alquilo developer portal — public listing API"
description: "Alquilo developer resources: OpenAPI, API v1, authentication, versioning, rate limits and sandbox."
canonical: https://alquilo.co/developers.md
last_updated: "2026-08-24"
---

# 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

```bash
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.

## Sitemap

Índice markdown: [sitemap.md](https://alquilo.co/sitemap.md). HTML: [sitemap.xml](https://alquilo.co/sitemap.xml).