用 Python 调用 Skyscanner 机票价格日历 API:筛选低价出行日期
做灵活日期推荐时,最省事的写法是:脑子里蹦出希思罗 LHR、肯尼迪 JFK,直接塞进价格日历,把最便宜的那一格当成能订的票价。这个假设两头都错。日历认的不是你记得的 IATA,格子上的数字也不是已经锁住的机票。用户还没定哪天走,不等于可以跳过地点解析,更不等于格子里的金额能直接写进推送标题。
伦敦城市的 skyId 是 LOND,四个字母,entityId 是 27544008;希思罗是 LHR / 95565050。纽约都会是 NYCA。靠记忆填三字码,会跳过「城市还是机场」的选择,复查航班时还缺同一条补全结果里的成对 entityId。正确顺序是:两端地点都解析完,再拉日历,最后对选中的那天再搜一次行程。同一条航线、同一种币种、同一个舱位里比日期,才有排序意义。
Skyscanner 机票价格日历 比较的是本次返回里有报价的出发日,不是全网最低价承诺。打开本页或复制代码不会发请求。
先在控制台取自己有权使用的平台 Key;需要账号时走登录。Python 从服务端环境变量 OPENDATA_API_KEY 读取,示例里的 YOUR_API_KEY 只是占位。Key 走查询串,不要写进前端、仓库或完整访问日志。HTTP 4xx/5xx 表示请求没跑起来(鉴权、额度或网络)。网关是 {code, message, data},code 为 200 只说明平台接受了这次调用,不等于地点命中、当天有报价、或航班已经搜完。
别靠记忆填机场代码
省事调用长这样:originSkyId=LHR、destinationSkyId=JFK,再写死一个过期的 fromDate,既不补全地点,也不带 entityId。有时这些 skyId 碰巧就是机场代码,那是运气,不是契约。真实建议里的 iataCode 可以为空。城市和单机场不是同一范围:用伦敦城市搜,行程里实际起飞机场仍可能是希思罗。一端记机场、一端记都会,排出来的「低价日」对的可能不是你以为的那条航线。
正确的第一跳是 flights-search-airport。文档示例用 query=London,可加 market=US、locale=en-US。读 places,按 name、countryName、placeType(CITY 还是 AIRPORT)挑选,同一行同时留下 skyId 和 entityId。纽约再解析一次。建议顺序和条数会变,不要写死「第一条一定是希思罗」。HTTP 200 且 places:[] 是干净的无匹配,改关键词或换市场语言再查,不要编造 ID。不要用 IATA 顶替 entityId。选城市还是选机场,后面日历和行程搜索都要沿用同一种粒度,中途不要混搭。
两端地点解析完再拉日历
两端都解析完,才调用 flights-get-price-calendar。必填 originSkyId、destinationSkyId、fromDate;加上 toDate 明确未来区间,结束日不要早于开始日。currency、market、cabinClass 是比较上下文,排序时必须一致,也不要和复查航班时的舱位人数对不上。日历本身不收 entityId,但复查航班要成对带上,所以解析这一步不能省。过期日期、过去的窗口,都不该拿来当「最低价」样本。
文档里的伦敦—纽约窗口用过城市 skyId LOND / NYCA、连续八天。下面脚本改解析希思罗和肯尼迪,让日历和行程搜索对准同一机场粒度。日期在运行时计算,避免示例带着过期出行日。先装 requests,在服务器导出密钥再执行。
import math
import os
from datetime import date, timedelta
import requests
BASE = "https://api.opendata-api.com/api/project/skyscanner"
API_KEY = os.environ["OPENDATA_API_KEY"]
def get(operation, **params):
try:
response = requests.get(
f"{BASE}/{operation}",
params={"key": API_KEY, **params},
timeout=45,
)
except requests.RequestException:
raise RuntimeError("Transport failure; inspect redacted logs.") from None
if not response.ok:
raise RuntimeError(f"HTTP failure: {response.status_code}")
body = response.json()
if not isinstance(body, dict) or body.get("code") != 200:
raise RuntimeError("Business failure; inspect redacted code/message.")
payload = body.get("data")
if not isinstance(payload, dict):
raise RuntimeError("Inspect the endpoint payload before parsing.")
return payload
def airport(query, sky_id):
places = get(
"flights-search-airport",
query=query,
market="US",
locale="en-US",
).get("places", [])
for place in places:
if (
isinstance(place, dict)
and place.get("skyId") == sky_id
and place.get("placeType") == "AIRPORT"
and place.get("entityId")
):
return place
raise RuntimeError("No matching airport; review actual suggestions.")
origin = airport("London", "LHR")
destination = airport("New York", "JFK")
start = date.today() + timedelta(days=45)
end = start + timedelta(days=7)
calendar = get(
"flights-get-price-calendar",
originSkyId=origin["skyId"],
destinationSkyId=destination["skyId"],
fromDate=start.isoformat(),
toDate=end.isoformat(),
currency="USD",
market="US",
cabinClass="economy",
)
if calendar.get("currency") != "USD":
raise RuntimeError("Check returned quote currency before comparison.")
quoted = []
for row in calendar.get("outboundDates") or []:
if not isinstance(row, dict) or row.get("hasQuote") is not True:
continue
try:
day = date.fromisoformat(row.get("date", ""))
except (TypeError, ValueError):
continue
price = row.get("price")
if (
start <= day <= end
and type(price) in (int, float)
and math.isfinite(price)
and price >= 0
):
quoted.append((day, price))
if not quoted:
raise SystemExit("No usable quoted dates; review the route or range.")
for day, price in sorted(quoted):
print(day.isoformat(), price, calendar["currency"])
selected_day, selected_price = min(quoted, key=lambda item: item[1])
print("Lowest returned quote:", selected_day, selected_price)
已观察到的日历字段是 currency 和 outboundDates(date、数值 price、group、hasQuote)。伦敦—纽约示例曾覆盖请求的八天,并带 low / medium 这类相对分组。其他航线覆盖可能不同。缺日期或 hasQuote 不为真,是未知,不是零元机票。group 不是全网最低徽章。已观察响应里没有 directPrice 或 isDirect,不能据此筛直飞。
格子上的低价不是已订票价
对 quoted 排序再取最小,只回答一件事:在这次快照、这个币种、舱位和市场里,返回且有报价的哪一天更便宜。它不保证卖家覆盖完整、当天还有位子、或数字会和行程搜索一致。不要把缺口填成 0,不要把美元格子和其他币种混排,也不要用相对分组 group 当筛选条件去宣称「全网最低」。某天没有格子,不等于当天没有航班,更不等于可以告诉用户「那天飞不了」。
outboundDates 缺失或不是列表时停下来,那是结构对不上,不是「整月都超便宜」。整月单程 flights-get-cheapest-oneway 文档要 month(YYYY-MM),响应结构尚未独立验证,不要套用上面的解析器。往返组合走 flights-get-price-calendar-return,没有文档支持的任意结束日参数;把两条独立单程日历的最低价拼起来,不是往返报价。应用侧可以再筛周末、七晚这类停留长度,那是你自己的规则,不是日历接口的参数。
展示时写成查询时参考价,并记下检索时间、航线标识、币种、舱位和日期窗口。定时任务、价格档案和提醒都由你的应用自己做,接口不提供历史票价库,也不提供订阅降价。内容选题或促销邮件可以用这些日期当线索,但不要写成保证成交价。
选定日期还要再查一次
把选中的那天交给 flights-search-flights,带上两端成对的 skyId / entityId、date,以及同一套 currency、market、cabinClass。往返再加更晚的 returnDate。检查 itineraries 里的 price.amount / price.currency、各段实际机场、时刻、durationMinutes、stopCount、航司和 bookingUrl。伦敦城市搜出来的行程,腿上仍可能是希思罗到肯尼迪,要以腿上的机场为准。复查金额可以和日历格子不一致。预订链接是跳转,不是出票。这个接口不能锁价、不能出票、不能建酒店或租车订单。
flights = get(
"flights-search-flights",
originSkyId=origin["skyId"],
originEntityId=origin["entityId"],
destinationSkyId=destination["skyId"],
destinationEntityId=destination["entityId"],
date=selected_day.isoformat(),
adults=1,
cabinClass="economy",
currency="USD",
market="US",
countryCode="US",
)
print("Search status:", flights.get("status"))
RESULT_STATUS_INCOMPLETE 可以和可用行程、total、sessionToken 同时出现,名单仍是部分结果。HTTP 200 或外层 code=200 都不等于搜完。若要续查,把本次查询的 token 作为 sessionId 传给 flights-search-incomplete,币种和 countryCode 保持一致。续查本身尚未独立验证:先看结构再合并,按行程标识去重,并设退避、次数和超时。会话只留服务端,不要打印或写进公开示例;过期就重新搜,不要硬造 itineraryId。
这条链路做不到:用记忆中的 IATA 冒充地点、从日历格子筛直飞、把空 places 编成 ID、把未验证的整月或往返网格当成交价、或跳过复查直接当已订。选定日期,再查一次;只把这次搜索真正返回的链接交给用户。