Valoriser une fiche produit avec les avis Tripadvisor

  • Contenu resort
  • 1 route
Comment récupérer les notes, trophées et commentaires Tripadvisor d'un produit ?

L'objectif de ce cas d'utilisation est de récupérer toutes les informations qui nous intéressent depuis Tripadvisor : les notes, les trophées et les commentaires. Ces données sont affichées sur les fiches produit du Club Med® pour les mettre en valeur.

GET ​/vX​/products​/{product_id}​/tripadvisor

Location_id

"location_id": "152890"

Il s'agit de l'identifiant de lieu Tripadvisor.

Tripadvisor_url

"tripadvisor_url": "https://www.tripadvisor.fr/Hotel_Review-g150807-d152890-Reviews-Club_Med_Cancun-Cancun_Yucatan_Peninsula.html?m=24206"

URL menant à la page du produit sur Tripadvisor. Ce lien est affiché sur le site [[Club Med]] afin que l'utilisateur puisse être redirigé vers Tripadvisor et voir toutes les informations souhaitées en détail.

Rating

"rating": "4.5"

Note globale du produit.

Rating_image_url

"rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/4.5-24206-5.svg"

Il s'agit de l'image de la note globale permettant d'afficher la note avec les petits cercles.

Subratings

"subratings": [
  {
    "rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.5.svg",
    "name": "rate_location",
    "value": "4.5",
    "localized_name": "Emplacement"
  }
]

Voici toutes les notes par catégorie :

  • Emplacement,
  • Literie,
  • Chambres,
  • Service,
  • Rapport qualité / prix,
  • Propreté.

Pour chaque catégorie, nous trouvons :

  • l'image correspondant à la note comme précédemment,
  • un libellé,
  • la note,
  • le nom de la catégorie.

Cela vous permet de détailler la note globale.

Awards

"awards": [
  {
    "award_type": "GreenLeader",
    "year": "",
    "images": {
      "small": "https://www.tripadvisor.fr/img/cdsi/img2/awards/greenleader_new_green_small-24206-5.png",
      "large": "https://www.tripadvisor.fr/img/cdsi/img2/awards/greenleaders/GreenLeaders_API_fr_large_partner-24206-5.jpg"
    },
    "categories": [
      "GreenPartner"
    ],
    "display_name": "GreenLeader Partner"
  },
  {
    "award_type": "Travelers Choice",
    "year": "2021",
    "images": {
      "small": "https://www.tripadvisor.fr/img/cdsi/img2/awards/CERTIFICATE_OF_EXCELLENCE_v2_small-24206-5.jpg",
      "large": "https://www.tripadvisor.fr/img/cdsi/img2/awards/CERTIFICATE_OF_EXCELLENCE_2021_ROW_large-24206-5.jpg"
    },
    "categories": [],
    "display_name": "Travelers Choice 2021"
  }
]

Voici les trophées remportés. Pour en savoir plus sur le trophée Travelers Choice et le trophée GreenLeader Parter

Reviews

"reviews": [
  {
    "id": "828179613",
    "lang": "fr",
    "location_id": "152890",
    "published_date": "2022-02-15T23:40:15-0500",
    "rating": 5,
    "helpful_votes": "0",
    "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s5.0-24206-5.svg",
    "url": "https://www.tripadvisor.fr/ShowUserReviews-g150807-d152890-r828179613-Club_Med_Cancun-Cancun_Yucatan_Peninsula.html?m=24206#review828179613",
    "trip_type": "En famille",
    "travel_date": "2022-02",
    "text": "Nous avons passé un très bon séjour du 7 au 14 février \nLes soirées étaient un peu fraîches à cause du vent mais sinon, nous avons eu du soleil toute la semaine.\nLe club est divisé en 2 parties avec des voiturettes qui tournent toutes les 5min pour vous transporter d’un bout à l’autre. Il y a 2 piscines et 2 espaces différents donc les GM sont bien dispersés…\nTrès belles excursions et pas trop chères \nLa nourriture est variée et bonne \nNous retournerons dans ce club avec grand plaisir !",
    "user": {
      "username": "Adamedia67",
      "user_location": {
        "name": "Strasbourg",
        "id": null
      },
      "review_count": "24",
      "reviewer_badge": "Auteur confirmé"
    },
    "title": "Très beau club avec de belles prestations",
    "owner_response": null,
    "subratings": [
      {
        "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s5.0-24206-5.svg",
        "name": "rate_room",
        "value": "5",
        "localized_name": "Chambres"
      },
      {
        "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s4.0-24206-5.svg",
        "name": "rate_value",
        "value": "4",
        "localized_name": "Rapport qualité / prix"
      },
      {
        "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s4.0-24206-5.svg",
        "name": "rate_sleep",
        "value": "4",
        "localized_name": "Literie"
      },
      {
        "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s5.0-24206-5.svg",
        "name": "rate_location",
        "value": "5",
        "localized_name": "Emplacement"
      },
      {
        "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s5.0-24206-5.svg",
        "name": "rate_cleanliness",
        "value": "5",
        "localized_name": "Propreté"
      },
      {
        "rating_image_url": "https://www.tripadvisor.fr/img/cdsi/img2/ratings/traveler/s4.0-24206-5.svg",
        "name": "rate_service",
        "value": "4",
        "localized_name": "Service"
      }
    ]
  }
]

Il semble qu'il s'agisse des 4 derniers commentaires publiés. Le site Web [[Club Med]] affiche uniquement les commentaires avec des notes de 5.

Num_reviews

"num_reviews": "12355"

Nombre total de votes sur ce produit.

1

Récupérer les avis Tripadvisor

Optionnel

Utilisez GET/v0/products/{product_id}/tripadvisor pour récupérer les signaux d'avis rattachés à un produit, notamment la note, les trophées et les commentaires.

Prérequis

Préparez product_id. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide.

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v0/products/{product_id}/tripadvisor"

Example answer

{
  "rating": 4.5,
  "trophies": [
    "Travelers' Choice"
  ],
  "comments": [
    {
      "author": "Alice",
      "title": "Great stay",
      "rating": 5
    }
  ]
}

info: Exploitez ensemble la note, les trophées et les commentaires représentatifs pour enrichir une fiche produit ou un bloc Tripadvisor.

Codes de réponse

  • 200 OK : les données attendues sont renvoyées.
  • 400 Bad Request : la requête est invalide ou incomplète.
  • 404 Not Found : la ressource demandée est introuvable.
GET/v0/products/{product_id}/tripadvisor
Voir plus