La API de Vrbo: cómo funciona el acceso y qué puedes construir hoy

Vale la pena aclarar la confusión, porque de ahí viene la mayor parte de la mala información. Vrbo está dentro de Expedia Group, y Expedia Group tiene varias superficies para desarrolladores que no son lo mismo. La que importa si gestionas alquileres vacacionales o creas software para ellos es la conectividad propia de Vrbo: la integración que usa el software de un gestor para mantener tarifas, disponibilidad y reservas alineadas con Vrbo. Una página que te dice que consigas una clave de la API de Vrbo en diez minutos está describiendo otra cosa.

• Anuncios: detalles del anuncio, tarifas, configuración del alojamiento y disponibilidad.
• Reserva online: generar presupuestos, comprobar disponibilidad, reservar y actualizar registros de reserva.
• Reseñas: compartir reseñas de la propiedad para mostrarlas en Vrbo.
• Consultas: recuperar las consultas de alquiler enviadas a través de Vrbo.

Expedia Group describe el resultado con claridad: con conectividad por API, las tarifas, la disponibilidad y las reservas se actualizan de forma dinámica de tu software a Vrbo, y los precios, los calendarios y las políticas de cancelación se controlan desde tu software en lugar de desde la extranet de Vrbo. La dirección importa: la conectividad de Vrbo está pensada para que tu sistema sea la fuente de verdad y envíe los datos, un modelo mental distinto del OAuth de petición y consentimiento de Airbnb.

curl -X POST https://api.repull.dev/v1/connect \
  -H 'Authorization: Bearer sk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "redirectUrl": "https://yourapp.com/connected",
    "allowedProviders": ["vrbo-login"],
    "accessType": "messaging"
  }'

# Send the host to the returned url. They sign in with their Vrbo
# account and map their units; the import starts when they confirm.

curl 'https://api.repull.dev/v1/channels/vrbo/reservations?limit=50' \
  -H 'Authorization: Bearer sk_live_...'

# Page with the cursor from pagination.nextCursor.
# ?offset= is accepted as a first-class alias for shallow paging.

Los endpoints de canal responden a “qué tiene Vrbo”. Para todo lo que vayas a enseñar a una persona —el huésped, el pago, la política con la que se reservó la estancia—, lee la superficie entre canales, donde una reserva de Vrbo llega con la misma forma que una de Airbnb.

# The same reservation, with everything on it, from the
# cross-channel read — guest, price breakdown, policy code.
curl 'https://api.repull.dev/v1/reservations?platform=vrbo&limit=50' \
  -H 'Authorization: Bearer sk_live_...'

# Conversations and reviews take the same filter:
#   /v1/conversations?platform=vrbo
#   /v1/reviews?platform=vrbo
# Properties filters on the channel it is published to:
#   /v1/properties?channel=vrbo

• Importación. No se importa nada hasta que el anfitrión asigna sus unidades. Después llegan primero las próximas reservas y los mensajes de los últimos 30 días, y el resto del historial sigue en segundo plano.
• Paginación. Los dos endpoints se paginan por cursor; ?offset= se acepta para paginación poco profunda y es incompatible con cursor.
• Anuncios inactivos. Un anuncio desactivado sigue sincronizándose, pero desaparece de estas lecturas, recuentos y cursores incluidos. Encuéntralos con GET /v1/listings?status=inactive.
• Crear reservas. POST /v1/reservations está limitado a direct, website y owner. Una estancia de Vrbo pertenece al canal y llega por sincronización; crearla en local solo chocaría con la siguiente sincronización.

A fondo sobre los otros dos: la guía de la API de Airbnb y la guía de la API de Booking.com.

Merece la pena concretar la diferencia, porque “usaremos iCal y ya” es una decisión de la que los equipos se arrepienten a los dos meses. Un feed de calendario te da un rango de fechas y una etiqueta. No te dice quién reservó, cuánto pagó, qué preguntó en el hilo de mensajes, qué política aplica si cancela ni si el precio del anuncio sigue siendo el que querías cobrar. Todo eso está detrás de la conectividad.

• Una bandeja de entrada unificada o un asistente IA que responde a huéspedes y consultas de Vrbo junto a Airbnb y Booking.com, sin que el anfitrión cambie de PMS.
• Un único feed de reservas al que no le falta un canal: las reservas de Vrbo llegan con la misma forma normalizada que las de Airbnb y Booking.com.
• Informes de ocupación, ADR e ingresos en los que la parte de Vrbo se cuenta de verdad en lugar de estimarse.
• Un CRM de huéspedes que reconoce al mismo huésped en todos los canales en lugar de crear un tercer perfil.
• Gestión de reseñas de Vrbo, Airbnb y Booking.com desde un solo sitio.
• Liquidaciones a propietarios que cuadran, porque las estancias de Vrbo están en el mismo libro que todo lo demás.

Empieza por la documentación, o lee cómo se aplica el mismo razonamiento a los otros dos grandes canales en las guías de Airbnb y Booking.com. Si eres una plataforma SaaS que va a poner esto delante de sus propios clientes, la parte comercial está en Repull para plataformas, y la versión técnica más profunda en las preguntas y respuestas para plataformas SaaS.