概述

利用全新的商品销售 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%。

促销终点

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

通过“促销”接口，您可以：

• 搜索与特定活动相关的优惠和折扣
• 搜索优惠和折扣，但未与任何活动关联。****
• 借助多个请求参数搜索和筛选优惠信息，包括请求特定活动或多个活动范围内的优惠信息。
• 找出最具吸引力的房产交易，打造 high-converting 活动

搜索和筛选

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

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

回复详情

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

• 促销 ID、对应的活动 ID 和房源 ID
• 可预订日期范围、入住日期范围、不可预订日期和提前购买窗口
• 限时与常青的区别
• 机器 learning-powered 针对您的业务，针对响应中返回的交易、房产和目的地，提供独特的关联性排名
• 具体目的地和连锁店 ID 信息
• 指向现有 Rapid Property Content 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日期。例如：
  • 在 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 发出请求，但为了获得最准确、最准确的房产交易日期表示，您也应该尽可能在活动可预订开始日期附近发出请求。我们建议在竞选活动开始前大约两周开始准备。这是因为随着活动开始日期的临近，各物业的参与度往往最高、最可靠。
  • 我们还建议您在促销活动开始几天后申请优惠，以便您始终能够获得最新的优惠列表。此外，我们建议您每天请求促销 API，以获取酒店提供的最新优惠列表。
• 如果您有兴趣构建 destination-based 商品推广活动，您可以使用 Rapid Geography API 中的相关 region_id发出 region-specific Promotions API 请求。促销端点唯一接受的区域类型是city。其他区域类型，例如 multi_city_vicinity、point_of_interest、neighbourhood 等，将返回空白响应。

购物可用性 API

当您想要了解推广房源的实时可用性、价格、退款和佣金详情时，下一步是调用快速购物可用性 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"
        ]
      }
    }
  }
]

当您选择要推广的优惠时，只需使用商店链接令牌，并传入所需的参数，即可调用 Availability API。可用性 API 响应将显示有关您选择的交易的所有常规详细信息，这将使您能够以自动化的方式进行有针对性的 deal-specific 购物 API 调用。凭借此令牌，您可以灵活地在同一购物 API 请求中进一步搜索其他房产（一次购物调用中总共 250 个房产的常规限制仍然适用），从而进一步扩展您的购物搜索范围。

当您发出多个 Availability 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"

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

示例回复

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

**注意：商品 API 响应中提供的 **和 id与购物 API 响应中返回的有所不同。description 我们强烈建议您使用商品销售 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 集合，我们都能满足您的需求。

转到 API Explorer