游轮价格 API

API ID 14256

搜索航行并查看当前票价 舱位价格和行程 以及10家邮轮公司的近期降价

100% 正常运行时间 684 ms 平均响应

API 文档

端点

请求
返回搜索邮轮的有效公司、地点、目的地、船名和港口值 将公司发送到范围限制为一个邮轮公司 将那些名称复制到搜索中 它们是完全匹配的
Endpoint ID: 35959
GET https://zylalabs.com/api/14256/cruise+price+api/35959/filter+options
输入参数

筛选选项 — 端点功能

对象 描述
company 可选 Cruise line slug, such as costa. Omit it to list values for every line.

剩余免费测试请求:3 / 3。


输入参数

company
API 示例响应
JSON
{
    "data": {
        "companies": [
            "aida",
            "carnival",
            "celebrity-cruises",
            "costa",
            "disney-cruise-line",
            "holland-america",
            "msc",
            "ncl",
            "princess",
            "royal-caribbean"
        ],
        "locales": [
            "de_AT",
            "de_DE",
            "en_GB",
            "en_US",
            "es_ES",
            "fr_FR",
            "it_IT"
        ],
        "destinations": [
            "Mediterranean",
            "Caribbean",
            "South America",
            "Northern Europe",
            "Bahamas"
        ],
        "ship_names": [
            "Costa Deliziosa",
            "Costa Diadema",
            "Costa Fascinosa",
            "Costa Toscana"
        ],
        "ports": [
            "Barcelona, Spain",
            "Rome (Civitavecchia), Italy",
            "Savona, Italy",
            "Marseille, France",
            "Palermo, Italy"
        ]
    },
    "request_id": "01JSAXEXAMPLE"
}
筛选选项 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14256/cruise+price+api/35959/filter+options?company=costa' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回符合过滤条件的航行 每一行包括cruise_id、Cruise Detail使用的id,以及船只、日期、票价和舱位价格 每个过滤条件是可选的 船只和港口必须完全匹配过滤选项 找不到匹配时返回HTTP 200和空列表
Endpoint ID: 35385
GET https://zylalabs.com/api/14256/cruise+price+api/35385/search+cruises
输入参数

搜索邮轮 — 端点功能

对象 描述
company 可选 Cruise line slug, such as princess. Omit it to search every line.
locale 可选 Market code such as en_US. It picks the currency and the fare for that market.
limit 可选 How many sailings to return. The default is 20. A higher value is capped by the plan.
departure_after 可选 Earliest departure date to include, yyyy-mm-dd, inclusive.
departure_before 可选 Latest departure date to include, yyyy-mm-dd, inclusive.
min_duration 可选 Minimum cruise length in nights.
max_duration 可选 Maximum cruise length in nights.
min_price_eur 可选 Minimum per-person fare in euros. Rows without a fare are left out.
max_price_eur 可选 Maximum per-person fare in euros.
ship 可选 Ship name from Filter Options. Exact match. Separate several names with a comma.
port 可选 Port name from Filter Options, such as Rome (Civitavecchia), Italy.
destination 可选 Destination label from Filter Options, such as Mediterranean.
sort 可选 Sort field and direction. Default is departure_date:asc. Also price_euro, duration, price_per_night_eur and updated_at.
starting_after 可选 Cursor from the previous response next_cursor. Keep the other filters unchanged.

剩余免费测试请求:3 / 3。


输入参数

company
locale
limit
departure_after
departure_before
min_duration
max_duration
min_price_eur
max_price_eur
ship
port
destination
sort
starting_after
API 示例响应
JSON
{
    "data": [
        {
            "cabin_prices_per_person": {
                "BALCONY": 2319,
                "INTERIOR": 1453
            },
            "company": "princess",
            "cruise_id": "N634",
            "currency": "USD",
            "departure_date": "2026-10-06",
            "destinations": [
                "Mediterranean"
            ],
            "duration": 7,
            "locale": "en_US",
            "ports_list": [
                {
                    "arrival": null,
                    "day": 1,
                    "departure": null,
                    "port": "Rome (Civitavecchia), Italy"
                }
            ],
            "price": 1453,
            "price_euro": 1296.24,
            "price_per_night_eur": 185.18,
            "ship_name": "Enchanted Princess",
            "updated_at": "2026-10-06T06:24:17Z"
        }
    ],
    "has_more": true,
    "next_cursor": null,
    "request_id": "01JSAXEXAMPLE"
}
搜索邮轮 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14256/cruise+price+api/35385/search+cruises?company=princess&locale=en_US&limit=5' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回一个航行:船只 行程 每位乘客的当前票价和舱位价格。id是来自搜索航线的cruise_id。使用与该搜索相同的公司和地区。例如:N634适用于公主号和en_US
Endpoint ID: 35382
GET https://zylalabs.com/api/14256/cruise+price+api/35382/cruise+detail
输入参数

邮轮详细信息 — 端点功能

对象 描述
company 必需 Cruise line slug. Required, and it must match the company from the Search Cruises row.
locale 必需 Market code such as en_US. Required. Use the same locale as the search that returned cruise_id.
id 必需

剩余免费测试请求:3 / 3。


输入参数

company
locale
API 示例响应
JSON
{
    "data": {
        "cabin_fare_details": null,
        "cabin_prices_per_person": {
            "BALCONY": 2319,
            "INTERIOR": 1453
        },
        "company": "princess",
        "cruise_id": "N634",
        "currency": "USD",
        "departure_date": "2026-10-06",
        "destinations": [
            "Mediterranean"
        ],
        "duration": 7,
        "locale": "en_US",
        "ports_list": [
            {
                "arrival": null,
                "day": 1,
                "departure": null,
                "port": "Rome (Civitavecchia), Italy"
            }
        ],
        "price": 1453,
        "price_euro": 1296.24,
        "price_per_night_eur": 185.18,
        "ship_name": "Enchanted Princess",
        "updated_at": "2026-10-06T06:24:17Z"
    },
    "request_id": "01JSAXEXAMPLE"
}
邮轮详细信息 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14256/cruise+price+api/35382/cruise+detail?company=princess&locale=en_US&id=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回降价的航班,包括之前的价格、当前价格和降幅百分比。每一行包括 cruise_id,这是航海详情的 ID。每个筛选都是可选的
Endpoint ID: 35384
GET https://zylalabs.com/api/14256/cruise+price+api/35384/recent+price+drops
输入参数

最近价格下跌 — 端点功能

对象 描述
company 可选 Cruise line slug. Limits the drops to one line. Omit it to include every line.
locale 可选 Market code such as en_US. Drops are measured per market. Omit it to include every market.
min_drop_pct 可选 Only include drops of at least this percentage. For example, 10 means 10 percent.
since 可选 Only drops detected on or after this date, in yyyy-mm-dd, UTC.
limit 可选 How many drops to return. The default is 20. A higher value is capped by the plan.
sort 可选 Sort field and direction: drop_pct, detected_at or current_price_euro, with :asc or :desc. Default is drop_pct:desc.
starting_after 可选 Cursor from the previous response next_cursor. Keep the other filters unchanged.

剩余免费测试请求:3 / 3。


输入参数

company
locale
min_drop_pct
since
limit
sort
starting_after
API 示例响应
JSON
{
    "data": [
        {
            "cabin_type": "INTERIOR",
            "company": "princess",
            "cruise_id": "N634",
            "currency": "USD",
            "current_price": 1453,
            "current_price_euro": 1296.24,
            "departure_date": "2026-10-06T00:00:00Z",
            "destinations": [
                "Mediterranean"
            ],
            "detected_at": "2026-10-06T06:24:17Z",
            "drop_amount_euro": 201.76,
            "drop_pct": 13.5,
            "duration": 7,
            "itinerary_url": null,
            "locale": "en_US",
            "previous_price": 1680,
            "previous_price_euro": 1498,
            "ship_name": "Enchanted Princess",
            "title": "Enchanted Princess Mediterranean"
        }
    ],
    "has_more": false,
    "next_cursor": null,
    "request_id": "01JSAXEXAMPLE"
}
最近价格下跌 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/14256/cruise+price+api/35384/recent+price+drops?company=princess&locale=en_US&min_drop_pct=10&since=2026-09-01&limit=5&sort=drop_pct:desc' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 游轮价格 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

(年度计费可节省 2 个月 🎉)

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

搜索邮轮会返回某一邮轮公司和市场的航行信息 每一行包括cruise_id 将该值复制到邮轮详情中并发送相同的公司和地点,因为该ID仅在一条线路内是唯一的 示例ID是N634 代表公主邮轮 en_US 来自最近降价的行中也包括cruise_id 过滤选项返回搜索邮轮接受的确切公司 地点 目的地 船名和港口值 将这些名称复制到搜索中 它们是完全匹配的 无匹配仍然返回HTTP 200并带有空列表 邮轮详情返回该航行的标题 船只 出发日期 晚数 市场货币和欧元的每人票价 每晚的欧元票价 客舱价格 促销(如果该线路发布) 目的地以及逐港的行程 最近价格下降返回票价下降的航行 包括之前的价格 当前价格 欧元的下降和下降百分比 搜索邮轮和最近价格下降上的每个过滤器都是可选的 票价未说明是否包括税费和港口费用

游轮价格 API FAQs

邮轮价格 API 允许您搜索航行并获取当前票价信息、舱房价格和详细行程。它还提供对 10 家不同邮轮公司最近降价的访问

`cruise_id` 在特定的邮轮公司和市场中是唯一的。当使用从 `搜索邮轮` 或 `最近降价` 获得的 `cruise_id` 查询 `邮轮详情` 时,您还必须提供相同的公司(邮轮公司)和地点(市场),以确保准确获取航行的详细信息

“邮轮详情”接口提供全面的信息,包括航行名称、船名、出发日期、晚数、每人费用(以市场货币和欧元计)、每晚欧元费用、详细的舱房价格、可用的促销(如果邮轮公司发布)、目的地以及逐港行程

`最近价格下降`端点是为此目的而设计的。它返回最近价格降低的航程,提供之前的价格、当前的价格、欧元的降幅以及票价减少的百分比

开发人员可以利用此 API 构建应用程序,实时显示邮轮价格,比较不同航次和邮轮公司的票价,提醒用户降价信息,并提供详细的行程信息。这使得创建动态旅游订票平台和价格跟踪工具成为可能

`搜索邮轮`接口返回航班列表,包含邮轮ID、船名、出发日期和舱位价格等详细信息 `邮轮详情`接口提供特定航班的全面信息,包括行程和票价详情 `最近降价`接口列出价格下调的航班,显示之前和当前价格以及降价百分比

关键字段包括 `cruise_id`、`company`、`departure_date`、`ship_name`、`cabin_prices_per_person` 和 `destinations` 在 `Recent Price Drops` 中,附加字段如 `previous_price`、`current_price` 和 `drop_pct` 被包含以突出票价变化

每个端点以结构化的 JSON 格式返回数据 对于 `搜索邮轮` 和 `邮轮详情` 数据嵌套在一个 `data` 对象下 而 `最近价格下降` 返回一个航行对象的数组 每个航行对象包含相关细节 使其易于解析和使用

每个端点允许可选的筛选条件,例如邮轮公司、出发日期和目的地。用户可以通过包含这些参数来自定义他们的请求,以根据特定标准缩小搜索结果

搜索邮轮 提供可用航次的列表,而 邮轮详情 则提供关于特定航次的深入信息 最近价格下跌 关注票价变化,显示哪些航次有价格降幅以及降幅是多少

用户可以提取特定字段,如`ship_name`和`departure_date`以供应用程序显示。`cruise_id`可用于从`Cruise Detail`获取详细信息,而`Recent Price Drops`可以帮助用户根据票价下降识别最佳预订时间

数据来源于各种邮轮公司,确保对可用航行和票价变化的全面概述 API 汇总这些信息,为用户提供最新和准确的邮轮详情

典型的用例包括建立旅行预订平台 创建票价比较工具 和开发提醒用户降价的应用程序 这些数据帮助用户就邮轮预订和行程做出明智的决策

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API