点评口碑 · 数据 API

Expedia

Expedia API

从目的地酒店列表与住客点评了解住宿选择,也可按取还车日期查询租车展示报价;酒店价格不代表指定行程的最终费用。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Expedia 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcurrency, sort默认 24 · 最多 200同步$1.39 / 千次hotel_id · name · url · neighborhood · region · rating · rating_scale · rating_label · review_count · star_rating · price_per_night · price_total · discount_percent · vip_access · latitude · longitude · image_url · provider · platform
profileurl——同步$1.39 / 千次hotel_id · hotel_name · hotel_url · rating · rating_scale · rating_label · review_count · star_rating · property_type · address · latitude · longitude · provider · category_ratings · languages · review_summary · platform
reviewsurlreviews_from, since, sort默认 20 · 最多 200同步$1.39 / 千次id · text · title · rating · rating_scale · rating_label · posted_at · stay_date · author_name · trip_type · stay_duration · traveled_with · verified · language · hotel_id · hotel_name · hotel_url · hotel_rating · platform · image_urls · owner_response
car_rentalkeywordcheck_in, check_out, drop_off_date, pick_up_date默认 20 · 最多 100同步$1.39 / 千次id · url · title · vehicle_category · vendor_name · price · price_total · rating · rating_scale · rating_label · attributes · pick_up_location · drop_off_location · pick_up_date · drop_off_date · pick_up_time · drop_off_time · image_url · platform

Expedia 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Expedia 主页或对象详情 API?

profile

使用 platform="expedia"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 hotel_id、hotel_name、hotel_url、rating、rating_scale、rating_label 等 17 个字段。

Expedia 说明星级为酒店等级分类,部分地区另有国家评级,分类也不保证每家酒店具有全部列举设施。star_rating 不是住客点评平均分,更不能一概写成官方硬件认证。官方来源:Expedia:酒店星级与国家等级的区别来源核查:

Expedia profile 的参数分别是什么意思?

url必填
Expedia 或兼容 Hotels.com 的单个酒店页面链接,用于 profile 资料或 reviews 点评;不是搜索列表页。租车查询 URL 应放在 car_rental 的 keyword。
Expedia 特有返回字段与含义(8)
hotel_id
酒店 ID。
star_rating
酒店星级,官方硬件评定,与 hotel_rating 不是一回事。
rating_label
评分的文字档位。
latitude
纬度。
longitude
经度。
provider
供应商(比价结果里的渠道方)。
hotel_name
酒店名称。
hotel_url
酒店页链接。

怎么调用 Expedia 评价 API?

reviews

使用 platform="expedia"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、text、title、rating、rating_scale、rating_label 等 21 个字段。

官方指南区分单次评分、展示的酒店综合分和租车评价口径,并允许部分曾尝试入住但未完成住宿的旅客评价。这里只支持评分与资格术语,不证明本接口所有返回值已统一刻度或已验证完整住宿。官方来源:Expedia:点评评分、发布资格与已有回复来源核查:

Expedia reviews 的参数分别是什么意思?

url必填
Expedia 或兼容 Hotels.com 的单个酒店页面链接,用于 profile 资料或 reviews 点评;不是搜索列表页。租车查询 URL 应放在 car_rental 的 keyword。
reviews_from可选
reviews 的点评起始日期兼容输入,建议 YYYY-MM-DD;since 同时提供时优先 since。不是酒店入住日期。
since可选
reviews 的点评时间下界,建议 YYYY-MM-DD,优先于 reviews_from;不用于限定酒店开业时间或租车日期。
sort可选
排序方式因 action 而异:search 支持 distance、price_asc、price_desc、top_rated;reviews 支持 newest、relevance、top_rated、most_helpful。
查看全部 4 个允许值

most_helpfulnewestrelevancetop_rated

Expedia 特有返回字段与含义(10)
hotel_id
酒店 ID。
rating_label
评分的文字档位。
hotel_name
酒店名称。
hotel_url
酒店页链接。
hotel_rating
住客点评均分。
stay_date
点评人入住的时间。
stay_duration
住宿晚数。
trip_type
出行类型(商务/休闲/家庭)。
traveled_with
同行人类型(伴侣/家人/朋友/独行)。
verified
是否为已验证入住的点评。未验证的可信度低。

怎么调用 Expedia 租车报价 API?

car_rental

使用 platform="expedia"、action="car_rental" 调用“租车报价”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、url、title、vehicle_category、vendor_name、price 等 19 个字段。

Expedia car_rental 的参数分别是什么意思?

keyword必填
search 使用酒店目的地;car_rental 使用取车地点或完整 Expedia carsearch URL。租车传完整 URL 时直接使用其中条件,不再应用独立日期参数;不是航班搜索词。
check_in可选
car_rental 的取车日期兼容名,只有 pick_up_date 未提供时读取;此处不是酒店入住筛选。
check_out可选
car_rental 的还车日期兼容名,只有 drop_off_date 未提供时读取;此处不是酒店退房筛选。
drop_off_date可选
car_rental 还车日期,YYYY-MM-DD。提供取车日期而未提供还车日期时,当前回落同一天;请显式给出晚于取车的日期。未提供取车日期时,默认日期对会覆盖单独填写的还车日期。
pick_up_date可选
car_rental 取车日期,YYYY-MM-DD,优先于 check_in。取车日期缺省时使用当天后 30 天取车、再过 2 天还车;构造查询的取还车时间固定为 10:30 AM,不能据此假定任意时段报价。

Expedia Rapid Car 官方接口使用结构化取还车区域或机场,以及包含时间的 pickup_time 和 dropoff_time。EveryInfra pick_up_date 只接收 YYYY-MM-DD,并由自身逻辑补固定时间;它不是 pickup_time 的原样别名。keyword 的自由文本或 carsearch URL 解析、默认日期和结果上限也不由 Rapid 文档证明。官方来源:Expedia Rapid Car:取还车地点与完整时间来源核查:

Expedia 特有返回字段与含义(11)
rating_label
评分的文字档位。
price_total
总价(含全部住宿晚数)。
attributes
酒店设施与属性标签。
vendor_name
租车/服务供应商名称。
vehicle_category
车辆类别(租车能力用)。
pick_up_date
取车日期。
pick_up_time
取车时间。
pick_up_location
取车地点。
drop_off_date
还车日期。
drop_off_time
还车时间。
drop_off_location
还车地点。
Expedia search 调用流程一次 Expedia search 调用的全过程:向 POST /api/v1/social 发送 platform="expedia"、action="search",以及必填参数 keyword;返回结构化 JSON,含 hotel_id、name、url、neighborhood、region 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "expedia"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表hotel_idnameurlneighborhoodregion
一次 Expedia search 调用的全过程:向 POST /api/v1/social 发送 platform="expedia"、action="search",以及必填参数 keyword;返回结构化 JSON,含 hotel_id、name、url、neighborhood、region 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

Expedia 原始字段名

EveryInfra 统一字段名

左边是 Expedia 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Expedia 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 19 个字段名只在 Expedia 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • hotel_id
  • star_rating
  • price_per_night
  • price_total
  • vip_access
  • provider
  • hotel_url
  • review_summary
  • stay_duration
  • traveled_with
  • verified
  • hotel_rating
  • vehicle_category
  • pick_up_location
  • drop_off_location
  • pick_up_date
  • drop_off_date
  • pick_up_time

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

hotel_id
酒店 ID。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
url
该记录在原平台上的可访问链接。
neighborhood
所在街区。
region
所属区域。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
rating_label
评分的文字档位。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
star_rating
酒店星级,官方硬件评定,与 hotel_rating 不是一回事。
price_per_night
每晚价格。
price_total
总价(含全部住宿晚数)。
discount_percent
折扣百分比。
vip_access
是否为 Expedia VIP Access 酒店(会员专属权益)。
latitude
纬度。
longitude
经度。
image_url
图片链接。多图能力可能返回 image_urls 数组。
provider
供应商(比价结果里的渠道方)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
hotel_name
酒店名称。
hotel_url
酒店页链接。
address
详细地址,原文透传。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
text
正文内容,已去除 HTML 标签。长文可能被截断。
title
标题。平台无标题概念时(如纯文本帖)为 null。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
stay_date
点评人入住的时间。
author_name
作者昵称(显示名)。
trip_type
出行类型(商务/休闲/家庭)。
stay_duration
住宿晚数。
traveled_with
同行人类型(伴侣/家人/朋友/独行)。
verified
是否为已验证入住的点评。未验证的可信度低。
language
内容语言代码(如 zh、en),由平台判定,可能不准。
hotel_rating
住客点评均分。
vehicle_category
车辆类别(租车能力用)。
vendor_name
租车/服务供应商名称。
price
价格数值,不含货币符号;币种见 currency。
attributes
酒店设施与属性标签。
pick_up_location
取车地点。
drop_off_location
还车地点。
pick_up_date
取车日期。
drop_off_date
还车日期。
pick_up_time
取车时间。
drop_off_time
还车时间。

当前目录另列出 property_type · category_ratings · languages · review_summary · image_urls · owner_response,这些字段尚无逐项释义;请先核对 Expedia 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

这里检索目的地住宿,不是任意商品或文章。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

expedia_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"expedia","action":"search","params":{"keyword":"Paris"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "hotel_id": null,
  "name": null,
  "url": null,
  "neighborhood": null,
  "region": null,
  "rating": null,
  "rating_scale": null,
  "rating_label": null,
  "review_count": null,
  "star_rating": null,
  "price_per_night": null,
  "price_total": null,
  "discount_percent": null,
  "vip_access": null,
  "latitude": null,
  "longitude": null,
  "image_url": null,
  "provider": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

按目的地比较 Expedia 酒店列表

用 search 获取酒店候选,分开住客评分、酒店星级与展示价格。

查看 search 的 keyword 参数 →
  • keyword 是酒店目的地,currency 是搜索价格的展示币种而非 API 扣费币种;sort 用于酒店搜索,不是租车或点评排序。当前没有酒店入住、退房日期筛选,price_per_night / price_total 不能当成指定行程的最终报价。
  • rating / review_count 描述住客点评,star_rating 是酒店等级,不能当成同一种评分。country / lang 对应未启用的房间明细选项,不保证改变结果或翻译点评;limit 也未保证严格裁切搜索列表。

读取 Expedia 酒店详情中的主题摘要

用 profile 指向单个酒店页面,不把搜索页或租车页当成酒店详情。

查看 profile 的 url 参数 →
  • url 填 Expedia 或兼容 Hotels.com 的酒店详情链接;此接口返回单个详情对象,不是评论列表,也不提供客房实时库存或预订操作。
  • 如有 review_summary,category / text / mentions 是其中每个摘要项的主题、文字与提及计数,不是详情对象的三个独立顶层字段。当前目录存在详情公共字段及容器漏列,摘要也可能缺失;不能把 mentions 当作酒店总点评数或自行补造不存在的摘要。

区分 Expedia 点评时间与入住时间

用 reviews 按酒店读取点评,保留单条意见与酒店整体评分的区别。

查看 reviews 的 since 参数 →
  • url 指向单个酒店;since 优先于 reviews_from,二者限定点评时间下界,不是入住日期。posted_at 是点评发布时刻,stay_date 是入住日期,不能混用。
  • rating 属于单条点评,hotel_rating 属于酒店整体评分;当前评分刻度仍需按实际返回核对,不把它们和 star_rating 或租车评分直接平均。verified 是返回标记,不是 EveryInfra 核实入住,也不能由此推断每位评论者完成了全部住宿。
  • sort 参数仍是酒店搜索排序值,不能保证按它们排列点评;country / lang 也不承诺筛选国家或翻译内容。此处只读取已有点评,不发表、删除点评或回复。

用明确日期查询 Expedia 租车报价

用 car_rental 区分租车地点、取还车日期与报价车辆类别。

查看 car_rental 的 pick_up_date 参数 →
  • keyword 可填取车地点或完整 carsearch URL;使用完整 URL 时直接采用其中条件,不再应用独立日期参数。地点模式请显式填写 pick_up_date / drop_off_date,check_in / check_out 只是租车日期兼容名,不是酒店日期。
  • 缺少取车日期时默认从当天后 30 天开始租 2 天;只给取车日期时,还车日期默认为同一天。构造查询的时间固定为 10:30 AM,不能当作任意时段报价;返回日期和地点仍需复核。
  • vehicle_category / attributes 描述车辆类别与属性,vendor_name 是报价中的租车服务商;price / price_total 保留实际值,不默认含保险、押金或全部税费。报价不锁库存,此接口不能下单、支付或取得提车凭证。

Expedia API 常见问题

Expedia API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="expedia"、action 和 params。以 search 为例,必填 keyword,可选 currency、sort。这里检索目的地住宿,不是任意商品或文章。 Expedia 共 4 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Expedia API 怎么收费?

$1.39 / 千次,Expedia 全部 4 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Expedia 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Expedia API 一次能返回多少条数据?

Expedia 有 3 个列表接口,包括 search、reviews、car_rental。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Expedia API 返回哪些字段?

当前目录为 search 列出 hotel_id、name、url、neighborhood、region、rating 等 19 个字段名。按全站当前目录统计,19 个字段名只在 Expedia 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「按目的地比较 Expedia 酒店列表」怎样接入 Expedia API?

用 search 获取酒店候选,分开住客评分、酒店星级与展示价格。 keyword 是酒店目的地,currency 是搜索价格的展示币种而非 API 扣费币种;sort 用于酒店搜索,不是租车或点评排序。当前没有酒店入住、退房日期筛选,price_per_night / price_total 不能当成指定行程的最终报价。 rating / review_count 描述住客点评,star_rating 是酒店等级,不能当成同一种评分。country / lang 对应未启用的房间明细选项,不保证改变结果或翻译点评;limit 也未保证严格裁切搜索列表。

「读取 Expedia 酒店详情中的主题摘要」怎样接入 Expedia API?

用 profile 指向单个酒店页面,不把搜索页或租车页当成酒店详情。 url 填 Expedia 或兼容 Hotels.com 的酒店详情链接;此接口返回单个详情对象,不是评论列表,也不提供客房实时库存或预订操作。 如有 review_summary,category / text / mentions 是其中每个摘要项的主题、文字与提及计数,不是详情对象的三个独立顶层字段。当前目录存在详情公共字段及容器漏列,摘要也可能缺失;不能把 mentions 当作酒店总点评数或自行补造不存在的摘要。

「区分 Expedia 点评时间与入住时间」怎样接入 Expedia API?

用 reviews 按酒店读取点评,保留单条意见与酒店整体评分的区别。 url 指向单个酒店;since 优先于 reviews_from,二者限定点评时间下界,不是入住日期。posted_at 是点评发布时刻,stay_date 是入住日期,不能混用。 rating 属于单条点评,hotel_rating 属于酒店整体评分;当前评分刻度仍需按实际返回核对,不把它们和 star_rating 或租车评分直接平均。verified 是返回标记,不是 EveryInfra 核实入住,也不能由此推断每位评论者完成了全部住宿。 sort 参数仍是酒店搜索排序值,不能保证按它们排列点评;country / lang 也不承诺筛选国家或翻译内容。此处只读取已有点评,不发表、删除点评或回复。

「用明确日期查询 Expedia 租车报价」怎样接入 Expedia API?

用 car_rental 区分租车地点、取还车日期与报价车辆类别。 keyword 可填取车地点或完整 carsearch URL;使用完整 URL 时直接采用其中条件,不再应用独立日期参数。地点模式请显式填写 pick_up_date / drop_off_date,check_in / check_out 只是租车日期兼容名,不是酒店日期。 缺少取车日期时默认从当天后 30 天开始租 2 天;只给取车日期时,还车日期默认为同一天。构造查询的时间固定为 10:30 AM,不能当作任意时段报价;返回日期和地点仍需复核。 vehicle_category / attributes 描述车辆类别与属性,vendor_name 是报价中的租车服务商;price / price_total 保留实际值,不默认含保险、押金或全部税费。报价不锁库存,此接口不能下单、支付或取得提车凭证。

可以先免费试用 Expedia API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Expedia 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 4 个能力。无需信用卡。

开始调用 Expedia API

加微信领 $1 免费额度,先选一个 Expedia 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始