🧳

Tripadvisor 猫途鹰酒店、民宿与旅行数据 APIs

先用城市名换取酒店 geoId,再按入住日期搜索酒店,并读取所选酒店的照片与设施;租车、度假民宿、餐厅、航班输入和邮轮数据则需要你已有的对应标识。返回结果是查询快照,不是预订。

打开独立演示页

示例:用城市名查询酒店目的地 geoId

将示例中的 <API_KEY> 替换为你自己的、已获授权的平台 API 密钥。密钥会随请求 URL 发送,请勿放进公开链接、截图或未脱敏的日志,生产环境建议在服务端调用。

示例调用地点搜索接口,query 填 New York,用来取得可供选择的目的地建议;已观察到的成功响应带有整数 geoId,可留作后续酒店搜索的目的地标识。你可以在表单里换成其他城市或地点名称,结果可能变化,也可能为空。只有明确点击发送才会请求数据,打开页面、切换接口、展开面板或复制示例都不会发起查询。

基础 URL https://api.opendata-api.com

curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-location?key=<API_KEY>&query=New+York'
请求前先确认这些要点
  • 地点搜索返回的 geoId 是目的地标识,只用于酒店搜索和酒店筛选元数据;酒店详情的 id 是单家酒店的标识,需要从酒店搜索结果中选出并核对。两者不能互换,也不要把别的返回字符串当作酒店 id。
  • 酒店搜索、筛选元数据和酒店详情都需要明确的 YYYY-MM-DD 入住与离店日期,民宿房价则使用 startDate 和 endDate。成人数、房间数、儿童年龄和币种在搜索与后续详情之间应保持一致,否则比较的就不是同一次住宿。酒店搜索的币种参数是 currencyCode,酒店详情是 currency;币种代码可从币种列表接口获取。
  • amenity、brand、class、deals、healthSafety、neighborhood、style、type 等数组筛选项没有公开的固定取值表,rating、priceMin、priceMax、distFrom、sort 的含义和单位同样没有说明。请先查看筛选元数据接口的实际返回,只填写你核实过的值,不要猜测编码。儿童年龄用 0 到 17 的数组,0 表示不满一岁;多程航班的 legs 按行程顺序提供航段数组。
  • 民宿详情、可订日期、房价和评价需要已有的 rentalId,餐厅详情需要已有的 restaurantsId,邮轮详情需要成对的 shipId 与 seoName,租车搜索需要租车地点搜索结果中的地点 ID 和类型。民宿与餐厅的地点搜索只返回地点建议,不是房源或餐厅列表;请自备标识,并核对返回的名称和位置。
  • 实测只覆盖地点搜索、酒店搜索和酒店详情。其余接口依据文档示例说明,尚未实测,字段、覆盖范围和返回结构以实际响应为准,使用前请先检查。餐厅列表、标准航班、民宿列表和邮轮列表搜索暂不可用,因此没有收录;健康检查只能说明服务可达。
  • 返回的价格、房态、可订日历和评价都是查询时的快照,不是预订、报价承诺或支付结果;这些接口不会下单、收款或锁定房间。照片与设施列表可能不完整,展示图片前请确认你拥有相应的使用授权。

如何解读响应与业务状态

先看 HTTP 状态,再看平台网关返回的 code、message 和 data,最后才读取 data 里的接口内容:HTTP 200 并不代表业务一定成功。已观察到的成功响应中 status 为 true;地点联想直接放在 data 数组里,酒店列表在 data.data,酒店详情的 photos 与 amenitiesScreen 在 data 对象下。数组为空只说明这次没有返回内容,不能证明地点、设施或房源不存在。

按旅行任务选择接口
查找目的地并按日期搜索酒店

先用地点搜索把城市名换成 geoId,再带上入住与离店日期搜索酒店;已知经纬度时可按坐标搜索,筛选元数据接口用来查看某个目的地和日期下的可用筛选项。

读取酒店照片与设施

先从酒店搜索结果中选定一家酒店,再用它的酒店 id 和同一组入住日期、人数请求详情,读取 photos 与 amenitiesScreen 两个集合;目的地 geoId 不能充当酒店 id。

同地还车与异地还车租车搜索

按是否在同一地点还车选择接口,并自行准备租车地点搜索结果中的地点 ID、地点类型(机场还需机场代码)以及日期和时间;本项目不含租车地点搜索,这两个接口尚未实测。

度假民宿地点、详情、可订日期、房价与评价

地点搜索只用于选择民宿目的地;详情、可订日期、房价和评价都需要你已有的 rentalId,房价还要填写起止日期和成人数。民宿列表搜索暂不可用,这些接口尚未实测。

餐厅地点联想与餐厅详情

地点搜索只返回餐厅所在地或场所的建议;详情需要你已有的 restaurantsId。新接入请优先用 V2,旧版路径仅为兼容现有调用方保留;餐厅列表搜索暂不可用。

机场联想、航班筛选项与多程行程

先搜索机场取得机场代码,再查询指定航线和日期的筛选元数据,或按顺序提交多程航段;标准航班搜索暂不可用,这些接口尚未实测,航段日期需换成未来日期。

邮轮目的地、快捷链接与船只详情

目的地列表和快捷链接属于参考数据,不含航期、舱位或价格;船只详情需要成对的 shipId 与 seoName,可从快捷链接记录中取得。邮轮列表搜索暂不可用,这些接口尚未实测。

币种参考数据与服务状态

币种列表可为搜索表单提供币种代码;健康检查只确认服务可达,不返回旅行数据,也不能证明其他接口当前都可用。

租车

GET /api/project/tripadvisor-data/search-cars-different-drop-off

按不同取车与还车地点搜索租车

完整文档 →
说明

搜索取车地点与还车地点不同的租车方案。需要提供 pickUpPlaceId、pickUpLocationType、pickUpDate、pickUpTime、dropOffPlaceId、dropOffLocationType、dropOffDate、dropOffTime,以及必填的 order 字符串。地点 ID 与地点类型来自租车地点搜索结果;当地点类型为 AIRPORT 时,同时带上对应的机场代码。可选参数包括 driverAge、currencyCode 与 page,文档给出的 page 默认值为 1。日期格式为 YYYY-MM-DD。文档把时间字符串也标注为 YYYY-MM-DD,因此现有材料并不能确定可用的时刻格式。该接口没有已保存的实测记录。一份截断的文档示例展示了 data.cars 数组,其中 displayPricing.breakDown 包含 basePrice、oneWayFee、payAtPickupPrice、payNowPrice、pricePerDay、totalPrice、youngDriverFee 等字段,还包含取还车地点对象、费用、价格对象、purchaseLink 以及供应商地址信息。这些只是未经核实的示例字段,不能当作实时响应的保证结构。费用字段可能为 null,不能据此认为费用为零。这是一个搜索接口,既不完成预订或支付,也不代表当前一定有可租车辆。

试用此接口 必填 9 项 · 可选 5 项
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
可选参数 (1)
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-cars-different-drop-off?key=<API_KEY>&dropOffDate=<dropOffDate>&dropOffLocationType=<dropOffLocationType>&dropOffPlaceId=<dropOffPlaceId>&dropOffTime=<dropOffTime>&order=<order>&page=1&pickUpDate=<pickUpDate>&pickUpLocationType=<pickUpLocationType>&pickUpPlaceId=<pickUpPlaceId>&pickUpTime=<pickUpTime>'
GET /api/project/tripadvisor-data/search-cars-same-drop-off

搜索取还同一地点的租车

完整文档 →
说明

搜索还车地点与取车地点相同的租车方案。需要提供来自租车地点搜索结果的 pickUpPlaceId 与 pickUpLocationType,以及 pickUpDate、pickUpTime、dropOffDate、dropOffTime 和必填的 order 字符串。本接口没有单独的还车地点或还车地点类型参数。取车地点为 AIRPORT 时填写 pickUpAirportCode,还可以选择传入 driverAge、currencyCode 与 page。文档给出的 page 默认值为 1。日期格式为 YYYY-MM-DD;文档对必填的时间字符串也重复标注了这一日期格式,因此没有经过核实的时刻格式。该接口没有已保存的实测记录。其截断的文档示例展示了 data.cars,包含 displayPricing.breakDown、费用、pickUpLocation、dropOffLocation、price、purchaseLink、supplier、supplierRating 与 tags。供应商示例含 hasShuttle 与坐标;supplierRating 含 averageRating、cleanliness、collectTime、condition、dropOffTime、efficiency、locating 与 valueForMoney。这些都是未经核实的示例字段,既不完整,也不能保证实时返回。现有材料不能据此确定库存、当前价格、评分刻度或是否可预订。该请求只搜索数据,不会生成预订。

试用此接口 必填 7 项 · 可选 4 项
参数位置值
query
query
query
query
query
query
query
query
query
query
可选参数 (1)
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-cars-same-drop-off?key=<API_KEY>&dropOffDate=<dropOffDate>&dropOffTime=<dropOffTime>&order=<order>&page=1&pickUpDate=<pickUpDate>&pickUpLocationType=<pickUpLocationType>&pickUpPlaceId=<pickUpPlaceId>&pickUpTime=<pickUpTime>'

邮轮

GET /api/project/tripadvisor-data/get-cruises-details

按已知邮轮 ID 与 SEO 名称获取邮轮详情

完整文档 →
说明

使用必填的 shipId 与 seoName 字符串获取邮轮详情,currencyCode 可选。文档指出邮轮搜索结果与邮轮快速链接是 shipId 和 seoName 的来源。应原样保留传入的 seoName,不要假定必须转成 URL 别名;文档示例为 MSC Magnifica,对应 shipId 15691635。USD 是文档给出的币种示例。该接口没有已保存的实测记录。截断的文档响应展示了 data.itineraries.list:条目包含 cruiseLine、destination、id、带 day 与 port 对象的 itinerary.results、length、lowestPricedSailing、portDeparture、sailings、ship 与 title。航次记录包含 departureDate、id 与 priceId,sailings 还包含 totalResults。这些都是未经核实的示例字段,既不完整,也不能保证实时返回。priceId 只是一个引用,不是文档中的金额;列出的出发日期也不能证明当前有可售名额。现有材料不能据此确定甲板平面图、舱房详情、预订动作或完整的邮轮档案响应。

试用此接口 必填 2 项 · 可选 1 项
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-cruises-details?key=<API_KEY>&seoName=<seoName>&shipId=<shipId>'
GET /api/project/tripadvisor-data/get-cruises-location

获取邮轮目的地参考位置列表

完整文档 →
说明

通过 GET 请求获取邮轮位置参考列表,该接口没有专属参数。所提供的 HTTP 200 源示例包含一个 data 数组,其中每一项都有数值型 destinationId 与 locationId 字段以及字符串 name。外层结构还包含布尔型 status、字符串 message 和数值型 timestamp;示例中 status 为 true、message 为 Success,但没有说明 timestamp 的单位。Caribbean、Bahamas 等标签仅用来说明返回的目的地参考类型,并不代表覆盖范围有保证。该操作没有已保存的探测调用,所以这些只是源示例字段,而非实际执行结果,字段是否必填也未验证。请分别保留 destinationId 与 locationId,二者是否可互换、能否用于其他接口均未确立。该列表没有记录航次、出发港口、坐标、船票价格或预订可订状态。

试用此接口 必填 0 项 · 可选 0 项

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-cruises-location?key=<API_KEY>'

航班

GET /api/project/tripadvisor-data/get-filters

获取指定航线与出行日期的航班筛选项元数据

完整文档 →
说明

使用必填的字符串查询参数 classOfService、date、destinationAirportCode、itineraryType 和 sourceAirportCode 获取航班搜索的筛选项元数据。出发日期格式为 YYYY-MM-DD。文档记载的 itineraryType 取值为 ONE_WAY 和 ROUND_TRIP。returnDate 是可选的字符串,格式同为 YYYY-MM-DD;现有证据没有确立往返行程下的条件校验规则。机场代码可通过机场搜索操作获得,文档中的输入示例为 BOM 和 DEL。classOfService 没有提供可接受的取值清单。被截断的 HTTP 200 源示例显示 data.filters 是一组筛选分组的数组,每组包含 param、title 和嵌套的 filters 字段。分类类条目含有字符串 label 与 value;时间范围类条目含有数值型 index、rangeMin、rangeMax,以及字符串 title 和 subTitle。可见的分组涉及经停次数、改签/取消政策、航班时间、航空公司、航空联盟、飞行时长、中转机场和价格,部分嵌套的 filters 数组为空。这些字段来自一个不完整的源示例,而非已保存的探测调用,完整的外层结构、范围单位、响应必填字段以及当前筛选项的可用性均未验证。返回的 param 名称和取值只是元数据,不是本操作额外声明的输入,也不能证明与其他接口兼容。该响应不是航班行程列表、票价报价或预订结果。

试用此接口 必填 5 项 · 可选 1 项
参数位置值
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-filters?key=<API_KEY>&classOfService=<classOfService>&date=<date>&destinationAirportCode=<destinationAirportCode>&itineraryType=ONE_WAY&sourceAirportCode=<sourceAirportCode>'
GET /api/project/tripadvisor-data/search-airport

按地点名称搜索机场与城市建议

完整文档 →
说明

用必填的 query 字符串搜索机场建议,文档将其说明为机场所在地点的名称;提供的输入示例是 london。被截断且未经验证的源响应示例显示 data 数组,其中记录包含 airportCode,城市级结果还可能带有 children 以列出下属机场。示例子记录包含 coords、title、shortName、isChild,以及 details 中的 name、geo_name、parent_name、parent_ids 等字段。请把这些字段当作解析与消歧的参考,而不是已验证的响应契约:该操作没有已保存的专属探测记录。在为航段选定代码之前,请先检查返回的记录;城市分组并不一定对应单个机场。这是机场查询,不是航班余位或预订请求。

试用此接口 必填 1 项 · 可选 0 项
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-airport?key=<API_KEY>&query=<query>'
GET /api/project/tripadvisor-data/search-flights-multi-city

按有序航段搜索多程航班行程

完整文档 →
说明

用必填的 classOfService、sortOrder 和 legs 查询参数搜索多个航段。每个航段使用 sourceAirportCode、destinationAirportCode 和 date;文档将其表示为航段对象的 JSON 数组,但 legs 参数声明的类型仍是 object。已保存的示例使用 2025 年 10 月的历史日期,查询当前行程时必须替换。currencyCode 为可选,文档说明可从货币列表接口获取。可选的 pageLoadUid、searchHash 和 searchId 被文档化为复用上一次调用的值以获取完整响应;它们在响应中的位置以及续查时机均未验证。被截断且未经验证的源示例显示 data.complete 和 data.flights。示例航班记录包含 itineraryTag,purchaseLinks 中带有 currency、totalPrice、totalPricePerPassenger 和税费字段,segments 的航段则包含 departureDateTime、arrivalDateTime、originStationCode、destinationStationCode 以及承运信息。没有已保存的专属探测记录能确认这些字段、可接受的舱位或排序取值、实时票价或可订状态。

试用此接口 必填 3 项 · 可选 4 项
参数位置值
query
query
query
query
可选参数 (3)
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-flights-multi-city?key=<API_KEY>&classOfService=<classOfService>&legs=%5B%7B%22sourceAirportCode%22%3A%22BOS%22%2C%22destinationAirportCode%22%3A%22LON%22%2C%22date%22%3A%222025-10-18%22%7D%2C%7B%22sourceAirportCode%22%3A%22LON%22%2C%22destinationAirportCode%22%3A%22BOS%22%2C%22date%22%3A%222025-10-26%22%7D%5D&sortOrder=<sortOrder>'

参考数据

GET /api/project/tripadvisor-data/get-currency

列出旅行搜索表单可用的货币代码与名称

完整文档 →
说明

通过不带任何声明输入参数的 GET 请求获取货币参考数据。被截断且未经验证的源响应示例显示 data 对象包含 majorCurrencies 与 minorCurrencies 两个数组;示例条目包含 code、name 和 symbol 字符串。这些是文档示例字段,不是该接口的专属探测结果,因为没有已保存的探测调用。请使用实际返回的代码填充旅行表单的货币选择器,并把代码与显示名称、符号分开保存。多程航班操作的文档把这份列表作为其 currencyCode 输入的来源。如果其他旅行操作对货币输入使用了不同的参数名,请在客户端显式映射,不要假设参数名相同。该接口提供的是货币元数据,不是汇率、换算后的金额,也不保证每次旅行搜索都接受这些货币。

试用此接口 必填 0 项 · 可选 0 项

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-currency?key=<API_KEY>'

酒店

GET /api/project/tripadvisor-data/get-hotel-details

获取单个酒店的照片与设施内容集合

完整文档 →
说明

传入必填的酒店 id,以及 YYYY-MM-DD 格式的入住日期 checkIn 和退房日期 checkOut,即可获取该酒店的内容数据。酒店标识需先通过酒店搜索获得,并在作为 id 传入前核对所选结果的标识是否正确。可选的 adults、rooms、childrenAges 和 currency 用来让请求与实际出行人数和住宿安排保持一致。文档中 childrenAges 是年龄数组,取值范围 0 到 17,0 表示不满一岁的儿童。已保存的一次成功 HTTP 200 探测返回了 JSON 对象,包含 status=true、message 字符串、整数 timestamp,以及内含 photos 和 amenitiesScreen 两个数组的 data 对象。探测元数据只能证明这两个集合存在,无法说明其中每个条目的结构或内容是否完整。另有一份被截断的文档示例还显示了带有 title、tags、content 的 data.about,带有 title 和 content 的 amenitiesScreen 分区,以及 data.attractionsNearby.content;这些额外字段未被所提供的探测元数据证实。请显式处理集合为空或字段缺失的情况,不要把内容缺失当作该设施不存在的证据。本接口只是内容查询,不代表预订确认,也不保证房间库存、价格、点评或房源信息完整。

试用此接口 必填 3 项 · 可选 4 项
参数位置值
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-hotel-details?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&id=<id>'
GET /api/project/tripadvisor-data/get-hotels-filter

获取目的地与入住日期对应的酒店筛选元数据

完整文档 →
说明

使用必填的 geoId,加上 YYYY-MM-DD 格式的 checkIn 与 checkOut 日期,请求酒店搜索的筛选元数据。geoId 应取自酒店地点搜索操作返回的结果,并在这里保持为必填的字符串输入。该操作没有提供探测观测记录。被截断的文档示例显示 data 对象中包含 datePicker 和 filters 数组;这些是仅来自文档的字段,并非已验证的探测结果。示例中的 datePicker 包含 maxAdultsPerRoom、maxChildrenPerRoom、maxRooms、maxStayLength 等配置字段,以及 lastSelectableDate 和 timeZoneOffset。示例中的筛选条目包含 name 和 title、嵌套的 filters,部分条目还带有 minValue、maxValue、selectedRangeStart 和 selectedRangeEnd。在展示筛选控件或把取值映射到酒店搜索参数之前,请先检查实际返回的结构。不要根据示例硬编码通用的筛选维度列表、数值上限、可选日期或取值编码。当目的地或任一住宿日期变化时,应刷新或作废已缓存的选项。本接口描述的是搜索控件,不返回酒店结果列表,也不能确认房间可以预订。

试用此接口 必填 3 项 · 可选 0 项
参数位置值
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-hotels-filter?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&geoId=<geoId>'
GET /api/project/tripadvisor-data/search-hotels

按目的地、日期和可选筛选条件搜索酒店

完整文档 →
说明

使用必填的目的地 geoId,以及 YYYY-MM-DD 格式的 checkIn 与 checkOut 日期搜索酒店。geoId 需通过酒店地点搜索获得,并以字符串形式传入。可选的 adults、rooms 和 childrenAges 用来描述出行人员;currencyCode 从货币查询操作中选择货币;pageNumber 用于选择结果页,文档中的默认值为 1。接口还支持 sort、priceMin、priceMax、rating、distFrom、distFromMaxDistance,以及 amenity、brand、class、deals、healthSafety、neighborhood、style、type 这几个数组筛选项。所提供的文档没有定义可接受的筛选取值、排序取值、评分范围或距离单位。请先检查对应的筛选元数据再映射控件,未经验证的可选值请留空不传。已保存的一次成功 HTTP 200 探测返回了 status=true、message 字符串、整数 timestamp,以及内含 data 数组的 data 对象:已观测到的酒店列表路径是 data.data,而不是外层的 data 对象。另有一份被截断的文档示例显示结果行包含 id、title、bubbleRating、cardPhotos、isSponsored、primaryInfo、secondaryInfo、priceDetails、priceForDisplay、priceSummary 和 strikethroughPrice;这些行内字段未被所提供的探测元数据证实,不应假定一定存在。把某一行的酒店标识传给酒店详情的 id 输入之前,请先核对该标识。现有证据没有确认总数、每页数量、稳定排序、预订能力、完整库存或实时价格。

试用此接口 必填 3 项 · 可选 19 项
参数位置值
query
query
query
query
query
query
query
query
可选参数 (14)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-hotels?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&geoId=<geoId>&pageNumber=1'
GET /api/project/tripadvisor-data/search-hotels-by-location

按经纬度搜索周边酒店

完整文档 →
说明

围绕一对经纬度坐标搜索 Tripadvisor 酒店列表,并指定入住区间。必填查询参数是以字符串传入的纬度与经度,以及 YYYY-MM-DD 格式的入住日期与离店日期。可选参数覆盖成人数、房间数、儿童年龄、页码、货币代码、最低价、最高价、评分、排序,以及以数组形式传入的酒店筛选条件。文档标注的默认页码为 1;可接受的筛选标识、评分含义、排序键与距离单位均未说明。经纬度请传入坐标,不要传入目的地 geoId。 该操作在所提供的证据中没有已观测的探测响应。其未经验证且被截断的源示例在 data.data 中展示酒店卡片,包含字符串形式的 id 与 title、布尔值 isSponsored 与 accentedLabel、含字符串 count 与数值 rating 的 bubbleRating,以及带有 maxHeight、maxWidth 与 urlTemplate 尺寸对象的 cardPhotos 条目。示例中还出现 badge、provider、secondaryInfo 以及可为空的展示字段。该示例里 priceForDisplay、priceDetails、priceSummary、strikethroughPrice 与 primaryInfo 均为空。完整响应信封尚未确立,与其他酒店搜索操作的响应兼容性、实时价格、可预订库存以及明确的搜索半径均不保证。

试用此接口 必填 4 项 · 可选 19 项
参数位置值
query
query
query
query
query
query
query
query
query
可选参数 (14)
参数位置值
query
query
query
query
query
query
query
query
query
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-hotels-by-location?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&latitude=<latitude>&longitude=<longitude>&pageNumber=1'
GET /api/project/tripadvisor-data/search-location

查找酒店目的地及其 geoId

完整文档 →
说明

用必填的字符串查询参数把输入的酒店目的地解析为 Tripadvisor 地点建议。用返回的地点信息让出行者选择目的地,然后把其 geoId 与任何单个酒店 id 分开保存。该操作只查找地点,不搜索酒店库存,也不返回单个住宿的详情记录。 一次以 query=New York 发起的成功探测返回 HTTP 200,响应为 JSON 对象,包含布尔值 status、字符串 message、整数 timestamp,以及由地点对象组成的 data 数组。声明的地点字段为 documentId、secondaryText、title 与 trackingItems,出现时均为字符串。该观测响应还额外包含整型 geoId 值。请直接从 data 读取建议,而不是 data.data。未经验证的源示例展示了这些声明字段以及 title 中的 HTML 式加粗标记,但并未确立 geoId;geoId 由观测到的探测结果支持。请把结果标签当作展示内容处理,对有歧义的目的地要求明确选择,并容忍缺失的可选字段。时间戳单位与最大结果数量均未文档化。

试用此接口 必填 1 项 · 可选 0 项
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-location?key=<API_KEY>&query=<query>'

度假民宿

GET /api/project/tripadvisor-data/rental-availability

查询已知度假短租的可订数据

完整文档 →
说明

用必填的字符串查询参数 rentalId 获取一条已知 Tripadvisor 度假短租记录的可订信息。请从度假短租搜索结果中取得完整的 rentalId 并原样保留。该操作不提供日期、日期区间、入住人数或分页输入,因此无法表达任意指定的入住区间或日历更新。 该操作没有可用的观测探测响应。其未经验证且被截断的源示例展示了一个 data 对象,先按年份、再按月份缩写、再按 YYYY-MM-DD 日期键分组,日期键的值为布尔值。该示例包含历史日期,并未确立当前覆盖范围、日历完整性、true 与 false 的确切含义,或任何额外的信封字段。请把这种嵌套视为示意性的日历形态,而不是有保证的结构。收集快照时请单独记录获取时间,仅从已验证的响应推导日历粒度,不要把返回的标记等同于已确认的库存、价格或预订。

试用此接口 必填 1 项 · 可选 0 项
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-availability?key=<API_KEY>&rentalId=<rentalId>'
GET /api/project/tripadvisor-data/rental-details

按 rentalId 获取度假民宿详情

完整文档 →
说明

针对一套已知的度假民宿,通过必填的 rentalId 查询字符串获取房源内容。请完整保留该标识,参数文档指出其来源于民宿搜索结果。该操作不接受入住日期、人数或页码。 该操作在所提供的证据中没有已观测的探测响应。源响应示例被截断,其可见的 data 对象包含 amenities、geoCoordinates.lat 与 geoCoordinates.lng、nearbyGeosInfo、overview 和 paymentStats.totalPayments,随后是 photos 的开头部分。可见的 overview 字段包括 name、descriptions、averageRatingNumber、userReviewCount、roomCount、bathCount、sleepCount、minStay、cancellationPolicy、carRequired、isInstantBook 与 isOnlineBookable。这些只是未经验证的源示例字段,并非完整且已验证的结构,也不保证字段一定存在。在使用房源内容、坐标或可预订标识之前,请先检查实际返回的结构;该查询不会创建预订,也不提供带日期的报价。

试用此接口 必填 1 项 · 可选 0 项
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-details?key=<API_KEY>&rentalId=VacationRentalReview-g60763-d24235431-Sonder_The_Industrialist_Queen_Room-New_York_City_New_York'
GET /api/project/tripadvisor-data/rental-rates

按入住日期与人数获取民宿房价

完整文档 →
说明

针对一套已知度假民宿请求房价信息,必填查询参数为 rentalId、adults、startDate 与 endDate。adults 是数值型的入住人数输入;startDate 为入住日期,endDate 为离店日期,二者均采用 YYYY-MM-DD 格式。可选的 currencyCode 用于选择文档中的货币代码,USD 仅为示例,并不代表服务端默认值。 该操作在所提供的证据中没有已观测的探测响应。未经验证的源示例顶层包含 data、message、status 与 timestamp 字段;其中 data 含有 rapData、rapRate、view、errors 和 validationError。示例中的 rapData 字段包括 baseRate、bookingFee、ownerFees、deposit、subtotal 与 tax,并配有对应的货币字段和若干格式化后的价格值。rapRate 字段包括 amount、currency、details、minStay、instantBook 与 paymentSchedule;details 的每一项含 amount、currency、optional、refundable、ruleDescription、ruleType、type 与 typeName,paymentSchedule 的每一项含 amount、currency 与 dueDate。view 则包含 adults、guests、stayLength、checkInDate、checkOutDate,以及入住或可订状态的阻断标识。部分示例字段为空。请将这些视为源示例字段,而非已验证的响应契约:在展示总价之前,先确认费用、税费、货币与金额的具体含义。这是房价查询,不是预订,也不保证当前可订或价格可成交。

试用此接口 必填 4 项 · 可选 1 项
参数位置值
query
query
query
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-rates?key=<API_KEY>&adults=<adults>&endDate=<endDate>&rentalId=<rentalId>&startDate=<startDate>'
GET /api/project/tripadvisor-data/rental-reviews

分页获取已知度假民宿的住客评价

完整文档 →
说明

针对一套已知度假民宿请求住客评价数据,必填查询字符串为 rentalId,另有可选的数值型 page。参数文档标明默认页码为 1,并指出 rentalId 来自民宿搜索结果。连续翻页时请完整保留该房源标识。 该操作在所提供的证据中既没有响应示例,也没有已观测的探测响应,因此现有证据无法确定响应外层结构、评价条目的字段名与类型、稳定的评价标识、每页条数元数据,或最后一页的判断信号。在设计解析器、选择去重键或确定分页终止条件之前,请先检查实际返回的数据。已记录的输入中不包含语言、评分、日期范围、每页条数或排序筛选。这是度假民宿的住客反馈查询,不是酒店评价数据流,分页也不代表覆盖了全部历史评价。

试用此接口 必填 1 项 · 可选 1 项
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-reviews?key=<API_KEY>&page=1&rentalId=<rentalId>'
GET /api/project/tripadvisor-data/search-vacation-rental-location

按地名搜索度假民宿目的地

完整文档 →
说明

根据用户输入的地名,通过必填的 query 字符串参数查询度假民宿目的地建议。传入城市、地区或国家名称,即可获得候选地点记录,方便民宿类界面让用户选定目的地。该操作只负责解析目的地:不返回民宿房源、价格、可订状态或评价,也不接受日期、入住人数和页码。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。示例中的 data 数组由地点对象组成,字段包括 geoId、locationId、isGeo、localizedName、localizedAdditionalNames、locationV2、placeType、latitude、longitude,以及 thumbnail.photoSizeDynamic 对象(含 maxHeight、maxWidth 和带有 {width}、{height} 占位符的 urlTemplate)。示例中的 placeType 取值有 CITY、STATE、COUNTRY 和 MUNICIPALITY,示例地点包括 New York City、New Orleans、Newport 和 New Zealand。data 之外的外层字段、最大返回条数、排序方式和错误行为,现有证据均无法确定。使用任何字段之前,请先检查实际返回结果,把名称标签当作展示文本;若要把返回的标识传给其他操作,请先在该操作的文档中确认它是否接受这个标识。

试用此接口 必填 1 项 · 可选 0 项
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-vacation-rental-location?key=<API_KEY>&query=<query>'

餐厅

GET /api/project/tripadvisor-data/get-restaurant-details-deprecated

按 restaurantsId 获取餐厅详情(旧版路径)

完整文档 →
说明

通过已弃用的餐厅详情路径,获取一家已知 Tripadvisor 餐厅的详情记录。必填的 restaurantsId 字符串按文档说明应取自餐厅搜索结果,可选的 currencyCode 字符串按文档说明应取自货币参考查询,示例值为 USD。已有客户端可以沿用这种请求形式,同时规划迁移到 V2 详情操作;新接入请直接从 V2 开始。该查询只返回单家餐厅的详情,不负责搜索餐厅、列出菜单或受理预订。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。可见部分显示一个包含 hours 和 location 的 data 对象。hours 对象包含 allOpenHours(星期与时间)、currentHoursText、hoursTodayText、openStatus、openStatusText 和 addHoursLink。location 对象包含 address、address_obj(street1、street2、city、state、postalcode、country)、ancestors、category、cuisine、dietary_restrictions、description、display_hours、内嵌的 hours 对象(含 timezone 和由 open_time、close_time 组成的 week_ranges)、latitude、longitude、location_id、location_string、name、neighborhood_info、num_reviews、awards、open_now_text,以及带有多种图片规格的 photo 对象。latitude、longitude、location_id 和 num_reviews 在示例中为字符串。示例在中途被截断,其余字段、错误响应以及 currencyCode 的实际作用均无法确定。可见部分与 V2 示例一致;两者在结构或状态行为上是否存在差异,文档中没有说明,因此切换路径之前请先对比真实响应。

试用此接口 必填 1 项 · 可选 1 项
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-restaurant-details-deprecated?key=<API_KEY>'
GET /api/project/tripadvisor-data/get-restaurant-details-v2

按 restaurantsId 获取餐厅详情(V2)

完整文档 →
说明

通过 V2 餐厅详情路径,获取一家已知 Tripadvisor 餐厅的详情记录。必填的 restaurantsId 字符串按文档说明应取自餐厅搜索结果,可选的 currencyCode 字符串按文档说明应取自货币参考查询,示例值为 USD。适合为已确定的餐厅补全地址、菜系、营业状态和照片数据。它不负责搜索餐厅,也不返回菜单、评价文本或预订功能。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。可见部分显示一个包含 hours 和 location 的 data 对象。hours 对象包含 openStatus、openStatusText、currentHoursText、hoursTodayText、allOpenHours(星期与时间)和 addHoursLink。location 对象包含 name、description、address、address_obj(street1、street2、city、state、postalcode、country)、ancestors、category、cuisine、dietary_restrictions、display_hours、内嵌的 hours 对象(含 timezone 和由 open_time、close_time 组成的 week_ranges)、latitude、longitude、location_id、location_string、neighborhood_info、num_reviews、awards、parent_display_name,以及含 large、medium、original、small、thumbnail 多种规格的 photo 对象。latitude、longitude、location_id 和 num_reviews 在示例中为字符串,另有若干字段在示例中为 null。示例在中途被截断,其余字段、错误响应以及 currencyCode 的实际作用均无法确定。在决定展示或存储哪些字段之前,请先检查实际返回结果。

试用此接口 必填 1 项 · 可选 1 项
参数位置值
query
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-restaurant-details-v2?key=<API_KEY>'
GET /api/project/tripadvisor-data/search-restaurant-location

按名称搜索餐厅所在地与餐饮场所

完整文档 →
说明

根据用户输入的名称,通过必填的 query 字符串参数查询餐饮地点建议。传入城市、区域名称,或餐厅名称的一部分,即可读取返回的地点记录,方便餐厅类界面让用户选定目标位置。该参数的文档说明是餐厅所在地点的名称。此操作只返回建议记录:不返回餐厅详情、菜单、营业时间、评价或预订信息,也不接受筛选、语言或分页输入。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。以查询词 mumbai 为例,示例中的 data 数组由地点对象组成,字段包括 documentId、locationId、isGeo、localizedName、placeType、latitude、longitude、localizedAdditionalNames.longOnlyHierarchy、locationV2(含 names.longOnlyHierarchyTypeaheadV2、placeType,以及要么是带 url 的对象、要么为 null 的 vacationRentalsRoute)、streetAddress.street1,以及 thumbnail.photoSizeDynamic 对象(含 maxHeight、maxWidth 和带有 {width}、{height} 占位符的 urlTemplate)。第一条示例记录是城市 Mumbai,isGeo 为 true、placeType 为 CITY;其余可见记录的 isGeo 为 false、placeType 为 EATERY,例如印度尼西亚的 Mumbai Kitchen 和西班牙的多家 Mumbai Masala 分店,因此一次响应里可能同时混有地区记录和单个餐厅记录。示例在中途被截断,完整的结果数量、排序方式、data 之外的外层字段以及错误行为均无法确定。请把名称标签当作展示文本,使用任何字段之前先检查实际返回结果,并且不要想当然地认为 locationId 或 documentId 可以直接作为 restaurantsId 传给其他操作,务必先查阅那个操作自身的输入文档。

试用此接口 必填 1 项 · 可选 0 项
参数位置值
query

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-restaurant-location?key=<API_KEY>&query=<query>'

服务状态

GET /api/project/tripadvisor-data/test-api

检查 API 服务器是否正常运行

完整文档 →
说明

发送一个不带参数的 GET 请求,即可确认 Tripadvisor 数据 API 服务器是否可达并能正常响应。该操作的文档说明是测试服务器是否已启动并运行。调用方无需提供任何查询、路径、请求头或请求体输入,返回结果中也不含任何旅行数据:没有酒店、餐厅、航班、邮轮或民宿内容。 该操作没有提供已观测的探测响应,响应说明来自源示例,尚未经过验证。200 响应的示例是一个只有两个字段的小型 JSON 对象:message 字符串内容为 Server is up and running,以及布尔值 status 为 true。status 是否会出现 false、是否还会返回其他字段,以及错误或访问问题如何呈现,现有证据均无法确定。请把成功的响应只当作可达性信号:它并不能说明酒店、餐厅、航班、邮轮或民宿等操作的数据是否新鲜、完整或健康,因此还需要单独测试应用实际依赖的那个操作。

试用此接口 必填 0 项 · 可选 0 项

调用成本暂不可用,未假定任何价格。

查看价格
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/test-api?key=<API_KEY>'

接口能力与已知边界

查询 Tripadvisor(猫途鹰)旅行数据:先把城市名换成酒店 geoId,再按入住日期搜索酒店,并按需读取单家酒店的照片与设施;另提供租车、度假民宿、餐厅、航班输入和邮轮参考数据等扩展接口。

  • 目的地查询:把城市或地点名称换成酒店搜索所需的 geoId
  • 酒店搜索:按 geoId 或经纬度查询带日期的酒店列表,支持人数、房间、价格与筛选条件,并可读取筛选元数据
  • 酒店详情:读取所选酒店在指定住宿条件下的照片与设施集合
  • 租车查询:同地还车与异地还车的取还车搜索,含日期、时间与驾驶员年龄
  • 度假民宿:地点查询,以及已知 rentalId 的详情、可订日期、日期房价与评价分页
  • 餐厅与邮轮:按 ID 查询餐厅详情,另有邮轮目的地、快捷链接与船只参考数据
  • 航班输入与参考数据:机场联想、航线筛选元数据、多程行程和可用币种代码

实测仅覆盖地点搜索、酒店搜索和酒店详情,其余接口有文档说明但尚未实测。餐厅列表、标准航班、民宿列表和邮轮列表搜索暂不可用。这是非官方的旅行数据接口,不提供预订、支付或订单功能;价格和房态只是查询时的快照,照片与设施列表可能不完整,也可能受图片使用权限制。

相关指南