Apinoa Docs

Place

从 Tripadvisor 获取单个地点的详细信息。

查看原始 .mdx
GET | POST /v1/tripadvisor/place

参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。

请求

curl "https://gateway.apinoa.com/v1/tripadvisor/place?id=143336&country=US" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数类型必填说明
countryenumThe market, as an ISO 3166 country code. US GB CA AU IN IE DE FR IT ES NL BR MX JP KR
idstringThe place's id, as places returns it (a Tripadvisor link is taken too).
langstringInterface language.
urlstringA Tripadvisor place link.

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 Place。 真实响应的节选：数组只保留前几项，长文本已截断。

{
  "success": true,
  "data": {
    "id": "143336",
    "name": "Paris Las Vegas",
    "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d143336-Reviews-Paris_Las_Vegas-Las_Vegas_…",
    "address": {
      "street": "3655 S Las Vegas Blvd",
      "city": "Las Vegas",
      "region": "Nevada",
      "postalCode": "89109",
      "country": "US",
      "full": "3655 S Las Vegas Blvd, Las Vegas, NV 89109"
    },
    "coordinates": {"lat": 36.11246, "lng": -115.17071},
    "rating": 3.9,
    "reviewCount": 40012,
    "photos": ["https://dynamic-media-cdn.tripadvisor.com/media/photo-o/2f/ac/a0/69/paris-las-vegas.jpg?w=…"],
    "description": "Paris Las Vegas Hotel - A Caesars Rewards Destination. Experience everything you love abou…",
    "lang": "en",
    "ext": {
      "type": "hotel",
      "placeType": "ACCOMMODATION",
      "parent": {"id": "45963", "name": "Las Vegas"},
      "neighborhoods": ["The Strip"],
      "email": "totalrewards@custhelp.com",
      "ratings": {
        "starCounts": {"1": 2772, "2": 2833, "3": 5948, "4": 11959, "5": 16500},
        "distribution": {"1": 6.93, "2": 7.08, "3": 14.87, "4": 29.89, "5": 41.24},
        "subRatings": {
          "activitiesAndGym": 3.5,
          "cleanliness": 4.2,
          "dining": 3.9,
          "location": 4.7,
          "pool": 3.7,
          "room": 4,
          "service": 3.9,
          "sleep": 4.2,
          "value": 3.9
        }
      },
      "nearby": {
        "neighborhood": {
          "name": "The Strip",
          "description": "Las Vegas Strip, a neon wonderland that never sleeps, is the epicenter of thrill and enter…"
        },
        "hotels": [
          {
            "id": "1639337",
            "name": "Hilton Grand Vacations Club Elara Center Strip Las Vegas",
            "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d1639337-Reviews-Hilton_Grand_Vacations_Cl…",
            "coordinates": {"lat": 36.10882, "lng": -115.16833},
            "photo": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/15/22/91/ac/pool.jpg?w=4950&h=3300…",
            "rating": 4.3,
            "reviewCount": 8809,
            "award": {"type": "COE", "year": 2026}
          }
        ],
        "attractions": [
          {
            "id": "553008",
            "name": "Paris Las Vegas Wedding Chapel",
            "url": "https://www.tripadvisor.com/Attraction_Review-g45963-d553008-Reviews-Paris_Las_Vegas_Weddi…",
            "coordinates": {"lat": 36.112034, "lng": -115.171036},
            "photo": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/28/fd/2d/eb/arc-de-triomphe.jpg?w=…",
            "rating": 4.6,
            "reviewCount": 55,
            "distance": 0.034517966
          }
        ],
        "landmarks": [{"name": "Fountains of Bellagio"}],
        "restaurantsUrl": "https://www.tripadvisor.com/RestaurantsNear-g45963-d143336-Paris_Las_Vegas-Las_Vegas_Nevad…",
        "hotelsUrl": "https://www.tripadvisor.com/HotelsNear-g45963-d143336-Paris_Las_Vegas-Las_Vegas_Nevada.htm…",
        "attractionsUrl": "https://www.tripadvisor.com/ClientLink?value=b0JIXy9BdHRyYWN0aW9uc19VMGU%3D"
      },
      "ranking": {
        "text": "#164 of 261 hotels in Las Vegas",
        "url": "https://www.tripadvisor.com/Hotels-g45963-a_sort.POPULARITY-Las_Vegas_Nevada-Hotels.html"
      },
      "hotel": {
        "accommodationType": "T_HOTEL",
        "categoryRanking": "#164 of 261 hotels in Las Vegas",
        "starRating": {"tagIds": [9566], "source": "This property is classified according to Giata."},
        "subRatings": {
          "cleanliness": 4.190542,
          "location": 4.6725383,
          "rooms": 3.9813929,
          "service": 3.9386554,
          "sleepQuality": 4.166858,
          "value": 3.9060726
        },
        "styles": [{"name": "Family", "rankInCity": 109, "score": 1.9675850720952188}],
        "amenities": [{"group": "Room features", "label": "Blackout curtains", "category": "Comfort", "highlighted": true}],
        "roomFeaturesUrl": "https://www.tripadvisor.com/Hotel_Feature-g45963-d143336-zft1-Paris_Las_Vegas.html",
        "parents": [
          {
            "id": "45963",
            "hotelsUrl": "https://www.tripadvisor.com/Hotels-g45963-Las_Vegas_Nevada-Hotels.html"
          }
        ]
      }
    },
    "attributes": [{"group": "Room features", "label": "Blackout curtains"}],
    "verifiedOwner": true
  }
}

错误

状态代码含义
400INVALID_PARAMS参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头，或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
404NOT_FOUND该地点不存在。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR引擎返回了无法使用的内容。请退避后重试。
503SERVICE_UNAVAILABLE临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.0012。标价；单日调用超过 1,000 次后单价下调。

说明

  • 传入 places 返回的 id，或把 Tripadvisor 链接作为 id 或 url 传入。

Places

在 Tripadvisor 上查找地点。

Reviews

从 Tripadvisor 获取地点的评论。

本页内容

请求参数响应错误价格说明