이용 후기 API

검증된 여행객이 작성한 숙박 시설 후기를 공유하여 전환을 유도하세요.

개요

Expedia Group 최근에 숙박을 완료한 여행객은 숙박 시설를 평가하고 경험에 대한 서면 후기를 공유할 수 있습니다. 빠른 게스트 후기 API를 사용하면 수천만 건의 숙박 시설 후기 작성에 액세스할 수 있으므로 사이트, 플랫폼, 앱에서 여행객에게 이를 노출할 수 있습니다.

다른 여행자의 실제 경험은 고객이 여행에 적합한 예약을 결정하고 숙박에 대한 적절한 기대치를 설정하는 데 도움이 될 수 있습니다.

작동 방식

게스트 후기 API 요청에 숙박 시설 식별자와 언어를 포함하면 반환된 후기가 올바른 숙박 시설와 여행자가 선호하는 언어로 작성되었는지 확인할 수 있습니다. 그런 다음 user-generated 콘텐츠 인벤토리에서 해당 숙박 시설에 대한 리뷰를 최대 100개까지 반환합니다.

이용 후기 API 응답에는 다음이 포함됩니다.

전체 평점, 리뷰의 제목 및 텍스트, 리뷰 작성자 이름입니다.
여행자가 숙박한 월 및 연도, 검토 제출 날짜.
여행 동반자에 대한 정보: 카테고리에는 self, partner, family_with_children, family, friends, 및 pet.
관련 trip_reason, business, leisure, business_and_leisure, 또는 friends_and_family.
특정 여행자 후기에 대한 숙박 시설의 모든 서면 답변과 답변 날짜.

응답 예시

{
  "verified": {
    "recent": [
      {
        "verification_source": "Expedia verified review",
        "title": "Definitely staying again",
        "date_submitted": "2019-02-11T18:19:40Z",
        "rating": "5",
        "reviewer_name": "Bill",
        "stay_date": "2019-02",
        "trip_reason": "leisure",
        "travel_companion": "self",
        "text": "Staff very helpful and friendly. Pool was 18 meters deep, very strange."
      },
      {
        "verification_source": "Expedia verified review",
        "title": "Pool much too deep",
        "date_submitted": "2019-02-10T11:15:01Z",
        "rating": "2",
        "reviewer_name": "Gregory",
        "stay_date": "2019-01",
        "trip_reason": "friends_and_family",
        "travel_companion": "family_with_children",
        "text": "Bottom of the 18 meter pool was too scary. Staff were nice though.",
        "management_responses": [
          {
            "text": "Dear Guest, Thank you for your feedback. I hope we have the opportunity to welcome you back in the near future. Best regards, Kara (General Manager)",
            "date": "2019-02-11T14:36:54Z"
          }
        ]
      }
    ]
  }
}

이용 후기는 표시 속도 향상을 위해 실시간 호출 후 최대 48시간 동안 캐시에 저장됩니다.

이용 후기 API 요청 필터링하기

응답에서 가장 관련성이 높은 여행자 후기를 받도록 게스트 후기 API 요청을 조정하는 방법에는 여러 가지가 있습니다. 이를 통해 대상 여행객에 가장 적합하도록 사이트 또는 플랫폼의 후기를 맞춤 설정할 수 있습니다.

예를 들어, 비즈니스 여행객이 남긴 후기, 특정 언어로 작성된 후기, 반려동물과 함께 여행하는 게스트의 후기만 받기를 원하는지 요청에 명시할 수 있습니다.

요청 예

curl -X GET "https://test.ean.com/v3/properties/12345/guest-reviews\
?language=fr-FR\
&filter=language\
&trip_reason=business" \
 -H "accept: application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1719329586"\
 -H "user-agent: TravelNow/3.30.112"

출시 요구 사항

숙소 쇼핑 및 예약 환경에서 인증된 후기를 확인하고 표시하려면, 출시 요건 을 준수해야 합니다.

Rapid 이용 후기 API에 대한 자세한 내용은 익스피디아 담당자에게 문의해 주세요.