API TripAdvisor 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
Recupera la scheda TripAdvisor di un hotel, un ristorante o un'attrazione. Ottieni valutazione, numero di recensioni, posizione in città, fascia di prezzo, indirizzo, coordinate e contatti. Passa la pagina del luogo, non una directory della città. Prezzi e disponibilità per una data specifica non sono inclusi.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su tripadvisor 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.
TripAdvisor Details legge un luogo su TripAdvisor, che sia un hotel, un ristorante o un'attrazione, a partire dal link alla sua pagina e ne restituisce la scheda: nome, categoria, descrizione, valutazione e numero di recensioni, posizione in classifica tra luoghi simili della città, fascia di prezzo, indirizzo e coordinate, e il telefono, l'email e il sito web pubblicati dall'attività. Piattaforme di viaggio, enti del turismo e team del settore hospitality la usano per arricchire i database delle strutture, confrontare un luogo con quelli vicini e mantenere aggiornati i recapiti.
Qui i dettagli riguardano il luogo stesso, non il profilo di un viaggiatore. lang imposta la lingua di visualizzazione con codici di due lettere come en o zh, currency la valuta degli eventuali prezzi mostrati e content_type le foto restituite: quelle di tutti, quelle dell'attività o quelle dei viaggiatori. phone viene passato senza riformattazione, quindi normalizza i numeri prima di abbinarli ai tuoi record e conserva rating insieme a rating_scale quando confronti luoghi su siti diversi.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint TripAdvisor Dettagli di EveryInfra (tripadvisor/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 tripadvisor e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
- url: URL TripAdvisor del luogo di destinazione per le azioni profile e reviews, che deve puntare direttamente alla scheda di un hotel, ristorante o attrazione e non a un elenco della città.
- Parametri facoltativi:
- content_type: Filtra le foto del luogo per provenienza. I valori consentiti sono from_everyone (tutte le foto), from_management (caricate dal gestore) e from_travelers (caricate dai visitatori). (valori consentiti: from_everyone / from_management / from_travelers)
- currency: Codice valuta per i prezzi dei luoghi mostrati, con usd come predefinito (tra le opzioni comuni ci sono eur, gbp e cny). (valori consentiti: aed / afn / all / amd / ars / aud / azn / bam)
- lang: Codice lingua di due lettere (ad es. en o zh) per search, profile, restaurants e attractions. L'azione reviews non accetta questo parametro. (valori consentiti: aa / ab / ae / af / ak / am / an / ar)
- Restituisce un oggetto. Campi principali: id, name, category, url, text, rating, rating_scale, review_count, price_level, ranking, address, city; 21 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=tripadvisor.
- Esempio di corpo della richiesta:
{
"platform": "tripadvisor",
"action": "profile",
"params": {
"url": "https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_Street_Food_Tour_with_Locals_Dim_Sum_Wonton_more-Hong_Kong.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ì | tripadvisor | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | profile | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | URL TripAdvisor del luogo di destinazione per le azioni profile e reviews, che deve puntare direttamente alla scheda di un hotel, ristorante o attrazione e non a un elenco della città. In profile recupera i dettagli del luogo, non i dati del profilo di un utente. |
content_type | body.params | string (enum) | No | - | Filtra le foto del luogo per provenienza. I valori consentiti sono from_everyone (tutte le foto), from_management (caricate dal gestore) e from_travelers (caricate dai visitatori). Non filtra le categorie di luoghi come hotel, ristoranti o attrazioni: per un tipo di luogo specifico scegli l'azione corrispondente.Valori consentitifrom_everyonefrom_managementfrom_travelers |
currency | body.params | string (enum) | No | - | Codice valuta per i prezzi dei luoghi mostrati, con usd come predefinito (tra le opzioni comuni ci sono eur, gbp e cny). L'enumerazione completa dello schema è mantenuta, ma i codici storici supportati potrebbero non restituire prezzi attivi in tempo reale. Questo parametro non cambia la valuta di fatturazione dell'API.Valori consentitiaedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl |
lang | body.params | string (enum) | No | - | Codice lingua di due lettere (ad es. en o zh) per search, profile, restaurants e attractions. L'azione reviews non accetta questo parametro.Valori consentitiaaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh |
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": "tripadvisor",
"action": "profile",
"params": {
"url": "https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_Street_Food_Tour_with_Locals_Dim_Sum_Wonton_more-Hong_Kong.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": "tripadvisor", "action": "profile", "results": { "id": "26810431", "name": "Hong Kong: 7-Course Hong Kong Street & Restaurant Food Tour", "category": "activity", "url": "https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_7_Course_Hong_Kong_Street_Restaurant_Food_Tour-Hong_Kong.html", "text": "With this guided food tour, you can discover a variety of great eateries in Hong Kong’s historic Chinese quarter. Instead of spending hours scrolling through reviews, a guide does all the planning for you and takes you to places to get delicious street food, including barbecue po…", "rating": 4.9, "review_count": 388, "address": "Hong Kong China", "city": "Hong Kong", "country": "China", "location": "Hong Kong", "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/33/81/6d/45/caption.jpg", "platform": "tripadvisor", "rating_scale": 5 }, "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à. |
category | Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme. |
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). |
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. |
review_count | Numero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0. |
price_level | Mantiene il significato attribuito dalla piattaforma |
ranking | Mantiene il significato attribuito dalla piattaforma |
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. |
location | Descrizione della località passata così com'è; il formato varia in base alla piattaforma. |
phone | Numero di telefono di contatto, passato senza normalizzarne il formato. |
email | Indirizzo email di contatto, passato così com'è. |
website | Sito web esterno indicato dall'account o dall'attività. |
latitude | Mantiene il significato attribuito dalla piattaforma |
longitude | Mantiene il significato attribuito dalla piattaforma |
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). |
cuisines | Mantiene il significato attribuito dalla piattaforma |
FAQ
#Quale link TripAdvisor funziona come url?
#La pagina di un hotel, ristorante o attrazione specifici, come https://www.tripadvisor.com/AttractionProductReview-g294217-d26810431-Hong_Kong_Street_Food_Tour_with_Locals_Dim_Sum_Wonton_more-Hong_Kong.html per un tour gastronomico a Hong Kong. Le pagine delle città e gli elenchi delle directory non funzionano. Lo stesso link del luogo funziona anche con TripAdvisor Reviews, che restituisce le singole recensioni alla base di rating e review_count.
Come interpreto ranking e price_level?
#ranking è la posizione del luogo tra i luoghi dello stesso tipo nella sua città, così come la mostra TripAdvisor, ad esempio terzo tra i ristoranti di una città, quindi confronta le posizioni solo all'interno della stessa città e categoria. price_level è una fascia indicata con da uno a quattro simboli del dollaro: un'indicazione relativa del costo, non un prezzo che puoi convertire o sommare.
Posso chiamarla da PHP?
#Sì. Ogni funzionalità si chiama con una semplice richiesta HTTPS autenticata con la tua chiave API e la risposta è in JSON, quindi puoi effettuare la chiamata con le funzioni cURL di PHP o con qualsiasi libreria client HTTP. Indica la piattaforma e l'azione, passa il link del luogo come url in params, poi decodifica la risposta con json_decode e leggi campi come name, rating e ranking.
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.
- Tripadvisor: classifica di popolarità e valutazioni ↗
Tripadvisor lega la sua classifica di popolarità alla qualità, alla data e al numero delle recensioni e alla costanza dei risultati nel tempo; la posizione dipende anche dai risultati delle altre attività della stessa zona e non è semplicemente un altro modo di rappresentare la valutazione media.
Verificato il 2026-09-04