概述

利用全新的商品销售 API 更轻松地识别优惠活动，并从机器学习技术中获益。

利用机器学习帮助您从 Expedia Group 庞大的全球促销库存中识别出与旅行者最相关的优惠和折扣。通过使用商品营销 API，您可以访问各种活动内容和交易数据，从而构建成功的 year-long 策略和 traveler-facing 体验，例如促销电子邮件、应用程序小部件、网站横幅和轮播体验。

我们还在合作伙伴门户中新增了一个应用程序，您可以使用该应用程序来制定商品销售策略，并规划、执行和跟踪营销活动。此应用位于名为“门户营销中心”的新版块中。请联系您的客户经理了解更多信息。

活动内容终点

• 提供即将开展的活动详情，包括活动 ID、预订和入住的开始和结束日期，以及参与活动的酒店数量。
• 可以直接访问 Expedia-curated 活动素材，例如活动主题图片、目的地图片、建议文案等。
• 接收有关未来六个月内可预订的限时优惠 (LTO) 活动以及全年可预订的常青活动的信息。

您可以使用“活动内容”端点，通过请求参数（包括以下参数）搜索即将开展的活动：

• 可预订日期范围
• 保持日期范围
• 达到或超过最低折扣值
• LTO 优惠与常青优惠对比

对于预订窗口期超过六个月的限时抢购活动，以下字段将被排除在外：

• 预订和入住日期
• 最低和最高折扣百分比

其他详情

Campaign Content 端点可以帮助您利用 Expedia-curated 资产创建 traveler-facing 商品体验，例如促销电子邮件、应用程序小部件、网站横幅等。

您可以使用“广告系列内容”响应中的 property_count 字段来确定广告系列中提供优惠的房产数量最多的 up-to-date。我们建议您在活动预订开始日期临近时查看property_count，因为酒店参与促销活动的情况是动态的，而且随着活动开始日期的临近，酒店的参与往往最为全面可靠。

促销终点

• 提供与特定活动相关的所有可用优惠和折扣。
• 能够借助多个请求参数搜索和筛选优惠，包括请求特定活动或多个活动的优惠。
• 使您能够始终找到最具吸引力的房产交易，从而开展 high-converting 营销活动。

您可以使用“促销”端点，通过请求参数（例如）轻松筛选和搜索优惠信息：

• 广告系列 ID 和/或媒体资源 ID
• 可预订日期范围
• 保持日期范围
• 达到或超过最低评分、最低星级和/或最低折扣要求
• 限时与常青的区别
• Member-only 和 mobile-only 交易标志
• 超级区域或特定目的地
• 机器学习相关性评分排序

促销 API 响应中将返回以下详细信息：

• 交易 ID、对应的广告系列 ID 和房产 ID
• 可预订日期范围、入住日期范围、不可预订日期和提前购买窗口
• 限时与常青的区别
• 机器 learning-powered 针对您的业务，针对响应中返回的交易、房产和目的地，提供独特的关联性评分
• 具体目的地和连锁店 ID 信息
• 指向现有 Rapid Property Content API 的令牌化链接，用于提取 property-level 图片，以便在您的商品展示体验中呈现。

其他详情

您可以轻松搜索和筛选促销活动结果，以获得更有针对性的优惠，从而完全掌控向旅行者展示的优惠。您还可以策划这些优惠活动，构建自己的活动主题，而不是使用 Expedia-defined 活动和相关素材。

如果您想搜索特定预订窗口内的优惠，您可以同时传递 bookable_start 和 bookable_end 日期的值。例如，在 bookable_start 字段中传递 2025-10-15（2025 年 10 月 15 日），在 bookable_end 字段中传递 2025-10-30（2025 年 10 月 30 日），您将收到 10 月 15 日至 10 月 30 日期间可预订的所有优惠。但是，如果您想查看更多优惠信息，可以使用 bookable_start 或 bookable_end 日期。

例如：

• 在 bookable_start 字段中输入 2025-10-15（2025 年 10 月 15 日），即可获取 10 月 15 日及之后可预订的所有优惠。这将带来更多交易机会。

• 只需在 bookable_end 字段中输入 2025-10-30（2025 年 10 月 30 日），即可收到 10 月 30 日及之前可预订的所有优惠。这将再次带来更多交易机会。

优惠活动将根据房产所在时区上线（i.e，即可预订）。因此，如果一项在澳大利亚悉尼的房产交易于 3 月 21 日开始，则该交易将于悉尼时间凌晨 12:01 对全球所有合作伙伴开放预订。

您可以使用 Promotions 端点上的 include 请求参数来自定义收到的响应的大小。因此，如果您只需要返回几个字段，而不是接收所有响应字段，则可以在 include 参数中添加这些特定的字段名称。

您可以提前开始向促销 API 发出请求，但为了获得最准确、最准确的房产交易日期表示，也应该尽可能在活动可预订开始日期附近发出请求。这是因为随着活动开始日期的临近，各物业的参与度往往最高、最可靠。

我们还建议您在促销活动开始几天后申请优惠，以便您始终能够获得最新的优惠列表。此外，我们建议您每天请求促销 API，以获取酒店提供的最新优惠列表。

如果您有兴趣构建 destination-based 商品推广活动，您可以使用 Rapid Geography API 中的相关 region_id 发出 region-specific Promotions API 请求。促销端点唯一接受的区域类型是city。其他区域类型，例如 multi_city_vicinity、point_of_interest、neighbourhood 等，将返回空白响应。

机器学习推荐

机器 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 的所有目的地的交易结果。

**注：**门户营销中心也提供机器学习推荐。请联系您的客户经理了解更多详情。

对购物可用性 API 进行的更改

要获取最新的库存信息、实时价格、退款政策、佣金信息等详情，您应该向 Rapid 的购物库存 API 发出标准请求。我们对购物 API 进行了以下更改，以支持商品销售流程，并尽可能简化您与商品销售 API 的集成：

• 使用快速购物可用性端点中提供的新的 deal筛选器，即可仅接收包含有效促销活动的报价。这样，您可以灵活地创建专门针对商品销售的购物请求，并确保返回的所有价格都具有 deal属性。
• Rapid 的购物可用性端点上新增了一个名为 Campaign-Id的请求标头，您可以用它来表明您正在进行的特定购物可用性 API 调用并非常规调用，而是由于您的商品促销活动（换句话说，这将表明当旅客因促销活动进入购物体验时，发出了购物可用性 API 请求）。每次购物 API 调用我们只接受一个活动 ID。此活动 ID 将帮助我们跟踪您的活动效果，并为您设计更好的机器学习模型和 API 增强功能。
• 如果您想在门户营销中心查看您的广告系列效果，您需要在购物 API 调用中传递广告系列 ID 参数。如有任何疑问，请联系您的客户经理。

**注意：**您可以一次性从购物可用性 API 请求最多 250 个房产的详细信息。

示例回复

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

**注意：商品 API 响应中提供的 **和 id与购物 API 响应中返回的有所不同。description 我们强烈建议您使用商品销售 API 返回的 id和 description。

API 详情

浏览此页面上的 merchandising-related 端点定义，然后使用 API Explorer 或其他测试软件，了解示例和架构定义与实际输出的比较情况。

其他资源

无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合，我们都能满足您的需求。

转到 API Explorer