查询单程或往返机票

查看 Skyscanner 天巡机票与酒店查询 的全部接口 →

先从机场搜索中选定出发地和目的地，分别传入同一条地点建议的 skyId 与 entityId，再提供未来的出发日期 date，格式为 YYYY-MM-DD。单程查询不传 returnDate；往返查询需提供晚于出发日的返程日期。可选参数包含成人、儿童、婴儿人数、舱位、币种、market 与 countryCode。已测试的单程响应包含 sessionToken、status、total 和 itineraries；行程带有 id、price.amount/currency/formatted、legs、score、tags 与 bookingUrl，航段带有实际机场、起降时间、durationMinutes、stopCount 和航空公司名称及 logoUrl。伦敦城市搜索曾返回希思罗至肯尼迪机场的方案，因此城市标识不等于只选择一个机场。RESULT_STATUS_INCOMPLETE 时也可能已有可用报价，可将 sessionToken 作为 sessionId 继续查询，不应把首批 total 当作最终数量。报价与链接只代表当次观察，本接口不出票；往返响应尚未单独核实。

API 功能

出发与到达地点成对标识 每一端使用同一地点返回的 skyId/entityId，不把 IATA 三字码当作 entityId，也不混用城市与机场标识。
逐航段核对起降与中转 从 legs 读取实际机场、起降时间、durationMinutes、stopCount 和航空公司名称，比较具体行程而非仅看城市名。
金额与展示文本分开读取 price.amount 与 price.currency 用于计算，price.formatted 用于展示；同时保留人数和舱位等查询条件。
首批报价可带未完成状态 已测试结果在返回可用行程的同时带有 RESULT_STATUS_INCOMPLETE 与 sessionToken，首批数量不代表最终数量。
从比价结果前往预订页面 返回的 bookingUrl 可用于跳转查看报价；跳转其他页面与通过本 API 创建订单是两回事。

在线 API 演示

GET /api/project/skyscanner/flights-search-flights

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-flights?key=<API_KEY>&originSkyId=<originSkyId>&originEntityId=<originEntityId>&destinationSkyId=<destinationSkyId>&destinationEntityId=<destinationEntityId>&date=<date>&adults=1&cabinClass=economy'
📢
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
联系我们

使用场景

常见问题

如何用 Python 调用 Skyscanner API 查询机票？

先通过机场搜索获取出发地和目的地各自的 skyId/entityId，再用 Python requests 的 params 传入这四个标识、未来的 date 与平台 API 密钥。检查 HTTP 状态和网关 code/message/data 后再读取行程；若 status 为 RESULT_STATUS_INCOMPLETE，可把返回的 sessionToken 交给继续查询接口。

单程和往返怎么区分，这个接口能直接出票吗？

单程不传 returnDate；往返传入晚于 date 的返程日期。已测试的是单程响应，往返字段需以实际返回为准。本接口只查询行程与报价，结果中可能含 bookingUrl，不收款、不出票，也不保证此前看到的价格仍可预订。

相关接口

相关指南

查看订阅方案 →