API Booking Ricerca
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
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.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su booking e action impostato su search. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Booking Search elenca le strutture in cui alloggiare in una destinazione su Booking, indicata come keyword, ad esempio London o Amsterdam. Per ogni struttura restituisce nome e tipologia, stelle ufficiali, punteggio degli ospiti con la relativa etichetta e il numero di recensioni, prezzo e valuta, condizioni della colazione, catena, indirizzo e coordinate. Startup del settore viaggi, revenue manager di hotel e analisti di mercato la usano per vedere cosa offre una destinazione, come sono valutate le sue strutture e quanto costano in date specifiche.
Aggiungi check_in e check_out insieme per ottenere i prezzi per quelle notti. Due impostazioni si fraintendono facilmente. min_price accetta una fascia di prezzo per notte come testo, ad esempio 100-150 o 100+, nella valuta impostata con currency. sort impostato su top_rated ordina per categoria di stelle, non per punteggio degli ospiti. stars in ogni riga e il filtro star_rating usano entrambi la scala ufficiale da 1 a 5, mentre rating è il punteggio degli ospiti sulla scala da 10 punti di Booking.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Booking Ricerca di EveryInfra (booking/search).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su booking e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: 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.
- Parametri facoltativi:
- check_in: 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.
- check_out: 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.
- currency: 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. (valori consentiti: aed / ars / aud / azn / bgn / bhd / brl / cad)
- lang: Specifica la lingua di visualizzazione della pagina della struttura, con l'inglese britannico come predefinito. (valori consentiti: ar / bg / ca / cs / da / de / el / engb)
- min_price: 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).
- property_type: 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,…
- sort: 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. (valori consentiti: distance / popular / top_rated)
- star_rating: 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. (valori consentiti: 1_star / 2_stars / 3_stars / 4_stars / 5_stars / any / unrated)
- Altri 1 parametri facoltativi sono elencati nella tabella dei parametri in questa pagina.
- Restituisce un elenco di record. Campi principali di ogni record: id, name, type, url, text, stars (Classe a stelle dell'hotel (1–5), una c…), rating, rating_scale, rating_label (Fascia testuale della valutazione (ad e…), review_count, price, currency; 25 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=booking.
- Esempio di corpo della richiesta:
{
"platform": "booking",
"action": "search",
"params": {
"keyword": "London"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | booking | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | 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_in | body.params | date | No | - | 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_out | body.params | date | No | - | 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. |
currency | body.params | string (enum) | No | - | 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 consentitiaedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar |
lang | body.params | string (enum) | No | - | 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 consentitiarbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw |
min_price | body.params | number | No | - | 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_type | body.params | string | No | - | 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. |
sort | body.params | string (enum) | No | - | 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 consentitidistancepopulartop_rated |
star_rating | body.params | string (enum) | No | - | 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 consentiti1_star2_stars3_stars4_stars5_starsanyunrated |
limit | body.params | integer (1–30) | No | 10 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 30. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "booking",
"action": "search",
"params": {
"keyword": "London"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "booking", "action": "search", "results": [ { "id": 9152828, "name": "Cleveland Residences Farringdon", "type": "apartment", "url": "https://www.booking.com/hotel/gb/cleveland-residences-farringdon.en-gb.html", "text": "About this propertyCentral London Location: Cleveland Residences Farringdon is situated in London city centre, offering easy access to key attractions. St Paul's Cathedral is a 13-minute walk away, while Sky Garden lies 2.5 km from the property.\n\nComfortable Amenities: Guests enj…", "rating": 9.1, "review_count": 1242, "address": "116-117 Saffron Hill, Camden, Camden, London, EC1N 8QS, United Kingdom", "city": "London", "country": "gb", "latitude": "51.5203036425954", "longitude": "-0.106765334515317", "image_url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/725064039.jpg?k=8aa8ee4090de4750c832a40819443d8d3731aed5b023f354e9b4093d78732fcc&o=", "platform": "booking", "category_ratings": [ { "name": "Staff", "score": 9.2 }, { "name": "Facilities", "score": 9.2 }, { "name": "Cleanliness", "score": 9.4 } ], "image_urls": [ "https://cf.bstatic.com/xdata/images/hotel/max1024x768/725064039.jpg?k=8aa8ee4090de4750c832a40819443d8d3731aed5b023f354e9b4093d78732fcc&o=&hp=1", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/735052970.jpg?k=b5c291fb38e2cdeacf237c2652552638c9a777c3ec9054c3fa0c5029dbe09099&o=&hp=1", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/735053105.jpg?k=3f6df590a0aec806a17c2238c6bce37c9e9c700fa4b1f630da028a573b84fff8&o=&hp=1" ], "facilities": [ "Private bathroom", "Air conditioning", "Free WiFi" ], "rating_scale": 10 }, { "id": 35820, "name": "Sofitel London St James", "type": "hotel", "url": "https://www.booking.com/hotel/gb/st-james-london.en-gb.html", "text": "Get the celebrity treatment with world-class service at Sofitel London St JamesIn London's West End, this 5-star luxury hotel is set in a beautifully preserved Neoclassical building. It boasts a luxurious on-site spa, spacious rooms, and Michelin Star restaurant, Wild Honey St Ja…", "stars": 5, "rating": 9.1, "review_count": 804, "breakfast": "Continental, Full English/Irish, Vegetarian, Vegan, Gluten-free, American, Buffet", "address": "6 Waterloo Place, Westminster Borough, London, SW1Y 4AN, United Kingdom", "city": "London", "country": "gb", "latitude": "51.50752378484304", "longitude": "-0.1324474811553955", "image_url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/804916751.jpg?k=c5f49dc9649a166531d810b862cb312d841e2dc1266f1a6672d6f7461b7c0f9f&o=", "platform": "booking", "category_ratings": [ { "name": "Staff", "score": 9.5 }, { "name": "Facilities", "score": 9.2 }, { "name": "Cleanliness", "score": 9.5 } ], "image_urls": [ "https://cf.bstatic.com/xdata/images/hotel/max1024x768/804916751.jpg?k=c5f49dc9649a166531d810b862cb312d841e2dc1266f1a6672d6f7461b7c0f9f&o=&hp=1", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/887340748.jpg?k=e58ae27f3487f6ab3654dab8b57ef2a2821298cc636e66fa515f7cf96a0e8141&o=&hp=1", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/804916786.jpg?k=97de20f440fc61186681a99951e472bb6f8e7365c219d9257d4766d2d580d8da&o=&hp=1" ], "facilities": [ "4 restaurants", "Parking", "Pets allowed" ], "rating_scale": 10 } ], "count": 10, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
name | Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività. |
type | Tipo di record; i valori dipendono dalla funzionalità (ad esempio video / image / text). |
url | Link al record sulla piattaforma. |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
stars | Classe a stelle dell'hotel (1–5), una classificazione ufficiale dei servizi della struttura. Non è la stessa cosa della valutazione degli ospiti in rating. |
rating | Valutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito. |
rating_scale | Valore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione. |
rating_label | Fascia testuale della valutazione (ad esempio Wonderful o Very good), derivata dal punteggio. |
review_count | Numero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0. |
price | Prezzo come numero senza simbolo di valuta; vedi currency. |
currency | Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta. |
breakfast | Indicazione sulla colazione (inclusa, non inclusa o a pagamento). |
hotel_chain | Catena alberghiera a cui appartiene la struttura; null per gli hotel indipendenti. |
check_in_date | Data di check-in usata per questa ricerca. |
check_out_date | Data di check-out usata per questa ricerca. |
address | Indirizzo completo, passato così com'è. |
city | Nome della città nella lingua della piattaforma, non normalizzato. |
country | Paese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato. |
latitude | Latitudine. |
longitude | Longitudine. |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
category_ratings | Punteggi per categoria, ciascuno con un nome (come pulizia o posizione) e un punteggio; assenti quando non ce ne sono. |
image_urls | Array di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini. |
facilities | Nomi di servizi e strutture, nell'ordine dei gruppi della pagina; assenti quando non ce ne sono. |
FAQ
#Perché top_rated non ordina per punteggio degli ospiti?
#In Booking Search, top_rated al momento ordina le strutture per categoria di stelle, non in base al giudizio degli ospiti. Per ordinarle per punteggio degli ospiti, recupera i risultati e ordinali tu per rating, tenendo d'occhio review_count, così un punteggio basato su poche recensioni non supera uno leggermente più basso basato su migliaia. popular, il valore predefinito, è l'ordine complessivo di Booking basato sulle recensioni, mentre distance ordina per distanza dal luogo cercato.
Come funziona il filtro min_price?
#Nonostante il nome, min_price accetta una fascia di prezzo per notte come stringa: 100-150 mantiene le strutture con un prezzo a notte compreso tra quei due valori, e 100+ quelle da 100 a notte in su. I numeri sono espressi nella valuta scelta con currency, che per impostazione predefinita è il dollaro statunitense. Non inserire il totale dell'intero soggiorno.
Quali valori accettano property_type e star_rating?
#property_type è un testo con la terminologia di Booking, con le stesse maiuscole e gli stessi spazi, ad esempio Hotels, Apartments, Hostels, Guest houses o Bed and breakfasts; none non applica alcun filtro. Indica il tipo di struttura, non il tipo di camera. star_rating accetta da 1_star a 5_stars, unrated o any, e filtra per categoria ufficiale di stelle, una scala diversa dal rating degli ospiti.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Booking: 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 il 2026-09-04