API di Booking
Cerca alloggi su Booking per destinazione, data di check-in e tipo di struttura per ottenere preventivi delle camere, recensioni degli ospiti e dettagli sulla disponibilità.
Ottieni una struttura tramite il suo URL. La disponibilità rilevata non garantisce la prenotazione.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su booking e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 4 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 Booking: 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 hotel, appartamenti e altri alloggi su Booking.com per una destinazione. | Normale | |
Dettagliprofile | Ottieni una struttura Booking.com dal link della sua pagina /hotel/. | Normale | |
Recensionireviews | Raccogli le recensioni degli ospiti di una struttura Booking.com, con il testo su ciò che è piaciuto e non piaciuto tenuto separato, punteggio, mese del soggiorno, tipo di viaggiatore, camera ed eventuale risposta dell'hotel. | Normale | |
Prezziprices | Confronta giorno per giorno le tariffe delle camere di una struttura Booking.com. | Normale |
Cosa accetta ogni azione di API di Booking?
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 hotel, appartamenti e altri alloggi su Booking.com per una destinazione. Ottieni stelle ufficiali, punteggio degli ospiti, prezzo, condizioni della colazione, catena e posizione. Invia le date come coppia | keyword | check_in, check_out, currency, lang, min_price, property_type, sort, star_rating | Valori del catalogo: defaultLimit=10, maxLimit=30. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities | |
profileDettagli Ottieni una struttura Booking.com dal link della sua pagina /hotel/. Include descrizione, tipo, stelle ufficiali, punteggio degli ospiti con valutazioni per categoria, servizi, indirizzo e un prezzo indicativo. Le | url | check_in, check_out, currency, lang | — | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities | |
reviewsRecensioni Raccogli le recensioni degli ospiti di una struttura Booking.com, con il testo su ciò che è piaciuto e non piaciuto tenuto separato, punteggio, mese del soggiorno, tipo di viaggiatore, camera ed eventuale risposta dell'hotel. Ciascuna delle due parti può essere vuota, e il batch potrebbe non includere tutte le recensioni. | url | — | 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 · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform | |
pricesPrezzi Confronta giorno per giorno le tariffe delle camere di una struttura Booking.com. Ottieni tipo di camera, prezzo originale e attuale, tasse, rimborsabilità, trattamento e camere rimaste. La finestra | url | adults, check_in, currency, days, rooms, start_date | — | id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · min_stay · bed_type · max_guests · room_size_sqm · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform · rooms_left · room_view |
Cosa significano i parametri search di API di Booking?
Trova hotel, appartamenti e altri alloggi su Booking.com per una destinazione. Ottieni stelle ufficiali, punteggio degli ospiti, prezzo, condizioni della colazione, catena e posizione. Invia le date come coppia check_in e check_out. I prezzi sono quelli mostrati e non vengono bloccati fino alla prenotazione.
keywordObbligatorio- Specifica il nome della destinazione, ad esempio Amsterdam. Viene usato dall'azione search per trovare hotel, appartamenti e altri alloggi, non come parola chiave per voli, attrazioni o recensioni.
check_inFacoltativo- Specifica la data di check-in nel formato YYYY-MM-DD. Le azioni search e profile richiedono sia check_in sia check_out per inviare le date del soggiorno. Per prices, funge da data di inizio quando start_date è omesso. Non crea prenotazioni.
check_outFacoltativo- Specifica la data di check-out nel formato YYYY-MM-DD, che deve essere successiva a check_in e fornita insieme a esso. Impostare solo check_out non trasmette l'intervallo del soggiorno alle azioni search o profile.
currencyFacoltativo- Specifica la valuta di visualizzazione dei prezzi delle strutture, con USD come predefinito. Accetta i codici minuscoli elencati per le azioni search e profile e codici maiuscoli di tre lettere per prices. Questo parametro non modifica l'addebito delle API di EveryInfra.Valori ammessi:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langFacoltativo- Specifica la lingua di visualizzazione della pagina della struttura, con l'inglese britannico come predefinito. Accetta engb o enus per l'inglese britannico o americano e zhcn o zhtw per il cinese semplificato o tradizionale (non passare i generici en o zh). Questo parametro non traduce il testo delle recensioni.Valori ammessi:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_priceFacoltativo- Filtra le strutture in base a una stringa con la fascia di prezzo per notte, non a un singolo valore minimo (ad esempio 100-150 per un intervallo o 100+ per almeno 100). La valuta è determinata dal parametro currency e i prezzi totali del soggiorno non sono supportati.
property_typeFacoltativo- Filtra i risultati di ricerca per categoria di alloggio, rispettando maiuscole e spazi (ad esempio Hotels, Apartments, Hostels, Guest houses, Homestays, Bed and breakfasts, Holiday homes, Boats, Villas, Motels, Resorts, Holiday parks, Campsites, Luxury tents oppure none per nessun filtro). Questo parametro filtra le categorie di struttura, non specifici tipi di camera.
sortFacoltativo- Ordina le strutture per distance rispetto alla località, popular per un ranking composito basato sulle recensioni o top_rated per la classificazione in stelle anziché per il punteggio delle recensioni degli ospiti. search usa popular come predefinito, mentre le query profile ignorano l'ordinamento.Valori ammessi:
distancepopulartop_rated star_ratingFacoltativo- Filtra le strutture per classificazione in stelle: accetta da 1_star a 5_stars, unrated per le strutture senza classificazione o any per rimuovere il filtro. La classificazione in stelle delle strutture è distinta dal punteggio delle recensioni degli ospiti.Valori ammessi:
1_star2_stars3_stars4_stars5_starsanyunratedBooking: valutazioni a stelle, punteggi delle recensioni e valutazioni di qualità — Booking mantiene definizioni separate per le valutazioni a stelle delle strutture, i punteggi delle recensioni degli ospiti e le valutazioni di qualità. Una valutazione da 1 a 5 stelle è distinta da un punteggio delle recensioni degli ospiti da 1 a 10 e non va confusa con le valutazioni di qualità a riquadri gialli. · Verificato
Cosa significano i parametri profile di API di Booking?
Ottieni una struttura Booking.com dal link della sua pagina /hotel/. Include descrizione, tipo, stelle ufficiali, punteggio degli ospiti con valutazioni per categoria, servizi, indirizzo e un prezzo indicativo. Le stars ufficiali e il rating degli ospiti sono misure distinte. Aggiungere le date non blocca il prezzo.
urlObbligatorio- Specifica l'URL completo della pagina di una singola struttura, preferibilmente con il percorso /hotel/. Viene usato da profile per ottenere i dettagli, da reviews per recuperare le recensioni della struttura e da prices per verificare le tariffe delle camere. Gli URL di ricerca per destinazione non sono supportati.Booking: valutazioni a stelle e punteggi delle recensioni nelle pagine delle strutture — Booking tiene separate le valutazioni a stelle delle strutture, i punteggi delle recensioni degli ospiti e le valutazioni di qualità. L'azione profile legge una pagina pubblica di una struttura tramite URL; questa fonte spiega i termini di valutazione restituiti e non trasforma una valutazione in un filtro della richiesta o in una garanzia di prenotazione. · Verificato
check_inFacoltativo- Specifica la data di check-in nel formato YYYY-MM-DD. Le azioni search e profile richiedono sia check_in sia check_out per inviare le date del soggiorno. Per prices, funge da data di inizio quando start_date è omesso. Non crea prenotazioni.
check_outFacoltativo- Specifica la data di check-out nel formato YYYY-MM-DD, che deve essere successiva a check_in e fornita insieme a esso. Impostare solo check_out non trasmette l'intervallo del soggiorno alle azioni search o profile.
currencyFacoltativo- Specifica la valuta di visualizzazione dei prezzi delle strutture, con USD come predefinito. Accetta i codici minuscoli elencati per le azioni search e profile e codici maiuscoli di tre lettere per prices. Questo parametro non modifica l'addebito delle API di EveryInfra.Valori ammessi:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langFacoltativo- Specifica la lingua di visualizzazione della pagina della struttura, con l'inglese britannico come predefinito. Accetta engb o enus per l'inglese britannico o americano e zhcn o zhtw per il cinese semplificato o tradizionale (non passare i generici en o zh). Questo parametro non traduce il testo delle recensioni.Valori ammessi:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw
Cosa significano i parametri reviews di API di Booking?
Raccogli le recensioni degli ospiti di una struttura Booking.com, con il testo su ciò che è piaciuto e non piaciuto tenuto separato, punteggio, mese del soggiorno, tipo di viaggiatore, camera ed eventuale risposta dell'hotel. Ciascuna delle due parti può essere vuota, e il batch potrebbe non includere tutte le recensioni.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica l'URL completo della pagina di una singola struttura, preferibilmente con il percorso /hotel/. Viene usato da profile per ottenere i dettagli, da reviews per recuperare le recensioni della struttura e da prices per verificare le tariffe delle camere. Gli URL di ricerca per destinazione non sono supportati.Booking: recensioni degli ospiti e valutazioni per sottocategoria — La documentazione di Booking indica che i punteggi complessivi delle recensioni e i punteggi delle singole categorie vengono inviati in modo indipendente. Questo riprende l'impostazione del sito ufficiale; le dimensioni della scala delle recensioni per questa azione API vanno comunque controllate per ogni forma di input, e citare questo link non dimostra che la normalizzazione sia stata convalidata. · Verificato
Cosa significano i parametri prices di API di Booking?
Confronta giorno per giorno le tariffe delle camere di una struttura Booking.com. Ottieni tipo di camera, prezzo originale e attuale, tasse, rimborsabilità, trattamento e camere rimaste. La finestra days è di 7 giorni di default e al massimo 30. In ogni riga, check_in e check_out sono gli orari giornalieri dell'hotel, non le tue date.
urlObbligatorio- Specifica l'URL completo della pagina di una singola struttura, preferibilmente con il percorso /hotel/. Viene usato da profile per ottenere i dettagli, da reviews per recuperare le recensioni della struttura e da prices per verificare le tariffe delle camere. Gli URL di ricerca per destinazione non sono supportati.
adultsFacoltativo- Specifica il numero di ospiti adulti per le query di prezzo; accetta un numero intero, con 2 come predefinito. Viene usato solo come parametro delle query di prezzo: non limita le opzioni di camera restituite né avvia una prenotazione. search opera con un numero fisso di 2 adulti.
check_inFacoltativo- Specifica la data di check-in nel formato YYYY-MM-DD. Le azioni search e profile richiedono sia check_in sia check_out per inviare le date del soggiorno. Per prices, funge da data di inizio quando start_date è omesso. Non crea prenotazioni.
currencyFacoltativo- Specifica la valuta di visualizzazione dei prezzi delle strutture, con USD come predefinito. Accetta i codici minuscoli elencati per le azioni search e profile e codici maiuscoli di tre lettere per prices. Questo parametro non modifica l'addebito delle API di EveryInfra.
daysFacoltativo- Specifica per quanti giorni di calendario in avanti interrogare i prezzi, con 7 come predefinito e un intervallo consentito di 1–30 (i valori esterni vengono riportati ai limiti). Determina la finestra di date della query, non la durata del soggiorno per le singole tariffe delle camere.Booking: tariffe e condizioni fiscali — Booking afferma che le strutture ricettive stabiliscono le proprie tariffe, mentre tasse e costi dipendono da località, tipo di camera e occupazione. Controlla la descrizione di ogni tariffa per sapere cosa è incluso; questa azione è una query, non una prenotazione né una garanzia di prezzo. · Verificato
roomsFacoltativo- Specifica il numero di camere per le query di prezzo; accetta un numero intero, con 1 come predefinito. Determina il numero di camere richieste, non il numero di opzioni di camera restituite. search opera con un numero fisso di 1 camera.
start_dateFacoltativo- Specifica la data di inizio per le ricerche dei prezzi giornalieri in prices nel formato YYYY-MM-DD. Ha la precedenza su check_in quando sono forniti entrambi. Non rappresenta la data di pubblicazione delle recensioni né la data di apertura della struttura.
Come usare l'API di Booking
- 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":"booking","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Booking
Cosa posso ottenere con l'API di Booking?
Imposta platform su booking. Il catalogo attuale elenca ricerca, dettagli, recensioni e prezzi. Questi nomi di azione identificano oggetti o viste diversi di Booking; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Booking?
Specifica il nome della destinazione, ad esempio Amsterdam. Viene usato dall'azione search per trovare hotel, appartamenti e altri alloggi, non come parola chiave per voli, attrazioni o recensioni. Invialo come keyword all'interno di params.
Quali campi può restituire search di Booking?
Il suo schema dichiarato include name, type, text e stars. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Booking 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.