Tripadvisor API

Tripadvisor 搜索 API

在任意目的地搜索 Tripadvisor 上的酒店、餐厅和景点，获取丰富的地点记录（评分、评价数、联系方式、价格），以标准化 JSON 返回。

POST/v1/run/tripadvisor.search
可用率
100.00%
30d · 7 次调用
请求数
7
30d · 按周，近 12 周
响应时间
14.2s
中位数 · 30d

服务商网络

按流量排序的服务商

试一试

发出你的第一个请求

requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `phone` 或 `website`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "address": "123 Main St",
        "category": "general",
        "city": "San Francisco",
        "country": "US",
        "email": "alex@example.com",
        "hotelClass": "+1 555-0142",
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "phone": "+1 555-0142",
        "postalCode": "94107",
        "priceLevel": "19.99",
        "priceRange": "19.99",
        "ranking": "example",
        "rating": 4.6,
        "reviewCount": 12500,
        "title": "Example title",
        "type": "general",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface TripadvisorSearchResponse {
  data: {
    items: {
      address?: string;
      category?: string;
      city?: string;
      country?: string;
      email?: string;
      hotelClass?: string;
      id?: string;
      image?: string;
      latitude?: number;
      longitude?: number;
      phone?: string;
      postalCode?: string;
      priceLevel?: string;
      priceRange?: string;
      ranking?: string;
      rating: number | null;
      reviewCount?: number | null;
      title: string;
      type?: string;
      url: string;
      website?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/tripadvisor.search
curl -X POST https://api.getanyapi.com/v1/run/tripadvisor.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"Paris"}'
字段类型示例值
请求体
querystring"Paris"要搜索的目的地或关键词（例如 Barcelona）。
currencystring价格使用的 ISO 货币代码（例如 USD、EUR）。
includeAttractionsboolean在结果中包含景点和活动；设为 false 可排除（例如 false）。默认 true。
includeHotelsboolean在结果中包含酒店；设为 false 可排除（例如 false）。默认 true。
includeRestaurantsboolean在结果中包含餐厅；设为 false 可排除（例如 false）。默认 true。
limitinteger3最多返回的结果数（1-20，默认 20）。
requireFieldsarray可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `phone` 或 `website`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
响应
dataobjectThe result wrapper, or null when nothing matched.
data.itemsobject[]Matching Tripadvisor place records (hotels, restaurants, attractions). Populated whenever the provider has data for the entity.
data.items[].address可设为必填stringFull formatted street address.
data.items[].categorystringHigh-level category (e.g. hotel, restaurant, attraction).
data.items[].city可设为必填stringCity the place is in.
data.items[].country可设为必填stringCountry the place is in.
data.items[].email可设为必填stringBusiness contact email, when listed.
data.items[].hotelClass可设为必填stringStar rating / hotel class, when applicable.
data.items[].idstringTripadvisor location id (stable identifier for the place).
data.items[].imagestringPrimary place photo URL.
data.items[].latitude可设为必填numberLatitude of the place in decimal degrees.
data.items[].longitude可设为必填numberLongitude of the place in decimal degrees.
data.items[].phone可设为必填stringBusiness phone number, when listed.
data.items[].postalCode可设为必填stringPostal code of the place.
data.items[].priceLevel可设为必填stringRelative price level indicator (e.g. $$, $$$$).
data.items[].priceRange可设为必填stringNightly or per-visit price range in the requested currency.
data.items[].ranking可设为必填stringRanking string within its location (e.g. "#2 of 1,885 hotels in Paris").
data.items[].ratingnumberAverage traveler rating out of 5; null for a place Tripadvisor has not rated (such as a city). Populated whenever the provider has data for the entity.
data.items[].reviewCountnumberTotal number of traveler reviews; null when the source does not report it.
data.items[].titlestringPlace name. Populated whenever the provider has data for the entity.
data.items[].typestringTripadvisor place type (e.g. HOTEL, RESTAURANT, ATTRACTION).
data.items[].urlstringCanonical Tripadvisor listing page URL. Populated whenever the provider has data for the entity.
data.items[].website可设为必填stringThe place's own website URL, when listed.
foundbooleanTrue when the search returned at least one matching place.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.003
价格（/千次请求）USDUS$3.00

常见问题

关于 Tripadvisor 搜索 API

AnyAPI 的 Tripadvisor 搜索 API 只需一次 POST 请求 /v1/run/tripadvisor.search，就以统一格式的 JSON 返回 Tripadvisor 数据。在任意目的地搜索 Tripadvisor 上的酒店、餐厅和景点，获取丰富的地点记录（评分、评价数、联系方式、价格），以标准化 JSON 返回。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$3 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Tripadvisor 搜索 API 调用中有 100.0% 成功，响应时间中位数为 14.2 秒，共测量 7 次调用。

费用：每千次请求 US$3 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

在任意目的地搜索 Tripadvisor 上的酒店、餐厅和景点，获取丰富的地点记录（评分、评价数、联系方式、价格），以标准化 JSON 返回。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Tripadvisor 搜索 API 调用中有 100.0% 成功，响应时间中位数为 14.2 秒，共测量 7 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。
更多接口

Tripadvisor 的其他接口

评价/千次请求 US$3.00 起