Airbnb 爱彼迎房源、房价与评论查询 APIs

使用目的地联想返回的 placeId 搜索住宿，原样传入 explore_search_params.place_id，不要换成城市名称。可选 checkinDate、checkoutDate 使用 YYYY-MM-DD 格式；比较结果时保持成人数、currencyCode 和 languageCode 一致。巴黎实测响应包含 status、message、meta，以及 data 内的 filters、paginationInfo、searchInput 和 searchResults。结果含 listing.id、标题、照片、demandStayListing.location.coordinate 坐标和 structuredDisplayPrice。将 paginationInfo.nextPageCursor 作为 pageCursor 继续搜索；meta.currentPage 只是响应信息，不是请求页码。不传日期时可能显示建议日期的价格，而非你的行程报价。

传入 Paris, France 等目的地 query 查找房源。可选 checkin、checkout 为 YYYY-MM-DD 格式，并可用人数、currency、locale、page、预算及返回的筛选标识缩小范围。实测成功响应含 status:true、巴黎相关 message、currentPage、resultsPerPage、totalPages、totalResultCount，以及 data.filters 和非空 homes 数组。房源含 title、nameLocalized、照片、demandStayListing 标识与坐标、structuredDisplayPrice；结构不同于 stays-search，当前样本没有 homes[].listing.id。无法识别的目的地返回 HTTP 200，但 status:false、message 为 Query is not available、计数为零且 data:null。应视为查询失败，而非该市场房源为零。

必须提供四个数值型地图边界参数：neLat、neLng、swLat、swLng。可选入住退房日、同行人数、currency、locale、page 和房源筛选条件。文档示例含 currentPage，以及 data 内的 filters 和 homes，其中筛选项包括对应目的地的设施与无障碍属性。此地图接口未纳入本次实测，请通过自己的请求确认当前房源标识和价格字段，不要套用 stays-search 结构。地图返回的位置不应视为已核实的精确街道地址，结果也不保证覆盖街区全部库存。

在 query 中输入部分目的地文字，可选 languageCode 和 1 至 5 的 limit。巴黎实测返回 status:true、message:Successful 和 data 建议数组；每条建议含 display_name、explore_search_params.place_id，以及 location 内的 countryCode 和 bounding_box。选中的巴黎 place_id 已成功原样用于住宿和体验搜索。请完整保留该值，不要与独立的 location.google_place_id 混用。目的地建议仅供只读发现，不会预订住宿或活动。

必须提供 query、currency 和 locale，为按文字搜索房源的流程获取地点建议。币种标识来自 get-currency，语言区域标识来自 get-languages。文档响应含 status、message，以及 data 内的 country_code、display_name 建议，例如住宿或体验地点名称。与 common-auto-complete 不同，此示例未提供 stays-search 和 experiences-search 所需的可复用 placeId。此文字联想接口未纳入本次实测。

传入 stays-search 返回的 listingId，可选入住退房日、人数、currencyCode 和 languageCode 补充行程条件。实测返回 status:true、message:Successful，以及类型为 StayPDPSections 的 data，含 sectionContainer、metadata 和其他分区集合。sectionContainer 各项带分区标识，内容涉及标题、介绍、设施、位置与评论。元数据与选中的巴黎房源、可住人数及原始房间链接相符。应按分区标识解析，不假设为扁平房源对象或固定顺序；无日期的详情不是指定日期报价。

必须提供 listingId、checkinDate、checkoutDate，日期用未来的 YYYY-MM-DD，退房晚于入住；同行人数与 currencyCode 应与待比较搜索一致。实测返回 status:true、message:Successful，以及类型为 StayPDPSections 的 data，三个 sectionContainer 分区包含预订价格和取消政策。structuredDisplayPrice 含取整后的住宿醒目价格，explanationData 的价格项则有更精确的 priceString。不要将取整每晚价直接相乘，也不要把醒目价格当作保证的最终付款总额。displayTotalPrice 的文档含义是含费用、税前总价；此 GET 只查价，不预订。

使用 listingId 和必填 checkinDate、checkoutDate 请求结算式报价，可选人数、currencyCode、languageCode、displayTotalPrice。文档示例 data 类型为 StayCheckoutSections，priceCheckout 下含 priceItems 与 total。各项可含 type、localizedTitle，以及 total 中的 amountFormatted、amountMicros、currency；示例涉及住宿费、折扣、清洁费和服务费。是否含税必须核对实际报价，不应预设。此接口未纳入本次实测；只读取报价，不提交、确认或支付预订。

提供 stays-search 返回的 listingId，可选 year、month 指定起始月份，count 请求 1 至 12 个月；文档默认当前年月、12 个月。文档响应 data.calendar_months 中含 condition_ranges、start_date、end_date，以及 min_nights、max_nights、closed_to_arrival、closed_to_departure 等条件。应检查返回日历来筛选候选入住窗口。此接口未纳入本次实测。不可订日期可能来自房东锁日或规则限制，不证明已确认订单、实际入住率或获得的收入。

必须提供十进制房源 id，可选 currency 和 locale。较早房源搜索示例从 homes[].listing.id 取值，当前实测则使用 demandStayListing 标识；不要假定旧路径仍存在，也不要把编码标识当作十进制 ID。文档详情 data 类型为 StayPDPSections，含 metadata、bookingPrefetchData 及 seoFeatures 中的 canonicalUrl 和房源说明。未指定日期时，价格相关元数据可能为 null。此详情接口未单独实测，不应与已验证的 stays-detail 混淆。

必填 id、checkin、checkout，日期使用未来的 YYYY-MM-DD，且退房晚于入住。可选 adults、children、infants、pets、currency 和 locale 定义比较条件。文档响应 data 类型为 StayPDPSections，metadata.bookingPrefetchData 含 cancellationPolicies 和 canInstantBook；示例中部分价格字段为 null，因此应检查实际价格分区，而不是要求单个扁平数值。此接口未纳入本次实测。它只读取观察到的房源报价，不预订，也不保证最终付款金额。

传入住宿搜索取得的 listingId，可选 query、page、limit、sortBy、currencyCode 和 languageCode。limit 最多 40 条评论，page 默认 1；sortBy 支持 MOST_RECENT、RATING_DESC、RATING_ASC。实测返回 status:true、message:Successful、分页 meta，以及 data.pdpReviews 和 metadata。评论含 id、comments、rating、createdAt、language 和本地化日期，元数据含 reviewsCount、reviewSortSelect。实测使用 MOST_RECENT 且无关键词，因此关键词匹配与其他排序仍属文档选项，未逐项验证。

提供十进制房源 id，可选 currency、locale。文档 data 含 overallRating、overallCount、标题及 ratings 数组。分类项含 label、localizedRating、percentage、accessibilityLabel，示例涉及清洁度、准确性、沟通、位置、入住和值得程度。应将评论数量与平均分一同解读，不把评分当作认证或表现保证。此汇总评分接口未纳入本次实测，也不返回评论接口中的逐条住客反馈。

提供十进制房源 id，可选 page、currency、locale，文档默认 page=1。文档响应含 currentPage 和直接位于 data 的评论数组，记录含 id、comments、createdAt、rating、language、localizedDate。还可能有评论者或房东字段，请只保留应用确实需要的内容。此接口未声明关键词 query、sortBy 或 limit，不要从 stays-reviews 照搬这些控制项。此接口未纳入本次实测。

原样使用 common-auto-complete 返回的 placeId。可选 fromDate、toDate 使用未来 YYYY-MM-DD，另有人数、currencyCode、languageCode、activityType、languageOffered、priceRange、timeOfDay 和地图边界筛选。巴黎实测返回 status:true、message、分页 meta，以及 data.filters、paginationInfo、searchResults。活动记录含 id、标题、坐标、体验达人信息、照片与评分，结构不同于住宿卡片。将 nextPageCursor 作为 pageCursor 翻页。筛选标识应来自体验搜索自身响应，不要借用文字房源筛选目录。

提供从 experiences-search 选出的体验 listingId，可选 fromDate、toDate、参加人数、currencyCode、languageCode。文档响应 data 类型为 ExperiencePDPSections，metadata 含 sharingConfig 和活动背景，其他分区承载介绍内容。示例含标题、位置、图片和原始体验链接；时长与包含项目以实际返回分区为准。此详情接口未纳入本次实测。不要将体验 ID 当作住宿 ID，也不要将档案内容视为指定日期可订证明。

传入选中体验的 listingId，可选 page、limit、query、currencyCode、languageCode。文档默认第 1 页、每页 20 条；示例评论直接位于 data 数组，含 id、comments、createdAt、language、localizedDate 和 rating。关键词命中时 comments 可能含高亮标记。此接口未声明 sortBy，也未纳入本次实测；应针对具体活动和关键词确认匹配行为。

提供体验 listingId，可选未来 fromDate／toDate、adults、children、infants、currencyCode、languageCode。文档 data.availableDates 含 calendarItems，其记录有 startDateLocal 和可为 null 的 remainingGuestCount，并有 areChildrenAllowed、areInfantsAllowed。文档也提及 availableDates.items，因此应检查当前 availableDates 分区，而不是假定某一集合始终存在。此接口未纳入本次实测。返回日期和空容量值不保证可用名额，此 GET 也不预订活动。

提供目的地 query，可选 language_code，读取文字房源搜索使用的设施目录。文档响应含 status、message 及 data 中的 id／title，示例包括 WiFi、独立工作区、厨房、泳池、电动车充电设施和婴儿床。将返回 ID 用逗号拼接后传入房源搜索的 amenities。此目录未纳入本次实测；请按目的地刷新，不要把旧 ID 或名称当永久值。目录选项只是搜索条件，不确认某一房源确实提供该设施。

传入目的地 query，可选 language_code，获取文字房源系列的住宿私密类型选项。文档响应含 status、message 和 data 中的 id、title，如 Entire home/apt、Private room、Shared room。将返回 ID 用于 properties-search.type_of_place，其文档格式允许逗号分隔多个选项。此目录不是建筑物业类型列表，也不描述卧室数或可住人数；未纳入本次实测。

提供目的地 query，可选 language_code。文档响应含 status、message 和 data 中的 id／title，如 House、Apartment、Guesthouse、Hotel。将返回 ID 用于文字房源搜索的 property_type，多个建筑类型以逗号分隔。这些分类描述物业建筑形态，不代表房间私密性、卧室数或已核实的酒店资质。此元数据接口未纳入本次实测。

传入目的地 query，可选 language_code。文档响应含 status、message 及 data 中逐项 id／title，例如无台阶客用入口、无障碍停车位、浴室无台阶通道、扶手和淋浴设施。将选中 ID 用逗号分隔传入 properties-search.accessibilities。此目录未实测，不认证房源整体无障碍，也不保证适合每位旅客；仍需单独检查所选房源详情和个人实际需求。

提供目的地 query，可选 language_code，读取房东语言选项。文档响应含 status、message 和 id／title，包括英语、法语、日语、简体中文等。将返回 ID 用逗号分隔传入文字房源系列 host_language。这些 ID 表示房东沟通语言偏好，language_code 用于目录标签本地化，locale 用于房源响应本地化；三者不可互换，也不保证房东的实际熟练程度。此目录未纳入本次实测。

提供目的地 query，可选 language_code，读取主题类别目录。文档响应含 status、message，以及 data 各项的 id、title、image。示例主题包括海滨、小屋、袖珍小屋、绝美景观和湖畔。将实际返回的类别 id 用于 properties-search.category，不要自造标签，也不要假定某主题始终可用。此元数据接口未纳入本次实测。主题类别用于发现，不是建筑物业分类或房源质量保证。

提供目的地 query，可选 language_code，读取文档所述的优选住宿目录。示例响应含 status、message，以及带 id、title、subtitle 的档次选项。历史名称不保证当前仍提供；在 properties-search.top_tier_stays 使用 ID 前先查看实际返回。此接口未纳入本次实测。优选分组只是搜索类别，不是独立质量保证、服务权益或特殊预订权限。

可选 languageCode，为住宿与体验系列读取本地化币种目录。文档 data 数组含 code、id、name、localized_full_name、symbol、unicode_symbol，示例还含住客与房源适用性标志。将返回 code 用于 currencyCode。此目录未纳入本次实测，只提供币种元数据，不提供汇率、换算保证，也不保证每种币种对每位住客都适用。

此只读接口不需要额外参数，返回文档所述的住宿与体验语言元数据。示例 data 数组含 languageCode、language、country、countryCode、locale。同一语言可能有不同国家或区域变体；languageCode 入参应使用返回的 languageCode，不假定它等于 locale。此元数据接口未纳入本次实测。它控制响应本地化，不筛选房东沟通语言或体验开展语言。

可选 language_code，读取房源系列文档所述的币种目录。data 数组含 id、code、name、localized_full_name、symbol、unicode_symbol。将返回标识用于房源 currency 入参，包括 properties-auto-complete 必填的 currency。名称和符号只是元数据，不提供汇率，也不能仅凭共用符号确定币种。此房源系列目录未纳入本次实测。

此接口不需要额外参数，提供房源系列文档所述的语言区域元数据。示例响应含 status、message，以及 data 各项的 id、language、country、domain。将返回 id 用于房源 locale 和目录 language_code。domain 是对应 Airbnb 原站的区域域名，不是 API 基址。此语言目录未纳入本次实测，也不描述房东语言筛选 ID 或 common-languages 的 languageCode 映射。