--- title: "Place" description: "从 Tripadvisor 获取单个地点的详细信息。" --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/tripadvisor/place ``` 参数可以用 `GET` 的查询字符串发送，也可以用 `POST` 的 JSON 请求体发送，两者等价。 ## 请求 ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/tripadvisor/place?id=143336&country=US" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ id: "143336", country: "US" }); const res = await fetch(`https://gateway.apinoa.com/v1/tripadvisor/place?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/tripadvisor/place", params={"id": "143336", "country": "US"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## 参数 | Parameter | Type | Required | Notes | |---|---|---|---| | `country` | enum | | The market, as an ISO 3166 country code. `US` `GB` `CA` `AU` `IN` `IE` `DE` `FR` `IT` `ES` `NL` `BR` `MX` `JP` `KR` | | `id` | string | | The place's id, as `places` returns it (a Tripadvisor link is taken too). | | `lang` | string | | Interface language. | | `url` | string | | A Tripadvisor place link. | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## 响应 在 `data` 中返回 [`Place`](/docs/api-reference/serp/response-schema#place)。 真实响应的节选：数组只保留前几项，长文本已截断。 ```json { "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 } } ``` ## 错误 | 状态 | 代码 | 含义 | |---|---|---| | 400 | `INVALID_PARAMS` | 参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。 | | 401 | `UNAUTHORIZED` | 缺少 `x-api-key` 请求头，或密钥已吊销或未知。 | | 402 | `INSUFFICIENT_BALANCE` | 余额不足以支付本次调用。请在控制台充值。 | | 404 | `NOT_FOUND` | 该地点不存在。 | | 429 | `MARKETPLACE_SATURATED` | 并发调用过多。请等待 `Retry-After` 秒后重试。 | | 502 | `UPSTREAM_ERROR` | 引擎返回了无法使用的内容。请退避后重试。 | | 503 | `SERVICE_UNAVAILABLE` | 临时故障。请退避后重试。 | 全部错误代码见 [Errors](/docs/errors)。失败的调用不计费。 ## 价格 **Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## 说明 - 传入 `places` 返回的 `id`，或把 Tripadvisor 链接作为 `id` 或 `url` 传入。