API pública

Todos los endpoints son de solo lectura, se pueden usar sin registro y devuelven JSON con CORS abierto. El punto de entrada para asistentes de IA e integraciones es /api/v1/apartments: una consulta responde qué apartamentos están libres en un periodo — incluidos precios, superficie, dirección y enlace a la página de detalle. Resumen legible por máquinas del sitio: /llms.txt.

Endpoints

Respuesta: búsqueda por periodo

GET /api/v1/apartments?from=2026-08-01&to=2026-08-15 — ejemplo abreviado:

{
  "provider": "apartments.zuerich",
  "from": "2026-08-01",
  "to": "2026-08-15",
  "nights": 14,
  "mode": "short_term",
  "count": 5,
  "apartments": [
    {
      "slug": "badenerstrasse-4101",
      "icalSlug": "4101",
      "name": "Business Apartment 4101",
      "description": "Business-Studio im 1. Stock an der Badenerstrasse 414 …",
      "type": "studio",
      "typeName": "Studio",
      "quartier": "kreis-4",
      "quartierName": "Kreis 4, Badenerstrasse",
      "address": { "street": "Badenerstrasse 414", "zip": "8004", "city": "Zürich" },
      "coordinates": { "lat": 47.3775, "lng": 8.4892 },
      "sizeM2": 38,
      "rooms": 1,
      "maxGuests": 2,
      "floor": 1,
      "features": ["Voll ausgestattete Küche", "Smart TV", "Highspeed WLAN"],
      "prices": {
        "currency": "CHF",
        "night": 95,
        "month": 2190,
        "longTerm": 2090,
        "cleaningFee": 50
      },
      "url": {
        "de": "https://www.apartments.zuerich/de/wohnungen/badenerstrasse-4101/",
        "en": "https://www.apartments.zuerich/en/apartments/badenerstrasse-4101/"
      },
      "image": "https://www.apartments.zuerich/_astro/wohnzimmer.CVxq6Kk3.jpg"
    }
  ],
  "unavailable": [
    { "slug": "algier-15-studio", "name": "Studio AL15-1", "url": { "de": "…", "en": "…" } }
  ],
  "incomplete": [],
  "combinations": [
    {
      "switches": 1,
      "switchDate": "2026-08-08",
      "segments": [
        { "slug": "badenerstrasse-4404", "icalSlug": "4404", "name": "Business Apartment 4404",
          "from": "2026-08-01", "to": "2026-08-08", "nights": 7, "url": { "de": "…", "en": "…" } },
        { "slug": "badenerstrasse-4101", "icalSlug": "4101", "name": "Business Apartment 4101",
          "from": "2026-08-08", "to": "2026-08-15", "nights": 7, "url": { "de": "…", "en": "…" } }
      ]
    }
  ],
  "warnings": []
}

Respuesta: ventanas libres (sin parámetros)

Sin from/to, cada apartamento contiene además un objeto availability con las próximas ventanas libres (end es exclusivo; null = abierto hasta el horizonte de datos):

"availability": {
  "offered": { "shortTerm": true, "midTerm": true, "longTerm": false },
  "windows": [{ "start": "2026-08-03", "end": "2026-09-01", "days": 29 }],
  "shortTermFreeDays": 12,
  "midTermAvailableFrom": "2026-08-03",
  "longTermFreeFrom": null
}

Exportación CSV (?format=csv)

Con ?format=csv, /api/v1/apartments devuelve una tabla CSV plana en lugar de JSON — una fila por apartamento, pensada para hojas de cálculo. Ambos modos (búsqueda por periodo y ventanas) admiten el parámetro. Columnas base en orden estable:

slug, name, description, type, type_name, quartier, quartier_name,
street, zip, city, lat, lng, size_m2, rooms, max_guests, floor, features,
price_night, price_month, price_long_term, cleaning_fee, listing_status,
url_de, url_en

• Modo periodo (con from/to): además la columna status (available, unavailable o incomplete) — todos los apartamentos aparecen en una tabla.
• Modo ventanas (sin parámetros): además incomplete así como next_window_from y next_window_to (solo la próxima ventana libre; final abierto = to vacío), short_term_free_days, mid_term_available_from y long_term_free_from.
• Lo anidado se aplana: features unidas con ;, precios como columnas individuales en CHF; warnings se omiten en el CSV.

Google Sheets (IMPORTDATA)

Inserte la fórmula en cualquier celda — Google Sheets carga la tabla directamente y la actualiza periódicamente por sí solo:

=IMPORTDATA("https://www.apartments.zuerich/api/v1/apartments?from=2026-08-01&to=2026-08-15&format=csv")

Interpretar correctamente los precios

• Estancia corta (mode short_term, por debajo de 28 noches): valor orientativo = night × nights + cleaningFee.
• Alojamiento temporal (a partir de 28 noches): precio mensual month, a partir de 3 meses el precio reducido a largo plazo longTerm.
• Todos los precios en CHF y sin compromiso — es determinante la oferta a través de la solicitud de reserva en la página de detalle.

Actualidad y caché

• La disponibilidad llega en tiempo real del sistema de reservas; las respuestas se almacenan en caché hasta 60 segundos (navegador) y 300 segundos (edge CDN).
• Las respuestas de error nunca se almacenan en caché.

Ejemplos

curl

curl -s 'https://www.apartments.zuerich/api/v1/apartments?from=2026-08-01&to=2026-08-15' | jq '.apartments[].name'

JavaScript

const res = await fetch(
  "https://www.apartments.zuerich/api/v1/apartments?from=2026-08-01&to=2026-08-15"
);
const data = await res.json();
for (const apartment of data.apartments) {
  console.log(apartment.name, apartment.prices?.night, "CHF/Nacht", apartment.url.de);
}

CORS

Todos los endpoints envían Access-Control-Allow-Origin: * — la API se puede consultar directamente desde el navegador, desde scripts y desde agentes de IA.

Versionado

Los endpoints bajo /api/v1/ son estables: se pueden añadir campos, los campos existentes no cambian ni desaparecen sin una nueva versión.