簡介

善用全新的商品推廣 API，更輕鬆地找出優惠方案，並從機器 learning-powered 推薦中獲益

Merchandising API 可讓您直接存取 Expedia-sourced 旅宿上的折扣、相關活動與素材，以及由機器學習驅動的個人化優惠、目的地及旅宿排行榜。利用商品推廣 API 來建置針對旅客或 agent-facing 的行銷體驗，例如促銷電子郵件、App 小工具、網站橫幅及輪播體驗，並執行一套成功的 year-long 商品推廣策略。

您還可在「合作夥伴入口網站」帳戶中存取「行銷」專區，在此您可以瀏覽即將推出的行銷活動、匯出客製化的交易清單、選取要使用的行銷文案與圖片，並追蹤旅遊趨勢及行銷活動成效。若您在入口網站中未看到「行銷」區塊，請聯絡我們以獲取協助。

>> 前往合作夥伴入口網站
 >> 聯絡支援團隊

活動內容端點

活動內容端點會提供即將推出的活動詳情，包括活動 ID、預訂日期、入住起訖日期，以及參與活動的住宿點數量。您可直接存取「Expedia-curated」活動資源，例如活動主題圖片、目的地影像及建議文案，藉此打造「traveler-facing」或「agent-facing」的商品推廣體驗，包括促銷電子郵件、App 小工具以及網站橫幅。此外，您還會收到關於限時優惠 (LTO) 活動的資訊，這些活動的預訂時限為未來六個月內；同時也會收到全年皆可參與的常青活動資訊。

您可以使用「活動內容」端點，透過以下請求參數來搜尋即將推出的活動：

可預訂日期範圍
住宿日期範圍
等於或高於最低折扣的數值
LTO 與「常青」方案的比較

對於預訂窗口超過六個月的 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」活動及其相關素材。

透過「促銷」端點，您可以：

搜尋與特定活動相關的優惠與折扣
搜尋與該活動相關的優惠與折扣：（請注意，此網址並非）
透過多種請求參數來搜尋和篩選交易，包括可針對特定活動或跨多個活動查詢交易
發掘最吸引人的 up-to-date, 旅宿優惠，以打造 high-converting 行銷活動

搜尋和篩選

您可以使用「促銷」端點，透過以下請求參數輕鬆篩選和搜尋優惠：

活動 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_end date。例如：

* 若在「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 的日期資訊。我們建議在活動開始前約兩週。這是因為隨著活動啟動日期的臨近，各物業的參與度往往會達到最完整且最可靠的程度。

我們也建議您在活動開始後幾天再申請優惠，這樣您就能隨時獲得最新更新的優惠清單。此外，我們建議您每天呼叫促銷 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」。隨後，Availability API 的回應將顯示您所選交易的所有常規詳細資訊，這將使您能夠以自動化方式發出針對性的 deal-specific Shopping API 呼叫。透過此代幣，您可在同一次「購物」API 請求中靈活地繼續搜尋其他房源 (單次「購物」呼叫的總房源數上限仍為 250 筆)，進一步擴展您的購物搜尋範圍。

在發出多筆可用性 API 請求時，請務必在每次呼叫中使用商店連結代幣。每次您發出「促銷 API」請求時，系統都會針對每個商店連結產生一個新的憑證。這是因為每個代幣都是唯一的，且可追溯至特定的 Promotions 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%"
. }
}

注意： Merchandising API 回應中提供的id 和description 與 Shopping API 回應中返回的值不同。我們強烈建議您使用 Merchandising API 所回傳的id 及description。

建議的最低折扣不包含稅金和其他費用。您有責任確保所宣傳的折扣遵守必要的價格廣告法。

機器學習推薦

「推廣」回應中提供的 learning-powered 機器相關性排名是針對每位合作夥伴量身打造的，因此您收到的排名將與其他人收到的不同。您可以利用機器學習推薦功能，找出最適合在您的商品推廣活動中宣傳的最佳優惠、房產及目的地。Higher-scoring 優惠、房源和旅遊目的地，可能更有機會吸引您的獨特旅客群體進行預訂。

目前，您將收到前 1 萬筆交易的相關性排名。在我們的測試中，我們發現當交易數量超過最初的 1 萬筆後，此排名的價值與影響便變得微乎其微。

根據您的使用情境，您可以使用sort_by 參數來定義「促銷活動」回應的排序順序，選擇依據優惠方案、旅宿，或是由我們的機器學習模型所判定之目的地相關性進行排序，藉此讓您在商品展示方面獲得最大效益，包括提升能見度及旅客預訂量。

若您傳入sort_by = promotion，您將收到所有交易結果，這些結果將根據我們的專有機器學習演算法，依 high-to-low (1 至 10,000) 進行排序。您可以使用此排序方式，篩選出我們的模型預測轉化率較高的熱門推薦優惠。
若您傳入sort_by = property，您將收到根據我們專有的機器學習演算法，按 high-to-low 排序的所有房產交易結果。
若您傳入sort_by = destination，您將收到所有來自 high-to-low 所列目的地、依據我們專有的機器學習演算法所排序的優惠結果。

註：您亦可在我們入口網站的「行銷」區塊中，查閱的機器學習建議。如需更多詳情，請聯絡您的客戶經理。

>> 前往入口網站的「行銷」專區

啟動條件

合規責任

您須全權負責確保在執行行銷活動時，符合所有適用的法律及行銷指引。

內容完整性

Expedia-provided 不得修改圖片。若您願意，可使用您自己的創意素材；然而，您須全權負責確保其符合所有適用的著作權及智慧財產權旅宿法規。

API 詳細資料

請瀏覽本頁面的「merchandising-related」端點定義，接著使用「API Explorer」或其他測試軟體，藉此了解範例與架構定義與實際輸出結果之間的對比。

其他資源

無論您是想嘗試所有 Rapid API 端點，還是下載其 OpenAPI 規格或我們的 Postman Collection，我們都可協助您完成。