Die Vrbo-API: wie der Zugang funktioniert und was du heute bauen kannst

Die Verwirrung lohnt eine Erklärung, denn von dort kommen die meisten falschen Informationen. Vrbo gehört zur Expedia Group, und die Expedia Group betreibt mehrere Entwickler-Schnittstellen, die nicht dasselbe sind. Die, auf die es ankommt, wenn du Ferienunterkünfte verwaltest oder Software für sie baust, ist die eigene Konnektivität von Vrbo – die Integration, mit der die Software eines Verwalters Preise, Verfügbarkeit und Buchungen mit Vrbo synchron hält. Eine Seite, die dir einen Vrbo-API-Schlüssel in zehn Minuten verspricht, beschreibt etwas anderes.

• Inserate – Inseratsdetails, Mietpreise, Unterkunftskonfiguration und Verfügbarkeit.
• Online-Buchung – Angebote erstellen, Verfügbarkeit prüfen, buchen, Buchungsdatensätze aktualisieren.
• Bewertungen – Unterkunftsbewertungen zur Anzeige auf Vrbo teilen.
• Anfragen – über Vrbo gestellte Mietanfragen abrufen.

Die Expedia Group beschreibt das Ergebnis schlicht: Mit API-Konnektivität aktualisieren sich Preise, Verfügbarkeit und Buchungen dynamisch von deiner Software zu Vrbo, und Preise, Kalender und Stornierungsbedingungen werden in deiner Software statt im Vrbo-Extranet gesteuert. Die Richtung zählt – Vrbo-Konnektivität ist darauf ausgelegt, dass dein System die maßgebliche Quelle ist und Daten schickt, ein anderes Denkmodell als Airbnbs OAuth mit Anfrage und Zustimmung.

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.

Die Kanal-Endpunkte beantworten „was hat Vrbo“. Für alles, was du einem Menschen zeigen würdest – den Gast, die Auszahlung, die Bedingungen, unter denen der Aufenthalt gebucht wurde –, lies stattdessen die kanalübergreifende Schnittstelle, wo eine Vrbo-Buchung in derselben Form ankommt wie eine von 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

• Import. Es wird nichts importiert, bis der Gastgeber seine Einheiten zuordnet. Dann kommen zuerst die anstehenden Buchungen und die Nachrichten der letzten 30 Tage, der Rest der Historie folgt im Hintergrund.
• Paginierung. Beide Endpunkte sind per Cursor paginiert; ?offset= wird für flaches Blättern akzeptiert und schließt cursor aus.
• Inaktive Inserate. Ein deaktiviertes Inserat synchronisiert weiter, fällt aber aus diesen Abfragen heraus, Zählungen und Cursor eingeschlossen. Du findest sie mit GET /v1/listings?status=inactive.
• Buchungen anlegen. POST /v1/reservations ist auf direct, website und owner beschränkt. Ein Vrbo-Aufenthalt gehört dem Kanal und kommt per Synchronisierung; ihn lokal anzulegen würde nur gegen die nächste Synchronisierung kämpfen.

Ausführlich zu den anderen beiden: der Leitfaden zur Airbnb-API und der Leitfaden zur Booking.com-API.

Die Lücke lohnt sich konkret zu benennen, denn „wir nehmen einfach iCal“ ist eine Entscheidung, die Teams nach zwei Monaten bereuen. Ein Kalender-Feed gibt dir einen Datumsbereich und ein Etikett. Er sagt dir nicht, wer gebucht hat, was er bezahlt hat, was er in der Unterhaltung gefragt hat, welche Bedingungen gelten, wenn er storniert, oder ob der Preis im Inserat noch der ist, den du verlangen wolltest. All das liegt hinter der Konnektivität.

• Ein gemeinsamer Posteingang oder KI-Assistent, der Vrbo-Gästen und -Anfragen neben Airbnb und Booking.com antwortet – ohne dass der Gastgeber das PMS wechselt.
• Ein einziger Buchungs-Feed, dem kein Kanal fehlt – Vrbo-Buchungen kommen in derselben normalisierten Form an wie die von Airbnb und Booking.com.
• Auslastungs-, ADR- und Umsatzberichte, in denen der Vrbo-Anteil tatsächlich gezählt statt geschätzt wird.
• Ein Gäste-CRM, das denselben Gast über alle Kanäle erkennt, statt ein drittes Profil anzulegen.
• Bewertungsmanagement für Vrbo, Airbnb und Booking.com an einem Ort.
• Eigentümerabrechnungen, die aufgehen, weil die Vrbo-Aufenthalte im selben Buch stehen wie alles andere.

Fang mit der Doku an, oder lies in den Leitfäden zu Airbnb und Booking.com, wie dieselbe Logik für die anderen beiden großen Kanäle gilt. Wenn du eine SaaS-Plattform bist und das deinen eigenen Kunden anbieten willst, steht der geschäftliche Rahmen in Repull für Plattformen, die technische Tiefe in den Fragen und Antworten für SaaS-Plattformen.