개요

새로운 머천다이징 API를 활용하여 할인 상품을 더 쉽게 찾아보고, 머신 learning-powered 가 제공하는 추천 정보를 통해 혜택을 누려보세요.

머천다이징 API를 통해 Expedia-sourced 숙박 시설 의 할인 혜택, 관련 캠페인 및 자산은 물론, 머신러닝 기술을 기반으로 한 맞춤형 특가 정보, 여행지 정보, 숙박 시설 순위 정보에 직접 접근할 수 있습니다. 머천다이징 API를 활용하여 프로모션 이메일, 앱 위젯, 웹사이트 배너, 캐러셀 콘텐츠 등 여행자 또는 agent-facing 대상 마케팅 콘텐츠를 구성하고, 성공적인 year-long 머천다이징 전략을 실행하세요.

또한 귀하의 [계정]에서 ‘마케팅’ 섹션을 이용할 수 있습니다. Partner Portal 이 계정을 통해 예정된 캠페인을 확인하고, 맞춤 설정된 거래 목록을 내보내며, 사용할 캠페인 문구와 이미지를 선택하고, 여행 트렌드와 캠페인 성과를 추적할 수 있습니다. 포털에서 ‘마케팅’ 섹션이 보이지 않는 경우, 다음을 제출해 주세요. 지원 티켓.

캠페인 콘텐츠 엔드포인트

캠페인 콘텐츠 엔드포인트는 캠페인 ID, 예약 및 투숙 시작·종료 날짜, 숙박 시설 참여 인원 수 등 예정된 캠페인의 세부 정보를 제공합니다. Expedia-curated 의 캠페인 테마 이미지, 여행지 사진, 추천 문구 등 캠페인 자료에 직접 접근하여, 프로모션 이메일, 앱 위젯, 웹사이트 배너 등 traveler-facing 또는 agent-facing 의 상품 홍보 경험을 제작할 수 있습니다. 또한, 향후 6개월 이내에 예약이 가능한 기간 한정 프로모션(LTO) 캠페인 정보와 연중 내내 진행되는 상시 캠페인 정보도 받아보실 수 있습니다.

캠페인 콘텐츠 엔드포인트를 사용하여 다음과 같은 요청 매개변수를 통해 예정된 캠페인을 검색할 수 있습니다:

예약 가능한 기간
체류 기간
최소 할인율에 해당하는 값 이상
LTO와 에버그린 제안의 비교

예약 기간이 6개월을 초과하는 LTO 캠페인의 경우, 다음 필드는 제외됩니다:

예약 및 여행 기간
최소 및 최대 할인율 (%)

기타 세부 사항

캠페인 콘텐츠 응답의 ‘ property_count ’ 필드를 사용하여, 캠페인 내에서 거래를 제공하는 숙박 시설 중 가장 up-to-date 개수를 확인할 수 있습니다. property_count는 캠페인 예약 시작일 직전에 확인하시는 것을 권장합니다. 숙박 시설의 머천다이징 캠페인 참여 현황은 수시로 변동되며, 캠페인 시작일이 가까워질수록 숙박 시설의 참여 정보가 가장 완전하고 신뢰할 수 있는 경향이 있기 때문입니다.

캠페인 콘텐츠 응답에 포함된 ‘ min_discount ’ 및 ‘ max_discount ’ 필드를 사용하여 해당 캠페인에서 적용 가능한 할인율의 최소값과 최대값을 확인할 수 있습니다. 예를 들어, 해당 캠페인에서 숙박 시설가 제공하는 가장 큰 할인율이 60%라면, API 응답의 max_discount값은 60%가 되지만, 해당 캠페인에서 숙박 시설가 제공하는 가장 낮은 할인율이 4%라면, min_discount필드의 값은 4%가 됩니다.

귀하는 머천다이징 API 또는 조회 API를 사용하여 구축된 귀하의 사이트에서 진행되는 캠페인의 마케팅 및 메시지 전달에 대한 책임을 지며, 이러한 모든 마케팅 및 메시지가 관련 법규를 준수하도록 보장해야 합니다.

프로모션 엔드포인트

프로모션 검색 결과를 쉽게 검색하고 필터링하여 더 타깃이 명확한 특가 상품을 찾을 수 있으므로, 여행객에게 어떤 특가 상품을 보여줄지 완전히 제어할 수 있습니다. Expedia-defined 캠페인과 관련 자산을 사용하는 대신, 이러한 특가 상품을 직접 선별하여 나만의 캠페인 테마를 구성할 수도 있습니다.

Promotions 엔드포인트를 사용하면 다음을 수행할 수 있습니다:

특정 캠페인과 관련된 특가 및 할인 정보 검색하기
캠페인과 관련된 특가 및 할인 정보를 에서 검색하세요. 는 해당되지 않습니다.
여러 요청 매개변수를 활용하여 거래를 검색하고 필터링할 수 있으며, 여기에는 특정 캠페인 또는 여러 캠페인에 걸친 거래를 조회하는 기능도 포함됩니다.
up-to-date, 에서 가장 매력적인 숙박 시설 특가 상품을 찾아 high-converting 캠페인을 기획해 보세요

검색 및 필터

Promotions 엔드포인트를 사용하면 다음과 같은 요청 매개변수를 통해 할인 정보를 쉽게 필터링하고 검색할 수 있습니다:

캠페인 ID 및/또는 숙박 시설 ID
예약 가능한 기간
체류 기간
최소 리뷰 점수, 최소 별점 및/또는 최소 할인율의 기준치 이상인 경우
‘기간 한정’과 ‘상시’의 구분
Member-only 그리고 mobile-only 거래 플래그
광역권 또는 특정 여행지
기계 학습 관련성 순위 정렬 순서

응답 세부 정보

프로모션 API 응답에는 다음과 같은 세부 정보가 포함됩니다:

프로모션 ID, 해당 캠페인 ID 및 숙박 시설 ID
예약 가능 기간, 숙박 기간, 예약 불가 기간 및 사전 구매 기간
‘기간 한정’과 ‘상시’의 구분
응답에 포함된 거래, 숙박 시설 및 목적지에 대해 귀사의 비즈니스에 특화된 기계 학습 기반 관련성 순위( learning-powered )
구체적인 목적지 및 체인 ID 정보
기존 Rapid 숙박 시설 콘텐츠 API에 대한 토큰화된 링크로, property-level 의 이미지를 불러와 상품 판매 경험에 활용할 수 있습니다.
deal-specific 굿즈 판매를 위한 토큰화 쇼핑 링크 조회 API 이 링크를 통해 실시간 가격 및 재고 현황을 확인하세요

기타 세부 사항

특정 예약 기간에 해당하는 특가 상품을 검색하려면 ‘ bookable_start ’과 ‘ bookable_end ’ 날짜 값을 모두 지정할 수 있습니다. 예를 들어, ‘ bookable_start ’ 필드에 2027-10-15 (2027년 10월 15일)을, ‘ bookable_end ’ 필드에 2027-10-30 (2027년 10월 30일)을 입력하면, 10월 15일부터 10월 30일까지(해당 날짜 포함) 예약 가능한 모든 특가 상품을 확인할 수 있습니다. 하지만 더 다양한 특가 상품을 확인하고 싶으신 분들은 bookable_start또는 bookable_enddate를 이용하시면 됩니다. 예:
- bookable_start필드에 2027-10-15 (2027년 10월 15일)을 입력하면, 10월 15일 및 그 이후에 예약 가능한 모든 특가 상품을 확인할 수 있습니다. 이를 통해 더 많은 거래 기회를 확보할 수 있을 것입니다.
- bookable_end필드에 2027-10-30 (2027년 10월 30일)만 입력하면, 10월 30일 및 그 이전에 예약 가능한 모든 특가 상품을 확인할 수 있습니다. 다시 말해, 이렇게 하면 더 많은 할인 상품을 확인할 수 있습니다.
할인 혜택은 숙박 시설의 시간대에 따라 공개되며(i.e. 예약 가능), 따라서, 호주 시드니에서 숙박 시설에 대한 특가 행사가 3월 21일에 시작된다면, 전 세계 모든 제휴사를 대상으로 시드니 시간 기준 오전 12시 01분에 예약이 가능해집니다.
Promotions 엔드포인트에서 include요청 매개변수를 사용하여 수신하는 응답의 크기를 사용자 지정할 수 있습니다. 따라서 모든 응답 필드를 수신하는 대신, 반환받아야 할 필드가 몇 개뿐이라면 ‘ include ’ 매개변수에 해당 필드 이름만 추가하면 됩니다.
캠페인과 연결된 ‘ ’ 거래는 ‘ ’ 거래와 비슷해 보이지만, 몇 가지 중요한 차이점이 있습니다:
- 캠페인과 관련이 없는 할인 상품에는 캠페인 ID가 할당되어 있지 않습니다.
- 대부분의 상품은 최소 할인율이 10%이며, 예약 마감일은 2079년입니다. 예약 종료일이 2079년인 특가는 ‘상시 특가’로 간주되는 반면, 예약일이 2079년 이전인 특가는 ‘기간 한정 특가’로 간주됩니다.
프로모션 API에 대한 요청은 미리 시작할 수 있지만, 숙박 시설의 거래 정보를 가장 정확하고 up-to 날짜 기준으로 반영받으려면 캠페인 예약 가능 시작일에 최대한 가깝게 요청해야 합니다. 캠페인이 시작되기 약 2주 전을 권장합니다. 이는 캠페인 시작일이 다가올수록 숙박 시설의 참여도가 가장 완전하고 신뢰할 수 있는 경향이 있기 때문입니다.
- 또한, 항상 최신 할인 목록을 확인하실 수 있도록 캠페인이 시작된 지 며칠 후에 프로모션을 신청하시는 것을 권장합니다. 또한, 숙박 시설에서 제공하는 최신 할인 정보 목록을 확인하려면 매일 프로모션 API를 호출하시기를 권장합니다.
destination-based 머천다이징 캠페인을 구축하는 데 관심이 있다면, Rapid Geography API의 관련 region_id를 사용하여 region-specific 프로모션 API 요청을 수행할 수 있습니다. 프로모션 엔드포인트에서 허용하는 유일한 지역 유형은 city입니다. multi_city_vicinity, point_of_interest, neighbourhood등과 같은 다른 영역 유형의 경우 빈 응답이 반환됩니다.

쇼핑 이용 가능 여부 API

홍보 중인 숙박 시설 상품의 실시간 재고 현황, 가격, 환불 가능 여부 및 수수료 세부 정보를 확인하려면, 다음 단계로 Rapid Shopping Availability API를 호출해야 합니다.

각 프로모션 응답에는 할인 혜택에 대한 필수 정보와 숙박 시설 데이터가 포함된 쇼핑 링크 토큰이 포함되어 있으며, 이 토큰은 각 할인 혜택마다 고유합니다. 쇼핑 링크 토큰을 사용하면 프로모션 검색 단계에서 쇼핑 단계로 손쉽게 넘어갈 수 있습니다.

프로모션 응답 예시

[
  {
    "promotion_id": "123456",
    "campaign_id": "12345",
    "property_id": "123456",
    ...
    "links": {
      "content": {
        "method": "GET",
        "href": "/v3/properties/content?property_id=123456&language=en-US&supply_source=expedia"
      },
      "shop": {
        "method": "GET",
        "href": "/v3/properties/availability?token=XFleAkNUU1YKACg5HcAtdVw8SQVUPUApTAF0CAApdBg==",
        "required_parameters": [
          "checkin",
          "checkout",
          "currency",
          "country_code",
          "occupancy",
          "rate_plan_count",
          "sales_channel",
          "sales_environment"
        ]
      }
    }
  }
]

홍보할 상품을 선택했다면, 해당 쇼핑 링크 토큰을 사용하여 필요한 매개변수를 지정해 가용성 API 호출을 수행하기만 하면 됩니다. 그러면 가용성 API 응답에 선택한 거래에 대한 모든 기본 정보가 표시되며, 이를 통해 자동화된 방식으로 deal-specific 조회 API 호출을 정확하게 수행할 수 있습니다. 이 토큰과 함께, 동일한 조회 API 요청 내에서 다른 숙박 시설를 추가로 검색할 수 있는 유연성이 제공되므로(단, 한 번의 쇼핑 호출당 총 250개의 숙박 시설로 제한되는 일반 규정은 여전히 적용됨), 쇼핑 검색 범위를 더욱 넓힐 수 있습니다.

가용성 API 요청을 여러 번 수행할 때는 매 요청마다 상점 링크 토큰을 사용해 주시기 바랍니다. 프로모션 API 요청을 할 때마다 각 쇼핑 링크에 대해 새로운 토큰이 생성됩니다. 이는 모든 토큰이 고유하며, 특정 프로모션 API 호출까지 추적할 수 있기 때문입니다. 따라서 프로모션 데이터를 매일 갱신하고 있다면, 가장 최근에 생성된 토큰을 사용하는 것이 중요합니다.

토큰을 사용한 조회 API 요청 예시

curl -X GET "https://test.ean.com/v3/properties/availability\
?token=XFleAkNUU1YKACg5HcAtdVw8SQVUPUApTAF0CAApdBg==\
&checkin=2026-06-01\
&checkout=2026-06-03\
&currency=USD\
&country_code=US\
&occupancy=2\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only" \
 -H "accept: application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

또한, Rapid Shopping Availability 엔드포인트에서 제공되는 새로운 ‘ deal ’ 필터를 사용하여 현재 진행 중인 프로모션이 적용된 요금만 수신할 수 있습니다. 이를 통해 상품 기획에만 중점을 둔 쇼핑 요청을 유연하게 생성할 수 있으며, 반환된 모든 요금에 ‘ deal ’ 속성이 포함되도록 보장할 수 있습니다.

예시 응답

"promotions": {
. "deal": {
.   "id": "999abc",
.   "description": "Book early and save 15%"
. }
}

참고: 머천다이징 API 응답에서 제공되는 id및 description는 조회 API 응답에서 반환되는 값과 다릅니다. Merchandising API에서 반환되는 id및 description를 사용하실 것을 강력히 권장합니다.

제안된 최소 할인 금액은 세금 및 수수료를 제외하고 계산된 금액입니다. 광고에 표시되는 할인이 가격 광고 관련 법률을 준수하는지 확인할 책임이 있습니다.

머신러닝 기반 추천

‘프로모션’ 응답에 포함된 기계 학습 기반 learning-powered 관련성 순위는 각 파트너마다 고유하므로, 귀하가 확인하는 순위는 다른 사람이 확인하는 순위와 다를 수 있습니다. 머신러닝 기반 추천 기능을 활용하여 머천다이징 캠페인에서 홍보할 최적의 특가 상품, 숙박 시설 및 여행지를 파악할 수 있습니다. Higher-scoring 특가 상품, 숙박 시설 및 여행지는 귀사의 고유 여행자층 사이에서 예약으로 이어질 가능성이 더 높을 수 있습니다.

현재 상위 1만 건의 거래에 대한 관련성 순위를 확인하실 수 있습니다. 테스트 결과, 거래 건수가 1만 건을 넘어가면 이 순위의 가치와 영향력은 미미해지는 것으로 나타났습니다.
사용 사례에 따라 ‘ sort_by ’ 매개변수를 사용하여 ‘Promotions’ 응답의 정렬 순서를 정의할 수 있습니다. 거래, 숙박 시설 또는 당사의 머신러닝 모델이 결정한 목적지 관련성을 기준으로 정렬 순서를 선택함으로써, 노출도와 여행객의 예약 측면에서 머천다이징을 통해 최대의 효과를 얻을 수 있습니다.
- sort_by = promotion를 전달하면, 당사의 독자적인 머신러닝 알고리즘에 따라 high-to-low 순위(1위부터 10,000위까지)로 정렬된 모든 거래 결과를 받게 됩니다. 이 정렬 기능을 사용하면, 저희 모델이 전환율이 더 높을 것으로 예상하는 최고의 추천 상품을 확인할 수 있습니다.
- sort_by = property를 전달하면, 당사의 독자적인 머신러닝 알고리즘에 따라 숙박 시설 순위의 high-to-low 에서 나온 모든 거래 결과를 받게 됩니다.
- sort_by = destination를 전달하면, 당사의 독자적인 머신러닝 알고리즘에 따라 high-to-low 순위로 평가된 목적지의 모든 거래 결과를 받아보실 수 있습니다.

참고: 머신 러닝 기반 추천 기능은 포털()의 ‘ ’ 마케팅 섹션에서도 확인할 수 있습니다. 자세한 내용은 담당 계정 관리자에게 문의해 주시기 바랍니다.

출시 요구 사항

규정 준수 책임

캠페인을 진행할 때 모든 관련 법률 및 마케팅 지침을 준수할 책임은 전적으로 귀하에게 있습니다.

콘텐츠 무결성

API 세부 정보

이 페이지에서 ‘ merchandising-related ’ 엔드포인트 정의를 살펴본 다음, ‘ API Explorer ’ 또는 다른 테스트 도구를 사용하여 예제와 스키마 정의가 실제 출력과 어떻게 다른지 확인해 보십시오.

추가 리소스

모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.