Tripadvisor 猫途鹰酒店、民宿与旅行数据 — 打开交互式演示
引导式在线测试。想要原始接口文档? 查看接口文档 & 测试 →
接口列表
每次调用都会自动附带你的 API Key。
/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,不能据此认为费用为零。这是一个搜索接口,既不完成预订或支付,也不代表当前一定有可租车辆。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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。这些都是未经核实的示例字段,既不完整,也不能保证实时返回。现有材料不能据此确定库存、当前价格、评分刻度或是否可预订。该请求只搜索数据,不会生成预订。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 只是一个引用,不是文档中的金额;列出的出发日期也不能证明当前有可售名额。现有材料不能据此确定甲板平面图、舱房详情、预订动作或完整的邮轮档案响应。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/tripadvisor-data/get-cruises-quick-links 获取邮轮公司与船只快捷链接参考数据
说明
通过 GET 请求获取邮轮快捷链接参考数据,该接口没有专属的路径、查询或请求体参数。所提供的 HTTP 200 源示例(已截断)显示顶层 data 数组由邮轮公司记录组成:每条可见的公司记录包含数值型 locationId、字符串 name 与 seoName,以及 ships 数组;可见的船只记录包含字符串 name 与 seoName,以及数值型 shipId。这些是文档示例字段,并非实际探测结果:该操作没有已保存的探测调用,且示例片段不完整,因此完整的响应外层结构、字段是否必填以及当前目录覆盖范围均未验证。示例中看不到任何 URL 字段,请勿把 seoName 当作可直接打开的链接。本接口返回的是参考数据,不是航次日程、可订状态、船票价格或预订结果。
调用成本暂不可用,未假定任何价格。
/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,二者是否可互换、能否用于其他接口均未确立。该列表没有记录航次、出发港口、坐标、船票价格或预订可订状态。
调用成本暂不可用,未假定任何价格。
/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 名称和取值只是元数据,不是本操作额外声明的输入,也不能证明与其他接口兼容。该响应不是航班行程列表、票价报价或预订结果。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/tripadvisor-data/search-airport 按地点名称搜索机场与城市建议
说明
用必填的 query 字符串搜索机场建议,文档将其说明为机场所在地点的名称;提供的输入示例是 london。被截断且未经验证的源响应示例显示 data 数组,其中记录包含 airportCode,城市级结果还可能带有 children 以列出下属机场。示例子记录包含 coords、title、shortName、isChild,以及 details 中的 name、geo_name、parent_name、parent_ids 等字段。请把这些字段当作解析与消歧的参考,而不是已验证的响应契约:该操作没有已保存的专属探测记录。在为航段选定代码之前,请先检查返回的记录;城市分组并不一定对应单个机场。这是机场查询,不是航班余位或预订请求。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/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 以及承运信息。没有已保存的专属探测记录能确认这些字段、可接受的舱位或排序取值、实时票价或可订状态。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/tripadvisor-data/get-currency 列出旅行搜索表单可用的货币代码与名称
说明
通过不带任何声明输入参数的 GET 请求获取货币参考数据。被截断且未经验证的源响应示例显示 data 对象包含 majorCurrencies 与 minorCurrencies 两个数组;示例条目包含 code、name 和 symbol 字符串。这些是文档示例字段,不是该接口的专属探测结果,因为没有已保存的探测调用。请使用实际返回的代码填充旅行表单的货币选择器,并把代码与显示名称、符号分开保存。多程航班操作的文档把这份列表作为其 currencyCode 输入的来源。如果其他旅行操作对货币输入使用了不同的参数名,请在客户端显式映射,不要假设参数名相同。该接口提供的是货币元数据,不是汇率、换算后的金额,也不保证每次旅行搜索都接受这些货币。
调用成本暂不可用,未假定任何价格。
/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;这些额外字段未被所提供的探测元数据证实。请显式处理集合为空或字段缺失的情况,不要把内容缺失当作该设施不存在的证据。本接口只是内容查询,不代表预订确认,也不保证房间库存、价格、点评或房源信息完整。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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。在展示筛选控件或把取值映射到酒店搜索参数之前,请先检查实际返回的结构。不要根据示例硬编码通用的筛选维度列表、数值上限、可选日期或取值编码。当目的地或任一住宿日期变化时,应刷新或作废已缓存的选项。本接口描述的是搜索控件,不返回酒店结果列表,也不能确认房间可以预订。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 输入之前,请先核对该标识。现有证据没有确认总数、每页数量、稳定排序、预订能力、完整库存或实时价格。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 均为空。完整响应信封尚未确立,与其他酒店搜索操作的响应兼容性、实时价格、可预订库存以及明确的搜索半径均不保证。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 由观测到的探测结果支持。请把结果标签当作展示内容处理,对有歧义的目的地要求明确选择,并容忍缺失的可选字段。时间戳单位与最大结果数量均未文档化。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/api/project/tripadvisor-data/rental-availability 查询已知度假短租的可订数据
说明
用必填的字符串查询参数 rentalId 获取一条已知 Tripadvisor 度假短租记录的可订信息。请从度假短租搜索结果中取得完整的 rentalId 并原样保留。该操作不提供日期、日期区间、入住人数或分页输入,因此无法表达任意指定的入住区间或日历更新。 该操作没有可用的观测探测响应。其未经验证且被截断的源示例展示了一个 data 对象,先按年份、再按月份缩写、再按 YYYY-MM-DD 日期键分组,日期键的值为布尔值。该示例包含历史日期,并未确立当前覆盖范围、日历完整性、true 与 false 的确切含义,或任何额外的信封字段。请把这种嵌套视为示意性的日历形态,而不是有保证的结构。收集快照时请单独记录获取时间,仅从已验证的响应推导日历粒度,不要把返回的标记等同于已确认的库存、价格或预订。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/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。这些只是未经验证的源示例字段,并非完整且已验证的结构,也不保证字段一定存在。在使用房源内容、坐标或可预订标识之前,请先检查实际返回的结构;该查询不会创建预订,也不提供带日期的报价。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/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,以及入住或可订状态的阻断标识。部分示例字段为空。请将这些视为源示例字段,而非已验证的响应契约:在展示总价之前,先确认费用、税费、货币与金额的具体含义。这是房价查询,不是预订,也不保证当前可订或价格可成交。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/api/project/tripadvisor-data/rental-reviews 分页获取已知度假民宿的住客评价
说明
针对一套已知度假民宿请求住客评价数据,必填查询字符串为 rentalId,另有可选的数值型 page。参数文档标明默认页码为 1,并指出 rentalId 来自民宿搜索结果。连续翻页时请完整保留该房源标识。 该操作在所提供的证据中既没有响应示例,也没有已观测的探测响应,因此现有证据无法确定响应外层结构、评价条目的字段名与类型、稳定的评价标识、每页条数元数据,或最后一页的判断信号。在设计解析器、选择去重键或确定分页终止条件之前,请先检查实际返回的数据。已记录的输入中不包含语言、评分、日期范围、每页条数或排序筛选。这是度假民宿的住客反馈查询,不是酒店评价数据流,分页也不代表覆盖了全部历史评价。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 之外的外层字段、最大返回条数、排序方式和错误行为,现有证据均无法确定。使用任何字段之前,请先检查实际返回结果,把名称标签当作展示文本;若要把返回的标识传给其他操作,请先在该操作的文档中确认它是否接受这个标识。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/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 示例一致;两者在结构或状态行为上是否存在差异,文档中没有说明,因此切换路径之前请先对比真实响应。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 的实际作用均无法确定。在决定展示或存储哪些字段之前,请先检查实际返回结果。
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
/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 传给其他操作,务必先查阅那个操作自身的输入文档。
| 参数 | 位置 | 值 |
|---|---|---|
| query |
调用成本暂不可用,未假定任何价格。
/api/project/tripadvisor-data/test-api 检查 API 服务器是否正常运行
说明
发送一个不带参数的 GET 请求,即可确认 Tripadvisor 数据 API 服务器是否可达并能正常响应。该操作的文档说明是测试服务器是否已启动并运行。调用方无需提供任何查询、路径、请求头或请求体输入,返回结果中也不含任何旅行数据:没有酒店、餐厅、航班、邮轮或民宿内容。 该操作没有提供已观测的探测响应,响应说明来自源示例,尚未经过验证。200 响应的示例是一个只有两个字段的小型 JSON 对象:message 字符串内容为 Server is up and running,以及布尔值 status 为 true。status 是否会出现 false、是否还会返回其他字段,以及错误或访问问题如何呈现,现有证据均无法确定。请把成功的响应只当作可达性信号:它并不能说明酒店、餐厅、航班、邮轮或民宿等操作的数据是否新鲜、完整或健康,因此还需要单独测试应用实际依赖的那个操作。
调用成本暂不可用,未假定任何价格。