搜索机场与城市，获取航班查询标识
查看 Skyscanner 天巡机票与酒店查询 的全部接口 →传入机场或城市名称 query，可选 market 与 locale 控制查询地区和语言区域。已测试响应的 places 包含 skyId、entityId、iataCode、name、cityName、countryName、placeType 和 coordinates.lat/lng。London 曾返回 CITY 类型的伦敦城市建议（LOND、27544008），以及希思罗等 AIRPORT 建议；希思罗对应 LHR、95565050。选定后将该条建议的配套标识用于航班搜索，注意城市范围与单一机场的区别。有效机场的 iataCode 也可能是空字符串，不应因此丢弃已返回 skyId/entityId 的建议。不存在的名称在测试中返回 HTTP 200 与 places:[]，属于正常未命中，不是服务中断；建议的顺序与数量可能变化。
API 功能
城市范围与具体机场分开选择 placeType 区分 CITY 与 AIRPORT，可让用户选择整个城市或一个指定机场，不把二者视为同一范围。
获取后续航线必需的标识对 返回的 skyId/entityId 可用于主要航班搜索与按出发地探索目的地，不需要根据名称猜测 ID。
用城市和国家消除同名歧义 同时展示 name、cityName 与 countryName，避免仅按文字相似度选择第一个地点。
接受 IATA 为空的有效建议 iataCode 为空不等于地点无效；已返回的 skyId 和 entityId 才是后续航班查询所需标识。
空建议列表表示未匹配 不存在的名称曾返回 HTTP 200 与 places:[]，应提示换关键词，不虚构地点标识。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/skyscanner/flights-search-airport API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-airport?key=<API_KEY>&query=<query>&market=US&locale=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-airport?key=<API_KEY>&query=<query>&market=US&locale=en-US'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 机票出发到达自动补全：将伦敦城市与希思罗机场分开列出，并在选中后保存各自的 skyId/entityId。
- 地点名称标准化：把用户输入的机场名称转换为可复用的航线选择项，保留类型与国家信息。
- 同名机场位置核对：结合建议中的经纬度帮助用户确认目标地点，减少跨国家或地区误选。
- 搜索框未命中处理：places 为空时引导修改输入，IATA 为空时仍保留具备有效查询标识的地点。
常见问题
skyId、entityId 和机场 IATA 三字码有什么区别？
skyId 与 entityId 是后续航班搜索使用的地点标识，应从同一条建议成对取得。IATA 是机场或城市代码信息，不能代替 entityId；城市 skyId 也不一定是三字码，例如伦敦城市返回 LOND。具体机场与城市建议可能覆盖不同范围，请按 placeType 选择。
机场搜索返回 HTTP 200 但 places 或 IATA 代码为空，怎么办？
places:[] 表示没有匹配到可选地点，可调整名称或地区后再次主动查询，不要编造标识。某条有效建议的 iataCode 为空则是另一种情况：保留它返回的 skyId/entityId，并结合名称、国家和类型确认地点，不应仅因 IATA 为空就判定失败。