API di Airbnb
Confronta gli alloggi per affitti brevi in base a servizi, profili degli host, recensioni degli ospiti e disponibilità giornaliera per scegliere dove soggiornare.
Cerca per destinazione oppure usa l'URL di una struttura o di un host per ottenere un singolo record. La disponibilità del calendario non garantisce la prenotazione.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su airbnb e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 5 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Airbnb: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Trova alloggi Airbnb per una destinazione indicata in keyword, con filtri facoltativi per valuta, lingua e fascia di prezzo. | Normale | |
Dettagli dell'immobileproperty_detail | Leggi un annuncio Airbnb dal suo link /rooms/ o dall'ID della struttura. | Normale | |
Recensionireviews | Recupera le recensioni degli ospiti di un annuncio Airbnb. | Normale | |
Profili degli hosthost | Consulta il profilo di un host Airbnb a partire dal link al profilo o dall'ID host. | Normale | |
Calendario delle disponibilitàcalendar | Controlla la disponibilità giorno per giorno di un annuncio Airbnb. | Normale |
Cosa accetta ogni azione di API di Airbnb?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Trova alloggi Airbnb per una destinazione indicata in | keyword | currency, lang, locale, max_price, min_price | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · text · property_type · person_capacity · price · rating · rating_scale · review_count · lat · lng · location · host_name · amenities · image_url · check_in · check_out · platform | |
property_detailDettagli dell'immobile Leggi un annuncio Airbnb dal suo link /rooms/ o dall'ID della struttura. Ottieni tipo di alloggio, numero di ospiti, camere da letto, letti, bagni, servizi, valutazione e host. Il filtro facoltativo | url | city, max_price, min_price | — | id · url · title · text · property_type · room_type · person_capacity · bedrooms · bathrooms · beds · location · lat · lng · rating · rating_scale · review_count · price · currency · host_name · is_superhost · amenities · platform | |
reviewsRecensioni Recupera le recensioni degli ospiti di un annuncio Airbnb. Ogni recensione include testo, valutazione, data, lingua, nome e località di chi l'ha scritta ed eventuale risposta dell'host. Puoi filtrare per lingua, per data con | url | lang, locale, since, sort | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · text · rating · rating_scale · posted_at · language · author_name · author_location · response · platform | |
hostProfili degli host Consulta il profilo di un host Airbnb a partire dal link al profilo o dall'ID host. Ottieni nome, bio, lingue, valutazione, stato di Superhost, data di iscrizione e numero di annunci. Passa un link /users/show/ o un ID host, non l'ID di un annuncio. Il profilo non verifica l'identità dell'host. | url | — | — | id · url · name · text · avatar_url · languages · listing_count · rating · rating_scale · review_count · is_superhost · joined_at · listing_urls · platform | |
calendarCalendario delle disponibilità Controlla la disponibilità giorno per giorno di un annuncio Airbnb. Per ogni data trovi la disponibilità per check-in e check-out, il numero minimo e massimo di notti e il prezzo. Senza date, l'intervallo parte da oggi e copre 30 giorni. La lettura del calendario non blocca né prenota mai un soggiorno. | url | check_in, check_out, end_date, since, start_date, until | — | id · date · available · available_for_checkin · available_for_checkout · bookable · min_nights · max_nights · price · currency · platform |
Cosa significano i parametri search di API di Airbnb?
Trova alloggi Airbnb per una destinazione indicata in keyword, con filtri facoltativi per valuta, lingua e fascia di prezzo. Ogni riga riporta tipo di struttura, numero di ospiti, prezzo e valutazione così come vengono mostrati, ma non conferma la disponibilità per date specifiche.
keywordObbligatorio- Specifica la località, la città, la regione o il nome della destinazione (ad esempio Tokyo) per l'azione search. Passa il nome di un luogo, non lo username di un host o l'ID di un alloggio.
currencyFacoltativo- Specifica la valuta in cui visualizzare i prezzi degli annunci nei risultati di ricerca di Airbnb (predefinita USD; vedi i valori consentiti). Questa impostazione cambia la valuta in cui sono espressi i prezzi degli alloggi, ma non modifica l'addebito delle richieste API di EveryInfra né la valuta del portafoglio.Valori ammessi:
aedaudbgnbrlcadchfclpcnycopcrcczkdkkegpeurgbpghshkdhrkhufidrilsinrjpykeskrwkztmadmxnmyrnoknzdpenphpplnqarronsarseksgdthbtrytwduahugxusduyuvndzar langFacoltativo- Specifica la combinazione di lingua e regione con codici compatti come enus per en-US, zhcn per zh-CN o jajp per ja-JP. Passa esattamente uno dei valori consentiti elencati, non codici di lingua generici di due lettere come en.Valori ammessi:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeFacoltativo- Imposta la lingua e l'area di visualizzazione delle pagine di Airbnb (predefinita en-US), ad esempio en-US o zh-CN. Non passare locale insieme a lang: lang ha la precedenza e sovrascrive la lingua selezionata. Questo parametro non filtra le recensioni in base alla nazionalità di chi le scrive.
max_priceFacoltativo- Imposta il filtro sul prezzo massimo dell'alloggio come valore numerico. Deve essere maggiore o uguale a min_price. Serve a filtrare i risultati di ricerca, non a limitare il costo delle singole richieste API o il budget complessivo per l'alloggio. Il filtro usa numeri interi: i decimali vengono arrotondati per eccesso (145.98 diventa 146).
min_priceFacoltativo- Imposta il filtro sul prezzo minimo dell'alloggio come valore numerico, insieme a max_price. Questo parametro filtra i risultati di ricerca degli annunci e non imposta un limite all'uso dell'API. Il filtro usa numeri interi: i decimali vengono arrotondati per difetto (39.81 diventa 39).
Cosa significano i parametri property_detail di API di Airbnb?
Leggi un annuncio Airbnb dal suo link /rooms/ o dall'ID della struttura. Ottieni tipo di alloggio, numero di ospiti, camere da letto, letti, bagni, servizi, valutazione e host. Il filtro facoltativo city e quelli di prezzo non lo trasformano in una ricerca né in un preventivo di prenotazione.
urlObbligatorio- Identifica la risorsa di destinazione in base all'azione: passa un URL /rooms/<property_id> o l'ID dell'alloggio per property_detail, reviews o calendar, oppure un URL /users/show/<host_id> o l'ID dell'host per host. Gli identificatori di alloggi e host non sono intercambiabili.Airbnb: recensioni degli annunci e limiti di visibilità — Airbnb distingue le recensioni pubbliche e le valutazioni complessive a stelle dalle valutazioni per categoria, visibili solo agli host e alla piattaforma. I punteggi complessivi degli annunci e i punteggi degli host su più annunci vengono calcolati separatamente e non vanno confusi. · Verificato
cityFacoltativo- Specifica il filtro a testo libero sul nome della città per le query sui dettagli degli alloggi. Inserisci il nome di una città, non l'ID di un alloggio o un codice paese.
max_priceFacoltativo- Imposta il filtro sul prezzo massimo dell'alloggio come valore numerico. Deve essere maggiore o uguale a min_price. Serve a filtrare i risultati di ricerca, non a limitare il costo delle singole richieste API o il budget complessivo per l'alloggio. Il filtro usa numeri interi: i decimali vengono arrotondati per eccesso (145.98 diventa 146).
min_priceFacoltativo- Imposta il filtro sul prezzo minimo dell'alloggio come valore numerico, insieme a max_price. Questo parametro filtra i risultati di ricerca degli annunci e non imposta un limite all'uso dell'API. Il filtro usa numeri interi: i decimali vengono arrotondati per difetto (39.81 diventa 39).
Cosa significano i parametri reviews di API di Airbnb?
Recupera le recensioni degli ospiti di un annuncio Airbnb. Ogni recensione include testo, valutazione, data, lingua, nome e località di chi l'ha scritta ed eventuale risposta dell'host. Puoi filtrare per lingua, per data con since o scegliere l'ordinamento. Un singolo batch non contiene necessariamente l'intera cronologia delle recensioni.
urlObbligatorio- Identifica la risorsa di destinazione in base all'azione: passa un URL /rooms/<property_id> o l'ID dell'alloggio per property_detail, reviews o calendar, oppure un URL /users/show/<host_id> o l'ID dell'host per host. Gli identificatori di alloggi e host non sono intercambiabili.Airbnb: recensioni degli annunci e limiti di visibilità — Airbnb distingue le recensioni pubbliche e le valutazioni complessive a stelle dalle valutazioni per categoria, visibili solo agli host e alla piattaforma. I punteggi complessivi degli annunci e i punteggi degli host su più annunci vengono calcolati separatamente e non vanno confusi. · Verificato
langFacoltativo- Specifica la combinazione di lingua e regione con codici compatti come enus per en-US, zhcn per zh-CN o jajp per ja-JP. Passa esattamente uno dei valori consentiti elencati, non codici di lingua generici di due lettere come en.Valori ammessi:
arxxazazbgbgbsbacaescsczdadkdeatdechdededeluelgrenaeenauencaengbengyenieeninennzensgenuses419esaresboesbzesclescoescresecesesesgteshnesmxesniespaespeespyessvesusesveeteefififrbefrcafrchfrfrfrlugaieheilhiinhrhrhuhuhyamididisisitchititjajpkagekokrltltlvlvmkmkmsmymtmtnlbenlnlnonoplplptbrptptrororuruskskslsisqalsrmesrrssvseswxxththtlphtrtrukuavivnxhzazhcnzhhkzhtwzhtwuszhuszuza localeFacoltativo- Imposta la lingua e l'area di visualizzazione delle pagine di Airbnb (predefinita en-US), ad esempio en-US o zh-CN. Non passare locale insieme a lang: lang ha la precedenza e sovrascrive la lingua selezionata. Questo parametro non filtra le recensioni in base alla nazionalità di chi le scrive.
sinceFacoltativo- Imposta una data di inizio YYYY-MM-DD il cui ambito dipende dall'azione: per reviews indica la data da cui partono le recensioni; per calendar indica l'inizio dell'intervallo di date e sovrascrive start_date e check_in.
sortFacoltativo- Ordina le recensioni degli ospiti per newest (predefinito), relevance o top_rated. Questo parametro si applica solo all'ordine delle recensioni, non ai prezzi degli annunci.Valori ammessi:
newestrelevancetop_rated
Cosa significano i parametri host di API di Airbnb?
Consulta il profilo di un host Airbnb a partire dal link al profilo o dall'ID host. Ottieni nome, bio, lingue, valutazione, stato di Superhost, data di iscrizione e numero di annunci. Passa un link /users/show/ o un ID host, non l'ID di un annuncio. Il profilo non verifica l'identità dell'host.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Identifica la risorsa di destinazione in base all'azione: passa un URL /rooms/<property_id> o l'ID dell'alloggio per property_detail, reviews o calendar, oppure un URL /users/show/<host_id> o l'ID dell'host per host. Gli identificatori di alloggi e host non sono intercambiabili.Airbnb: valutazioni degli host e valutazioni degli annunci a confronto — Airbnb aggrega le valutazioni complessive degli annunci per calcolare la valutazione di un host. Il punteggio recuperato dal profilo di un host non si può applicare direttamente a una singola struttura. · Verificato
Cosa significano i parametri calendar di API di Airbnb?
Controlla la disponibilità giorno per giorno di un annuncio Airbnb. Per ogni data trovi la disponibilità per check-in e check-out, il numero minimo e massimo di notti e il prezzo. Senza date, l'intervallo parte da oggi e copre 30 giorni. La lettura del calendario non blocca né prenota mai un soggiorno.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Identifica la risorsa di destinazione in base all'azione: passa un URL /rooms/<property_id> o l'ID dell'alloggio per property_detail, reviews o calendar, oppure un URL /users/show/<host_id> o l'ID dell'host per host. Gli identificatori di alloggi e host non sono intercambiabili.
check_inFacoltativo- Imposta una data di inizio YYYY-MM-DD di compatibilità per l'azione calendar. Se fornisci anche start_date, start_date ha la precedenza; se fornisci since, questo li sovrascrive entrambi. Consultare le date del calendario non avvia una prenotazione.
check_outFacoltativo- Imposta una data di fine YYYY-MM-DD di compatibilità per l'azione calendar. Se fornisci anche end_date, end_date ha la precedenza; se fornisci until, questo li sovrascrive entrambi. Consultare le date del calendario non blocca la disponibilità dell'alloggio.
end_dateFacoltativo- Imposta la data di fine YYYY-MM-DD per le query sulla disponibilità del calendario. Se omessa, la richiesta usa check_out oppure 30 giorni dalla data della query (non start_date più 30 giorni). Se fornisci until, questo parametro viene sovrascritto.
sinceFacoltativo- Imposta una data di inizio YYYY-MM-DD il cui ambito dipende dall'azione: per reviews indica la data da cui partono le recensioni; per calendar indica l'inizio dell'intervallo di date e sovrascrive start_date e check_in.
start_dateFacoltativo- Imposta la data di inizio YYYY-MM-DD per le query sulla disponibilità del calendario. Se omessa, la richiesta usa check_in oppure la data corrente. Se fornisci since, questo parametro viene sovrascritto.
untilFacoltativo- Imposta la data di fine YYYY-MM-DD per l'azione calendar e sovrascrive end_date e check_out. Questo parametro controlla l'intervallo di date del calendario e non filtra le recensioni per data di pubblicazione.
Come usare l'API di Airbnb
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"airbnb","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Airbnb
Cosa posso ottenere con l'API di Airbnb?
Imposta platform su airbnb. Il catalogo attuale elenca ricerca, dettagli dell'immobile, recensioni, profili degli host e calendario delle disponibilità. Questi nomi di azione identificano oggetti o viste diversi di Airbnb; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Airbnb?
Specifica la località, la città, la regione o il nome della destinazione (ad esempio Tokyo) per l'azione search. Passa il nome di un luogo, non lo username di un host o l'ID di un alloggio. Invialo come keyword all'interno di params.
Quali campi può restituire search di Airbnb?
Il suo schema dichiarato include title, text, property_type e person_capacity. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Airbnb rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.