API Booking Dettagli
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
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.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su booking e action impostato su profile. 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.
La funzionalità Booking Details legge una struttura su Booking, identificata dal link alla sua pagina, e restituisce i dati della struttura: nome e tipo, descrizione, classificazione ufficiale in stelle, punteggio degli ospiti con il relativo giudizio e il numero di recensioni, indirizzo e coordinate, catena di appartenenza, condizioni della colazione, immagini e un prezzo con la relativa valuta. I team di contracting alberghiero e di revenue management la usano per profilare le strutture con cui negoziano o con cui competono, e i prodotti di viaggio per completare le pagine degli hotel con dati coerenti.
Tieni separate le due misure di qualità: stars è la classificazione ufficiale da 1 a 5, mentre rating è il punteggio degli ospiti, che Booking assegna su 10; rating_label ne fornisce il giudizio testuale corrispondente. hotel_chain è null per gli hotel indipendenti. I prezzi cambiano in base alle date, quindi passa sia check_in sia check_out per ottenere il prezzo di un soggiorno specifico, e memorizza check_in_date e check_out_date accanto a ogni price che conservi. lang accetta i codici locale di Booking, come engb (il valore predefinito), enus o zhcn, non en o zh da soli.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Booking Dettagli di EveryInfra (booking/profile).
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 profile, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Specifica l'URL completo della pagina di una singola struttura, preferibilmente con il percorso /hotel/.
- 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)
- Restituisce un oggetto. Campi principali: 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": "profile",
"params": {
"url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
}
}
- 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ì | profile | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | 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. |
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 |
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": "profile",
"params": {
"url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
}
}'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": "profile", "results": { "id": 179810, "name": "Park Hyatt Tokyo", "type": "hotel", "url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.en-gb.html", "text": "Get the celebrity treatment with world-class service at Park Hyatt TokyoPark Hyatt Tokyo welcomes you home, thoughtfully crafting each moment with intuitive care to ensure every stay feels personally tailored. Located in Shinjuku, west Tokyo, Park Hyatt Tokyo occupies the 39th to…", "stars": 5, "rating": 9.2, "review_count": 128, "breakfast": "Buffet", "address": "Tokyo-to, Tokyo, Shinjuku-ku, Nishishinjuku 3-7-1-2, Japan", "city": "Tokyo", "country": "jp", "latitude": "35.684871080031755", "longitude": "139.69104677438736", "image_url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=", "platform": "booking", "category_ratings": [ { "name": "Location", "score": 9.1 }, { "name": "Cleanliness", "score": 9.7 }, { "name": "Value for money", "score": 8.5 } ], "image_urls": [ "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=&hp=1", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909677947.jpg?k=0132e551e1b3f34b69767d6416d778dee86bfd324025f3d0a6d39a2b21e005ca&o=&hp=1", "https://cf.bstatic.com/xdata/images/hotel/max1024x768/110318598.jpg?k=180b52ab1b8a3cdda7a6a014c2068e381bcfa4dc8573036a19ce57241e6b1018&o=&hp=1" ], "facilities": [ "4 restaurants", "Parking", "Private bathroom" ], "rating_scale": 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
#Quale link di Booking devo passare come url?
#Il link completo alla pagina di una singola struttura, preferibilmente con il percorso /hotel/, ad esempio https://www.booking.com/hotel/jp/park-hyatt-tokyo.html. Una pagina di destinazione o di risultati di ricerca elenca molte strutture e non ne identifica una. Lo stesso link alla struttura funziona anche con Booking Reviews per le recensioni degli ospiti e con Booking Prices per i prezzi delle camere.
In cosa differisce stars da rating?
#stars è la classificazione ufficiale in stelle della struttura, da 1 a 5, una misura dei servizi offerti e non dell'opinione degli ospiti. rating è il punteggio medio degli ospiti, su 10 per Booking come conferma rating_scale, e rating_label lo esprime a parole, ad esempio Wonderful o Very good. Un hotel modesto con ospiti soddisfatti può ottenere un punteggio più alto di un cinque stelle, quindi analizza le due misure separatamente.
Come ottengo il prezzo per date specifiche?
#Invia sia check_in sia check_out come date YYYY-MM-DD, con il check-out successivo al check-in; se ne invii solo una, non viene applicata alcuna data di soggiorno. price viene restituito come numero semplice con il codice della valuta in currency, e il parametro currency sceglie la valuta di visualizzazione tra i codici elencati. Per i prezzi giorno per giorno di ogni tipo di camera su un intervallo di date, usa Booking Prices.
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 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 il 2026-09-04