点评口碑 · 数据 API

TripAdvisor

TripAdvisor API

发现酒店、餐厅和景点,读取地点资料、评分及游客点评,保留出行类型与日期,便于整理目的地信息和对照游客体验。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

5

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

TripAdvisor 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcontent_type, currency, lang默认 10 · 最多 30同步$1.39 / 千次id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines
profileurlcontent_type, currency, lang—同步$1.39 / 千次id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines
reviewsurl—默认 20 · 最多 50同步$1.39 / 千次id · url · title · text · rating · rating_scale · like_count · author_name · author_username · author_location · author_contributions · trip_type · trip_date · posted_at · language · platform · owner_response · image_urls
restaurantskeywordcontent_type, currency, lang默认 10 · 最多 30同步$1.39 / 千次id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines
attractionskeywordcontent_type, currency, lang默认 10 · 最多 30同步$1.39 / 千次id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines

TripAdvisor 每个接口分别做什么

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

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

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

profile

使用 platform="tripadvisor"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 id、name、category、url、text、rating 等 22 个字段。

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

url必填
profile / reviews 的 TripAdvisor 具体地点链接,需指向酒店、餐厅或景点而非城市目录;profile 是地点详情,不是游客个人档案。

Tripadvisor 将 Popularity Ranking 与评价质量、时间、数量及持续表现联系起来;排名会受同区域其他商户表现影响,不是评分均值的另一种写法。官方来源:Tripadvisor:Popularity Ranking 与评分来源核查:

content_type可选
search / profile / restaurants / attractions 的地点照片来源:from_everyone 全部、from_management 商家上传、from_travelers 游客上传;不是酒店/餐厅/景点对象类型,请选对应 action。
查看全部 3 个允许值

from_everyonefrom_managementfrom_travelers

currency可选
地点展示价格的币种,默认 usd;常用 eur 欧元、gbp 英镑、cny 人民币。完整允许值保留契约清单,但并不意味着每种历史代码都有实时价格;不是 API 结算币种。
查看全部 119 个允许值

aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl

lang可选
search / profile / restaurants / attractions 的地点展示语言,使用两字母语言码,例如 en 英语、zh 中文;当前 reviews 不公开这组参数。
查看全部 183 个允许值

aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh

TripAdvisor 特有返回字段与含义(5)
ranking
在同城同类中的排名(如「本市餐厅第 3 名」)。
price_level
价格档位,用 $ 数量表示($ 到 $$$$),不是具体金额。
email
商家公开邮箱。
latitude
纬度。
longitude
经度。

怎么调用 TripAdvisor 评价 API?

reviews

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

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

url必填
profile / reviews 的 TripAdvisor 具体地点链接,需指向酒店、餐厅或景点而非城市目录;profile 是地点详情,不是游客个人档案。

官方 Reviews 端点按数字 locationId 读取地点的最新评论,并支持 language、limit 和 offset;常规额度通常只返回少量记录,且没有 since。EveryInfra 当前要求完整地点 URL,与该官方输入契约不同。官方来源:Tripadvisor:官方评论端点按 locationId 定位来源核查:

TripAdvisor 特有返回字段与含义(4)
trip_date
点评人的出行时间。判断评价新鲜度用。
trip_type
出行类型(商务/情侣/家庭/独行)。
author_location
点评人所在地。
author_contributions
点评人累计贡献的点评数。数值高的点评更可信。

怎么调用 TripAdvisor 餐厅 API?

restaurants

使用 platform="tripadvisor"、action="restaurants" 调用“餐厅”能力;返回列表,默认 10 条、单次最多 30 条,主要包含 id、name、category、url、text、rating 等 22 个字段。

TripAdvisor restaurants 的参数分别是什么意思?

keyword必填
search 混合检索酒店、餐厅与景点;restaurants 只查餐厅,attractions 只查景点。填写地点名并附城市有助区分同名地点,不是评论全文搜索。

官方 Location Search 将 restaurants 列为地点类别,可按 searchQuery 发现餐厅;EveryInfra 的 restaurants 是独立 action,而其 content_type 仍只表示照片来源,不能把两者混写。官方来源:Tripadvisor:restaurants 是正式 Location category来源核查:

content_type可选
search / profile / restaurants / attractions 的地点照片来源:from_everyone 全部、from_management 商家上传、from_travelers 游客上传;不是酒店/餐厅/景点对象类型,请选对应 action。
查看全部 3 个允许值

from_everyonefrom_managementfrom_travelers

currency可选
地点展示价格的币种,默认 usd;常用 eur 欧元、gbp 英镑、cny 人民币。完整允许值保留契约清单,但并不意味着每种历史代码都有实时价格;不是 API 结算币种。
查看全部 119 个允许值

aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl

lang可选
search / profile / restaurants / attractions 的地点展示语言,使用两字母语言码,例如 en 英语、zh 中文;当前 reviews 不公开这组参数。
查看全部 183 个允许值

aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh

TripAdvisor 特有返回字段与含义(5)
ranking
在同城同类中的排名(如「本市餐厅第 3 名」)。
price_level
价格档位,用 $ 数量表示($ 到 $$$$),不是具体金额。
email
商家公开邮箱。
latitude
纬度。
longitude
经度。

怎么调用 TripAdvisor 景点 API?

attractions

使用 platform="tripadvisor"、action="attractions" 调用“景点”能力;返回列表,默认 10 条、单次最多 30 条,主要包含 id、name、category、url、text、rating 等 22 个字段。

TripAdvisor attractions 的参数分别是什么意思?

keyword必填
search 混合检索酒店、餐厅与景点;restaurants 只查餐厅,attractions 只查景点。填写地点名并附城市有助区分同名地点,不是评论全文搜索。

官方 Location Search 将 attractions 列为地点类别;该资料不证明 EveryInfra 的分页、结果数、照片来源值域或当前输入实现。官方来源:Tripadvisor:attractions 是正式 Location category来源核查:

content_type可选
search / profile / restaurants / attractions 的地点照片来源:from_everyone 全部、from_management 商家上传、from_travelers 游客上传;不是酒店/餐厅/景点对象类型,请选对应 action。
查看全部 3 个允许值

from_everyonefrom_managementfrom_travelers

currency可选
地点展示价格的币种,默认 usd;常用 eur 欧元、gbp 英镑、cny 人民币。完整允许值保留契约清单,但并不意味着每种历史代码都有实时价格;不是 API 结算币种。
查看全部 119 个允许值

aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl

lang可选
search / profile / restaurants / attractions 的地点展示语言,使用两字母语言码,例如 en 英语、zh 中文;当前 reviews 不公开这组参数。
查看全部 183 个允许值

aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh

TripAdvisor 特有返回字段与含义(5)
ranking
在同城同类中的排名(如「本市餐厅第 3 名」)。
price_level
价格档位,用 $ 数量表示($ 到 $$$$),不是具体金额。
email
商家公开邮箱。
latitude
纬度。
longitude
经度。
TripAdvisor search 调用流程一次 TripAdvisor search 调用的全过程:向 POST /api/v1/social 发送 platform="tripadvisor"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、category、url、text 等字段;返回列表,单次最多 30 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "tripadvisor"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idnamecategoryurltext
一次 TripAdvisor search 调用的全过程:向 POST /api/v1/social 发送 platform="tripadvisor"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、category、url、text 等字段;返回列表,单次最多 30 条,计费 $1.39 / 千次,失败与空结果不计费。

TripAdvisor 原始字段名

EveryInfra 统一字段名

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

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

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

  • price_level
  • ranking
  • cuisines
  • author_contributions
  • trip_date

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签。长文可能被截断。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
price_level
价格档位,用 $ 数量表示($ 到 $$$$),不是具体金额。
ranking
在同城同类中的排名(如「本市餐厅第 3 名」)。
address
详细地址,原文透传。
city
城市名,用原平台的语言书写,未做中英归一。
country
国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
location
地理位置描述,原文透传,格式随平台而异。
phone
联系电话,原文透传,未做号码格式归一。
email
商家公开邮箱。
website
账号或商家填写的外链网址。
latitude
纬度。
longitude
经度。
image_url
图片链接。多图能力可能返回 image_urls 数组。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
title
标题。平台无标题概念时(如纯文本帖)为 null。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
author_name
作者昵称(显示名)。
author_username
作者用户名(@handle),通常可用于拼 URL。
author_location
点评人所在地。
author_contributions
点评人累计贡献的点评数。数值高的点评更可信。
trip_type
出行类型(商务/情侣/家庭/独行)。
trip_date
点评人的出行时间。判断评价新鲜度用。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
language
内容语言代码(如 zh、en),由平台判定,可能不准。

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

请求填写示例

这里检索旅行目的地或地点;评价接口需要具体地点目标。

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

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

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

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

fields.preview.json
{
  "id": null,
  "name": null,
  "category": null,
  "url": null,
  "text": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "price_level": null,
  "ranking": null,
  "address": null,
  "city": null,
  "country": null,
  "location": null,
  "phone": null,
  "email": null,
  "website": null,
  "latitude": null,
  "longitude": null,
  "image_url": null,
  "platform": null,
  "cuisines": null
}

常见用例

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

在 Tripadvisor 发现酒店、餐厅与景点

用 search 做地点发现,再按类别拆分后续研究对象。

查看 search 的 content_type 参数 →
  • keyword 使用地点名并附城市,结合 id、name、category、address 与 url 排除同名对象;search 可能同时返回酒店、餐厅和景点。
  • content_type 选择照片来源,不是地点类型;只要餐厅或景点时应改用 restaurants 或 attractions,不把这项当成酒店筛选。

区分 Tripadvisor 地点评分与排名

用 profile 核对具体地点的评分、评论规模和排名文本。

查看 profile 的 url 参数 →
  • url 指向酒店、餐厅或景点详情;rating 是评分,ranking 是排名位置或展示文本,结合 category、city、review_count 与 price_level 阅读。
  • 排名不是分数,不能把不同地区、不同类别的名次直接混排;price_level 是价格档位,不是实时住宿总价,profile 也不是游客档案。

按出行背景整理 Tripadvisor 点评

读取某个地点的点评正文,区分出行时间与发表时间。

查看 reviews 的 url 参数 →
  • reviews 使用具体地点 url,结合 title、text、trip_type、trip_date、posted_at 和 language 阅读体验背景。
  • trip_date 不等于 posted_at,缺失出行背景不自行补全;当前 reviews 未公开 since 或 lang,不从其他 action 复制筛选条件,也不承诺全部历史点评。

用 Tripadvisor 餐厅目录整理本地餐饮候选

用 restaurants 限定餐厅对象,减少混合地点搜索带来的误匹配。

查看 restaurants 的 keyword 参数 →
  • keyword 填餐厅或餐饮地点词并附城市;结合 name、address、city、price_level 与 rating 人工核对候选。
  • price_level 不是菜单明细或人均消费的统一金额;餐厅搜索不提供订位、实时余桌或营业状态保证。

用 Tripadvisor 景点目录补充目的地资料

用 attractions 读取目的地相关景点,供自己的行程资料库使用。

查看 attractions 的 keyword 参数 →
  • keyword 填景点或目的地,结合 name、category、location、text 与 url 保存地点资料;它与 restaurants 的对象类别不同。
  • 景点条目不等于可购门票或具体场次,接口不负责行程规划、路线计算或票务预订;内容是否完整以返回结果为准。

TripAdvisor API 常见问题

TripAdvisor API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="tripadvisor"、action 和 params。以 search 为例,必填 keyword,可选 content_type、currency、lang。这里检索旅行目的地或地点;评价接口需要具体地点目标。 TripAdvisor 共 5 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

TripAdvisor API 怎么收费?

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

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

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

TripAdvisor API 返回哪些字段?

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

「在 Tripadvisor 发现酒店、餐厅与景点」怎样接入 TripAdvisor API?

用 search 做地点发现,再按类别拆分后续研究对象。 keyword 使用地点名并附城市,结合 id、name、category、address 与 url 排除同名对象;search 可能同时返回酒店、餐厅和景点。 content_type 选择照片来源,不是地点类型;只要餐厅或景点时应改用 restaurants 或 attractions,不把这项当成酒店筛选。

「区分 Tripadvisor 地点评分与排名」怎样接入 TripAdvisor API?

用 profile 核对具体地点的评分、评论规模和排名文本。 url 指向酒店、餐厅或景点详情;rating 是评分,ranking 是排名位置或展示文本,结合 category、city、review_count 与 price_level 阅读。 排名不是分数,不能把不同地区、不同类别的名次直接混排;price_level 是价格档位,不是实时住宿总价,profile 也不是游客档案。

「按出行背景整理 Tripadvisor 点评」怎样接入 TripAdvisor API?

读取某个地点的点评正文,区分出行时间与发表时间。 reviews 使用具体地点 url,结合 title、text、trip_type、trip_date、posted_at 和 language 阅读体验背景。 trip_date 不等于 posted_at,缺失出行背景不自行补全;当前 reviews 未公开 since 或 lang,不从其他 action 复制筛选条件,也不承诺全部历史点评。

「用 Tripadvisor 餐厅目录整理本地餐饮候选」怎样接入 TripAdvisor API?

用 restaurants 限定餐厅对象,减少混合地点搜索带来的误匹配。 keyword 填餐厅或餐饮地点词并附城市;结合 name、address、city、price_level 与 rating 人工核对候选。 price_level 不是菜单明细或人均消费的统一金额;餐厅搜索不提供订位、实时余桌或营业状态保证。

可以先免费试用 TripAdvisor API 吗?

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

开始调用 TripAdvisor API

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

免费开始