概述

利用全新的商品销售 API，更轻松地识别优惠活动，并受益于机器的 learning-powered 推荐

商品销售 API 可直接访问 Expedia-sourced 房产折扣、相关活动和资产，以及由机器学习驱动的个性化交易、目的地和房产排名。使用商品营销 API 来填充旅行者或 agent-facing 营销体验，例如促销电子邮件、应用程序小部件、网站横幅和轮播体验，并执行成功的 year-long 商品营销策略。

您还可以访问营销版块。合作伙伴门户网站您可以登录帐户，浏览即将推出的活动、导出自定义优惠列表、选择要使用的活动文案和图片，并跟踪旅游趋势和活动效果。如果您在门户网站中看不到“营销”部分，请提交一份报告。支持工单。

活动内容终点

活动内容端点提供即将开展的活动详情，包括活动 ID、预订和入住开始和结束日期以及参与的酒店数量。您可以直接访问 Expedia-curated 活动素材，例如活动主题图片、目的地图片和建议文案，以创建 traveler-facing 或 agent-facing 商品体验，包括促销电子邮件、应用程序小部件和网站横幅。此外，您还将收到有关未来六个月内可预订的限时优惠 (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 营销活动。

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

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

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

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

其他详情

如果您想搜索特定预订窗口内的优惠，您可以同时传递 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 进行的更改

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

使用快速购物可用性端点中提供的新的 deal筛选器，即可仅接收包含有效促销活动的报价。这样，您可以灵活地创建专门针对商品销售的购物请求，并确保返回的所有价格都具有 deal属性。

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

示例回复

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

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

计算建议最低折扣时不包括税款和费用。您有责任确保所宣传的折扣符合相关的价格广告法律规定。

上线要求

合规责任

在开展营销活动时，您须全权负责确保遵守所有适用的法律和营销准则。

内容完整性

Expedia-provided 图片不得修改。您可以使用自己的创意素材（如果您愿意）；但是，您须自行负责确保遵守所有适用的版权和知识产权法律。

API 详情

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

其他资源

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