Przewodnik integracji

Jak uzyskać dostęp do API Airbnb w 2026 roku (i jak wystartować, zanim go dostaniesz)

Nie ma publicznego API Airbnb, samoobsługowego klucza dla deweloperów ani sandboksa. Airbnb daje dostęp do API tylko partnerom technologicznym, których sam zaprosi. Ten przewodnik wyjaśnia trzy zgody, których potrzebuje każda działająca integracja, o jaki poziom dostępu prosić gospodarzy i jakie cztery opcje naprawdę masz. Napisaliśmy go dla programisty albo foundera, którego właśnie poproszono, żeby „podłączył Airbnb”.

Czy istnieje API Airbnb?

Tak, ale nie takie, do którego można się po prostu zapisać. Airbnb prowadzi API dla partnerów: interfejs REST dla zatwierdzonych firm programistycznych, takich jak systemy do zarządzania obiektami, channel managery i narzędzia do komunikacji z gośćmi, aby ich klienci mogli prowadzić oferty na Airbnb poza airbnb.com.

Przy pełnej autoryzacji może odczytywać i zapisywać:

oferty, treści, zdjęcia, pokoje i udogodnienia
kalendarz: ceny za noc, dostępność, minimalny i maksymalny pobyt, zasady zameldowania i wymeldowania
rezerwacje, zapytania, prośby o rezerwację i zmiany rezerwacji
wiadomości od gości, łącznie z załącznikami
opinie i odpowiedzi na opinie
transakcje wypłat

Czym nie jest: otwartym API z danymi. Nie ma endpointu dla wyników wyszukiwania, ofert innych gospodarzy ani danych rynkowych. Co każdy z tych obszarów może, a czego nie może po połączeniu, opisujemy w artykule API Airbnb: jak działa dostęp i co pozwala zrobić.

Jak zdobyć klucz API Airbnb?

Klucza nie dostajesz. Potrzebujesz trzech zgód od trzech różnych stron, zanim zadziała twój pierwszy zapis.

1. Airbnb zatwierdza twoją firmę

Program partnerski Airbnb ocenia firmę, kategorię produktu (zarządzanie obiektami, wiadomości, pricing) oraz to, jak dbasz o bezpieczeństwo i dane. Zatwierdzenie daje klienta OAuth ograniczonego do tej kategorii.

W 2026 roku nie rozpoczniesz tego sam

Na pytanie „Jak uzyskać dostęp do API Airbnb?” strona dla partnerów Airbnb odpowiada: „At this time, we are not accepting new access requests for our API.” (obecnie nie przyjmujemy nowych wniosków o dostęp do naszego API). Partner managerowie Airbnb sami zgłaszają się do firm, na których im zależy, oceniając ofertę, jaką reprezentują, ich technologię i zdolność do obsługi wspólnych klientów. Planuj tak, jakby te drzwi były zamknięte. Jeśli otworzą się dla ciebie, to dlatego, że zadzwoni Airbnb.

2. Każdy gospodarz autoryzuje twoją aplikację

Zatwierdzenie jako partner pozwala ci jedynie prosić. Każdy gospodarz przechodzi przez ekran zgody Airbnb, wybiera, co twoja aplikacja może robić, i przyznaje tokeny dla swojego konta. Jeden gospodarz, jedna autoryzacja, którą można w każdej chwili cofnąć.

3. Każda oferta zostaje otwarta dla API

Ten krok zaskakuje najczęściej. Autoryzacja konta nie otwiera ofert, które się na nim znajdują. Każda oferta ma własne ustawienie synchronizacji:

Ustawienia synchronizacji poszczególnych ofert w Airbnb
Ustawienie oferty	Co działa
Treść, ceny i dostępność	Wszystko
Tylko ceny i dostępność	Zapisy kalendarza i cen; treść pozostaje w rękach gospodarza
Niepołączona	Każdy zapis jest odrzucany

Dlatego „podłączyliśmy Airbnb, ale ceny nie synchronizują się w trzech z czterdziestu ofert” prawie nigdy nie jest problemem z autoryzacją, a ponowne przeprowadzenie gospodarza przez OAuth nic nie zmienia. Pokazuj ten stan dla każdej oferty w swoim produkcie od pierwszego dnia.

O jaki poziom dostępu powinna prosić twoja aplikacja?

Gospodarze nie przyznają dostępu do „Airbnb” w ogóle. Przyznają jeden z trzech poziomów, a ten, o który poprosisz, decyduje, czy połączenie w ogóle dojdzie do skutku.

Poziomy dostępu Airbnb
Poziom dostępu	Możesz	Do czego
Pełny dostęp (zarządzanie obiektami)	Odczytywać wszystko; zapisywać oferty, kalendarz i ceny	PMS albo channel manager
Wiadomości i opinie	Odczytywać wszystko; wysyłać wiadomości do gości; odpowiadać na opinie	Komunikacja z gośćmi przez AI, wspólna skrzynka, narzędzia do opinii
Tylko odczyt	Odczytywać oferty, rezerwacje, kalendarze, wiadomości i opinie	Analityka, księgowość, raporty przychodów

Pełny dostęp jest wyłączny: jedna aplikacja na konto gospodarza

Konto gospodarza może przyznać zarządzanie obiektami tylko jednej aplikacji naraz. Jeśli gospodarz już korzysta z Hostaway, Guesty, Lodgify albo dowolnego innego PMS, prośba o pełny dostęp kończy się błędem na ekranie zgody, na oczach klienta, którego właśnie wdrażasz.

Połączenia z dostępem do wiadomości i tylko do odczytu działają obok tego PMS, nie dotykając go. Jeśli twój produkt to AI do komunikacji z gośćmi, narzędzie do opinii albo dashboard, proś o najwęższy poziom: łączysz się bez tarcia obok istniejącej konfiguracji gospodarza, a krótszy ekran zgody lepiej konwertuje.

Twoje cztery opcje w 2026 roku

Opcja 1: czekać na Airbnb

Jeśli budujesz pełny PMS z realną ofertą za sobą, warto, żeby zespół partnerski Airbnb cię znał. Tylko nie uzależniaj od tego swojej roadmapy: nie ma wniosku, kolejki ani terminu.

Opcja 2: iCal

Każda oferta na Airbnb eksportuje link iCal. Jest darmowy i nie wymaga zatwierdzenia. Zawiera jednak tylko zablokowane daty: bez imion gości, cen, wiadomości i opinii, a Airbnb odświeża go według własnego harmonogramu. Wystarczy do prywatnego kalendarza; nie do produktu.

Opcja 3: scraping albo automatyzacja przeglądarki

Nie rób tego. Łamie to regulamin Airbnb, ryzyko ponosi konto gospodarza, a całość przestaje działać bez ostrzeżenia, gdy strona się zmieni. Gospodarz, który straci konto przez twoją integrację, już nie wróci.

Opcja 4: integracja przez zatwierdzonego partnera

Firmy z dostępem partnerskim do Airbnb udostępniają go innym zespołom programistycznym przez własne API. Ty wywołujesz ich API, gospodarze łączą się na ekranie zgody Airbnb przez integrację partnera, a ty budujesz swój produkt zamiast czekać.

Co sprawdzić przed wyborem partnera

O jakie poziomy dostępu możesz prosić. Wiadomości i tylko odczyt mają znaczenie, gdy tylko twoi klienci mają już PMS.
Czy działa obok PMS gospodarza. Większość channel managerów tego nie potrafi, bo sama potrzebuje pełnego dostępu.
Webhooki. Nowe wiadomości, rezerwacje i zmiany powinny docierać do ciebie w ciągu sekund, podpisane i z ponawianiem, a nie przy następnym odpytywaniu.
Inne kanały. Twoi klienci są też na Booking.com i Vrbo, a potem na kolejnych kanałach.
Dostęp self-service. Czy możesz dziś dostać klucz produkcyjny i podłączyć prawdziwą ofertę, bez rozmowy z działem sprzedaży i sesji certyfikacyjnej?
Możliwość zapisu dla każdej oferty. Czy mówi ci, w których ofertach Airbnb przyjmie zapisy, zanim je wyślesz?

Główne opcje porównujemy obok siebie, ze źródłami, w artykule Repull w porównaniu: Channex, Rentals United i NextPax.

Jak to działa z Repull

Repull to opcja 4: jedno API dla Airbnb, Booking.com, Vrbo i kolejnych kanałów, a do tego systemy do zarządzania obiektami (PMS), których obsługujemy obecnie 14. Łączysz się przez istniejącą integrację partnerską Repull z Airbnb, więc nie ma o co się ubiegać. Utwórz sesję Connect, wyślij do niej gospodarza i odbierz połączenie:

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

accessType przyjmuje wartość full_access, messaging albo read_only. Jeśli go pominiesz, gospodarz wybierze poziom na stronie zgody. Gospodarz zatwierdza w Airbnb i wraca na twój redirectUrl. Od tej chwili:

# Guest conversations across every connected account
curl 'https://api.repull.dev/v1/conversations?limit=20' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY'

# Reply to a guest. The Idempotency-Key makes a retry safe.
curl -X POST 'https://api.repull.dev/v1/conversations/532457/messages' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY' \
  -H 'Idempotency-Key: reply-532457-1' \
  -H 'Content-Type: application/json' \
  -d '{ "message": "Hi Sam, check-in is from 4pm. The door code arrives on the day." }'

Zasubskrybuj reservation.message.received, a nowe wiadomości od gości trafią na twój serwer jako podpisane webhooki, ponawiane z backoffem, jeśli twój endpoint nie działa. Repull mówi ci też, dla każdej oferty, czy Airbnb przyjmuje zapisy, i odrzuca zapis, o którym wie, że Airbnb go odrzuci, zanim cokolwiek zostanie wysłane:

curl 'https://api.repull.dev/v1/channels/airbnb/listings' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY'

# Each listing carries Airbnb's own per-listing decision:
#   "syncCategory": "sync_all" | "sync_rates_and_availability" | "none"
#   "writable": false when syncCategory is "none"

Obok PMS gospodarza

Booking.com i Vrbo łączą się przez tę samą sesję Connect, obok istniejącego PMS gospodarza albo jako channel manager. Zobacz Korzystanie z Repull obok PMS oraz Łączenie konta Airbnb.

Chcesz, żeby Claude albo ChatGPT pracowały bezpośrednio na koncie Airbnb? Serwer MCP dla Airbnb łączy je przez tę samą integrację, a ten tutorial buduje na nim agenta do komunikacji z gośćmi.

Wypróbuj na prawdziwej ofercie. Plan Free to klucz produkcyjny. Podłącz jedną ze swoich ofert w trybie wiadomości albo tylko odczytu (w ofercie nic się nie zmienia) i zobacz swoje dane w kilka minut. Załóż darmowe konto albo porównaj plany w cenniku.

Najczęstsze pytania

Czy mogę zgłosić się do Airbnb jako partner technologiczny?

Obecnie nie. Na stronie dla partnerów Airbnb pisze, że nie przyjmuje nowych wniosków o dostęp do swojego API, a jego partner managerowie sami zgłaszają się do potencjalnych partnerów, biorąc pod uwagę ofertę, jaką reprezentuje firma, siłę jej technologii i zdolność do obsługi wspólnych klientów. Nie ma formularza do wypełnienia ani kolejki, do której można się zapisać.

Czy istnieje darmowe API Airbnb?

Nie. Airbnb nie sprzedaje ani nie rozdaje kluczy API i nie ma publicznego planu dla deweloperów. Jedyny darmowy eksport bez żadnych zgód to link iCal każdej oferty, który zawiera wyłącznie zablokowane daty.

Czy istnieje sandbox API Airbnb?

Nie. Airbnb nie udostępnia deweloperom ofert testowych ani sandboksa. Integracje testuje się na prawdziwych ofertach, a połączenie z dostępem do wiadomości albo tylko do odczytu to bezpieczny sposób, bo żadne z nich nie może zmienić oferty, jej kalendarza ani cen.

Czy mogę pobierać dane z Airbnb bez zgody gospodarza?

Nie przez żadne legalne API. Każde połączenie autoryzuje gospodarz na ekranie zgody Airbnb, konto po koncie, i może je w każdej chwili cofnąć. Scraping publicznych stron łamie regulamin Airbnb i i tak nie widzi rezerwacji, wiadomości ani wypłat.

Czy moja aplikacja może się połączyć, jeśli gospodarz już korzysta z PMS?

Tak, z dostępem do wiadomości albo tylko do odczytu. Airbnb pozwala tylko jednej aplikacji mieć zarządzanie obiektami (pełny dostęp) na koncie gospodarza, więc prośba o pełny dostęp kończy się błędem, gdy gospodarz już synchronizuje konto z PMS albo channel managerem. Prośby o dostęp do wiadomości i tylko do odczytu wymagają węższych uprawnień i łączą się obok niego.

Dlaczego połączona oferta Airbnb nadal odrzuca zapisy?

Airbnb autoryzuje synchronizację przez API oferta po ofercie. Oferta ustawiona na synchronizację tylko cen i dostępności przyjmuje zapisy kalendarza i cen, ale nie treści, a niepołączona oferta odrzuca każdy zapis. Ponowne przeprowadzenie gospodarza przez OAuth niczego tu nie zmienia; to gospodarz włącza ofertę w Airbnb.

Czy oferta na Airbnb i Booking.com liczy się w Repull podwójnie?

Nie. Oferta liczy się raz, niezależnie od tego, na ilu kanałach jest. Plany i to, co obejmują, znajdziesz na stronie cennika Repull.

Gdzie kończą się możliwości API Airbnb?

Nie ma danych wyszukiwania, danych rynkowych ani dostępu do ofert innych gospodarzy. Sięga tylko do kont, których gospodarze autoryzowali twoją aplikację, a zapisy w ofertach działają tylko w tych, które gospodarz otworzył dla API.

Budujesz na Airbnb na dużą skalę?

Napisz nam, co budujesz, ilu ofert się spodziewasz i jakich kanałów potrzebujesz poza Airbnb. Powiemy ci, jak wygląda integracja i ile kosztuje.

Napisz do nas w sprawie dostępu i cen Przeczytaj szybki start

Czytaj dalej