Guida all'integrazione
Come ottenere l’accesso all’API di Airbnb nel 2026 (e lanciare nel frattempo)
Non esiste un’API pubblica di Airbnb, né una key per sviluppatori self-service, né una sandbox. Airbnb dà accesso alla sua API solo ai partner software che invita. Questa guida spiega i tre permessi di cui ha bisogno ogni integrazione funzionante, quale livello di accesso chiedere agli host e le quattro opzioni che hai davvero. È scritta per l’ingegnere o il founder a cui hanno appena chiesto di «collegare Airbnb».
Esiste un’API di Airbnb?
Sì, ma non una a cui puoi iscriverti. Airbnb gestisce un’API per partner: un’interfaccia REST per aziende software approvate, come sistemi di gestione delle proprietà, channel manager e strumenti di messaggistica, così che i loro clienti possano gestire gli annunci Airbnb fuori da airbnb.com.
Con l’autorizzazione completa può leggere e scrivere:
- annunci, contenuti, foto, camere e servizi
- il calendario: prezzi per notte, disponibilità, soggiorno minimo e massimo, regole di check-in e check-out
- prenotazioni, richieste di informazioni, richieste di prenotazione e modifiche
- messaggi degli ospiti, allegati compresi
- recensioni e risposte alle recensioni
- transazioni dei pagamenti
Cosa non è: un’API di dati aperta. Non c’è un endpoint per i risultati di ricerca, gli annunci di altri host o i dati di mercato. Per sapere cosa può e non può fare ciascuna di queste aree una volta collegato, leggi L’API di Airbnb: come funziona l’accesso e cosa ti permette di fare.
Come ottengo una API key di Airbnb?
Una key non te la danno. Ti servono tre autorizzazioni, da tre soggetti diversi, prima che la tua prima scrittura funzioni.
1. Airbnb approva la tua azienda
Il programma partner di Airbnb valuta l’azienda, la categoria di prodotto (gestione delle proprietà, messaggistica, pricing) e come gestisci sicurezza e dati. Con l’approvazione arriva un client OAuth limitato a quella categoria.
Nel 2026 non puoi avviare tu la procedura
Alla domanda «Come posso accedere all’API di Airbnb?» la pagina partner di Airbnb risponde: “At this time, we are not accepting new access requests for our API.” (al momento non accettiamo nuove richieste di accesso alla nostra API). I suoi partner manager contattano le aziende che vogliono, valutate in base all’offerta che rappresentano, alla loro tecnologia e alla capacità di seguire i clienti in comune. Pianifica come se questa porta fosse chiusa. Se si apre per te, sarà perché ti ha chiamato Airbnb.
2. Ogni host autorizza la tua app
L’approvazione come partner ti permette solo di chiedere. Ogni host passa dalla schermata di consenso di Airbnb, sceglie cosa può fare la tua app e concede i token per il proprio account. Un host, un’autorizzazione, revocabile in qualsiasi momento.
3. Ogni annuncio viene aperto all’API
È il passaggio che sorprende tutti. Autorizzare l’account non apre gli annunci che contiene. Ogni annuncio ha la propria impostazione di sincronizzazione:
| Impostazione dell’annuncio | Cosa funziona |
|---|---|
| Contenuti, tariffe e disponibilità | Tutto |
| Solo tariffe e disponibilità | Scritture su calendario e prezzi; i contenuti restano all’host |
| Non collegato | Ogni scrittura viene rifiutata |
Quindi «abbiamo collegato Airbnb ma i prezzi non si sincronizzano su tre annunci su quaranta» non è quasi mai un problema di autenticazione, e rimandare l’host nel flusso OAuth non cambia niente. Mostra questo stato per annuncio nel tuo prodotto fin dal primo giorno.
Quale livello di accesso deve chiedere la tua app?
Gli host non concedono «Airbnb». Concedono uno di tre livelli, e quello che chiedi decide se la connessione può avvenire o no.
| Livello di accesso | Puoi | Usalo per |
|---|---|---|
| Accesso completo (gestione delle proprietà) | Leggere tutto; scrivere annunci, calendario e prezzi | Un PMS o un channel manager |
| Messaggi e recensioni | Leggere tutto; inviare messaggi agli ospiti; rispondere alle recensioni | Messaggistica con IA, inbox unificata, strumenti per le recensioni |
| Sola lettura | Leggere annunci, prenotazioni, calendari, messaggi e recensioni | Analytics, contabilità, report sui ricavi |
L’accesso completo è esclusivo: una sola app per account host
Un account host può dare la gestione delle proprietà a una sola app alla volta. Se l’host usa già Hostaway, Guesty, Lodgify o un qualsiasi altro PMS, una richiesta di accesso completo fallisce sulla schermata di consenso, davanti al cliente di cui stai facendo l’onboarding.
Le connessioni di messaggistica e di sola lettura convivono con quel PMS senza toccarlo. Se il tuo prodotto è un’IA per la messaggistica con gli ospiti, uno strumento per le recensioni o una dashboard, chiedi il livello più limitato: ti colleghi senza attriti accanto al setup esistente dell’host, e una schermata di consenso più corta converte meglio.
Le tue quattro opzioni nel 2026
Opzione 1: aspettare Airbnb
Se stai costruendo un PMS completo con un’offerta reale alle spalle, vale la pena farti conoscere dal team partner di Airbnb. Ma non far dipendere la tua roadmap da questo: non c’è una candidatura, né una coda, né una tempistica.
Opzione 2: iCal
Ogni annuncio Airbnb esporta un link iCal. È gratuito e non richiede approvazione. Ma contiene solo le date bloccate: niente nomi degli ospiti, niente prezzi, niente messaggi, niente recensioni, e Airbnb lo aggiorna con i suoi tempi. Va bene per un calendario personale; non per un prodotto.
Opzione 3: scraping o automazione del browser
Non farlo. Viola i termini di Airbnb, il rischio ricade sull’account dell’host, e smette di funzionare senza preavviso quando il sito cambia. Un host che perde l’account per colpa della tua integrazione non torna.
Opzione 4: integrarti tramite un partner approvato
Le aziende con accesso partner di Airbnb lo offrono ad altri team software tramite la propria API. Tu chiami la loro API, gli host si collegano sulla schermata di consenso di Airbnb tramite l’integrazione del partner, e tu costruisci il tuo prodotto invece di aspettare.
Cosa verificare prima di scegliere un partner
- Quali livelli di accesso puoi richiedere. Messaggistica e sola lettura contano non appena i tuoi clienti hanno già un PMS.
- Se funziona accanto al PMS dell’host. La maggior parte dei channel manager non può, perché ha bisogno essa stessa dell’accesso completo.
- Webhook. Nuovi messaggi, prenotazioni e modifiche dovrebbero arrivarti in pochi secondi, firmati e con retry, non al tuo prossimo polling.
- Altri canali. I tuoi clienti sono anche su Booking.com e Vrbo, e poi su altri canali ancora.
- Accesso self-service. Puoi ottenere una key live e collegare un annuncio reale oggi, senza una call commerciale né una sessione di certificazione?
- Scrivibilità per annuncio. Ti dice su quali annunci Airbnb accetterà le scritture, prima che tu le invii?
Confrontiamo le principali opzioni fianco a fianco, con le fonti, in Repull a confronto: Channex, Rentals United e NextPax.
Come funziona con Repull
Repull è l’opzione 4: un’unica API per Airbnb, Booking.com, Vrbo e altri canali, più 14 sistemi di gestione delle proprietà. Ti colleghi tramite l’integrazione partner di Airbnb che Repull ha già, quindi non c’è nulla da richiedere. Crea una sessione Connect, manda l’host lì e ricevi indietro una connessione:
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 è full_access, messaging o read_only. Se lo ometti, è l’host a scegliere il livello nella pagina di consenso. L’host approva su Airbnb e torna al tuo redirectUrl. Da lì in poi:
# 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." }'Iscriviti a reservation.message.received e i nuovi messaggi degli ospiti arrivano al tuo server come webhook firmati, ritentati con backoff se il tuo endpoint non risponde. Repull ti dice anche, per ogni annuncio, se Airbnb accetta le scritture, e rifiuta una scrittura che sa che Airbnb respingerà prima di inviare qualsiasi cosa:
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"Accanto al PMS dell’host
Booking.com e Vrbo si collegano con la stessa sessione Connect, accanto al PMS esistente dell’host oppure come channel manager. Vedi Usare Repull accanto a un PMS e Collegare un account Airbnb.
Vuoi che Claude o ChatGPT lavorino direttamente con un account Airbnb? Il server MCP di Airbnb li collega tramite la stessa integrazione, e questo tutorial ci costruisce sopra un agente per la messaggistica con gli ospiti.
Provalo su un annuncio reale. Il piano Free è una key live. Collega uno dei tuoi annunci in modalità messaggistica o sola lettura (sull’annuncio non cambia nulla) e vedi i tuoi dati in pochi minuti. Crea un account gratuito, oppure confronta i piani nella pagina prezzi.
Domande frequenti
Posso candidarmi come partner software di Airbnb?
Al momento no. La pagina partner di Airbnb dice che non accetta nuove richieste di accesso alla sua API, e che i suoi partner manager contattano i potenziali partner in base all’offerta che un’azienda rappresenta, alla solidità della sua tecnologia e alla capacità di seguire i clienti in comune. Non c’è un modulo da compilare né una coda in cui mettersi.
Esiste un’API di Airbnb gratuita?
No. Airbnb non vende né regala API key, e non esiste un piano pubblico per sviluppatori. L’unica esportazione gratuita e senza autorizzazioni è il link iCal di ogni annuncio, che contiene solo le date bloccate.
Esiste una sandbox per l’API di Airbnb?
No. Airbnb non offre annunci di test né una sandbox agli sviluppatori. Le integrazioni si testano su annunci reali, e una connessione di messaggistica o di sola lettura è il modo sicuro per farlo, perché nessuna delle due può modificare un annuncio, il suo calendario o i suoi prezzi.
Posso ottenere dati di Airbnb senza il permesso dell’host?
Non tramite un’API legittima. Ogni connessione viene autorizzata dall’host sulla schermata di consenso di Airbnb, un account alla volta, e l’host può revocarla. Lo scraping delle pagine pubbliche viola i termini di Airbnb e comunque non vede prenotazioni, messaggi o pagamenti.
La mia app può collegarsi se l’host usa già un PMS?
Sì, con accesso di messaggistica o di sola lettura. Airbnb consente a una sola app di avere la gestione delle proprietà (accesso completo) su un account host, quindi una richiesta di accesso completo fallisce quando l’host sincronizza già con un PMS o un channel manager. Le richieste di messaggistica e di sola lettura chiedono permessi più limitati e si collegano accanto.
Perché un annuncio Airbnb collegato rifiuta ancora le scritture?
Airbnb autorizza la sincronizzazione via API annuncio per annuncio. Un annuncio impostato per sincronizzare solo tariffe e disponibilità accetta scritture su calendario e prezzi ma non sui contenuti, e un annuncio non collegato rifiuta qualsiasi scrittura. Rimandare l’host nel flusso OAuth non cambia nulla; è l’host che attiva l’annuncio su Airbnb.
Un annuncio su Airbnb e Booking.com conta due volte su Repull?
No. Un annuncio conta una volta sola, su qualunque canale si trovi. I piani e cosa includono sono sulla pagina prezzi di Repull.
Dove si ferma l’API di Airbnb?
Non ha dati di ricerca, né dati di mercato, né accesso agli annunci di altri host. Raggiunge solo gli account i cui host hanno autorizzato la tua app, e le scritture sugli annunci funzionano solo su quelli che l’host ha aperto all’API.
Costruisci su Airbnb su larga scala?
Raccontaci cosa stai costruendo, quanti annunci prevedi e di quali canali hai bisogno oltre ad Airbnb. Ti diremo come sarebbe l’integrazione e quanto costa.
Continua a leggere
- L’API di Airbnb: come funziona l’accesso e cosa ti permette di fare
- Server MCP di Airbnb: collega Claude, ChatGPT e Cursor a un account Airbnb
- Repull a confronto con Channex, Rentals United e NextPax
- L’API di Booking.com: come funziona l’accesso
- L’API di Vrbo: cosa puoi costruire
- Come ottenere l’accesso all’API di Booking.com nel 2026
- Come ottenere l’accesso all’API di Vrbo nel 2026