--- title: "Reviews" 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/reviews ``` 参数可以用 `GET` 的查询字符串发送，也可以用 `POST` 的 JSON 请求体发送，两者等价。 ## 请求 ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/tripadvisor/reviews?place=143336&limit=5" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ place: "143336", limit: "5" }); const res = await fetch(`https://gateway.apinoa.com/v1/tripadvisor/reviews?${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/reviews", params={"place": "143336", "limit": "5"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## 参数 | Parameter | Type | Required | Notes | |---|---|---|---| | `cursor` | string | | The previous page's `cursor`. Pass it alone for the next page. | | `language` | string | | Only reviews in this language — Tripadvisor counts its machine translations into it (each review says when it is one). All languages by default. | | `limit` | integer 1–100 | | Results wanted (default 20, at most 100). More than one page is charged per page. | | `months` | string | | Only reviews of visits in these months, e.g. `6,7,8` or `june`. | | `place` | string | | The place's id, as `places` returns it (a Tripadvisor link is taken too). | | `q` | string | | Only reviews that mention this text. | | `rating` | string | | Only reviews with these stars, e.g. `5` or `1,2`. | | `sort` | enum | | Review order: Tripadvisor's own (default), newest first, or the most detailed first. `relevant` `newest` `detailed` | | `visitType` | string | | Only reviews by these travellers: families, couples, solo, business, friends (comma-separated). | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## 响应 在 `data` 中返回 [`PlaceReviewsPage`](/docs/api-reference/serp/response-schema#placereviewspage)。 真实响应的节选：数组只保留前几项，长文本已截断。 ```json { "success": true, "data": { "engine": "tripadvisor", "placeId": "143336", "summary": { "average": 3.9, "count": 40012, "distribution": {"1": 6.93, "2": 7.08, "3": 14.87, "4": 29.89, "5": 41.24} }, "starCounts": {"1": 2772, "2": 2833, "3": 5948, "4": 11959, "5": 16500}, "sort": "newest", "page": {"index": 1, "size": 5, "total": 40012}, "reviews": [ { "id": "1083706294", "author": "Richie J", "authorId": "DEE03B589798E25B6D9C7B158ED1E551", "authorUrl": "https://www.tripadvisor.com/Profile/536richiej", "authorAvatarUrl": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/f2/11/default-avatar-2020-23.jpg?w=1200&h=1200&s=1", "rating": 3, "title": "Multiple issues derailed experience", "body": "The shower only had cold water. There was no body wash bc the canister was broken. Called housekeeping and a bag of soaps were left on bathroom counter. This is…", "date": "2026-10-29T22:42:49.097Z", "helpfulCount": 0, "images": [], "language": "en", "pinned": false, "ext": { "url": "https://www.tripadvisor.com/ShowUserReviews-g45963-d143336-r1083706294-Paris_Las_Vegas-Las_Vegas_Nevada.html", "visit": {"type": "couples", "date": "2026-10"}, "photoCount": 0, "trustSafetyAlert": false, "reviewer": {"username": "536richiej", "contributions": 1, "helpfulVotes": 0} } }, { "id": "1083555734", "author": "Dorothy I", "authorId": "A12310ACFD286DA674866408BEEA29DC", "authorUrl": "https://www.tripadvisor.com/Profile/dorothyi321", "authorAvatarUrl": "https://dynamic-media-cdn.tripadvisor.com/media/photo-s/01/2e/70/69/avatar047.jpg?w=450&h=450&s=1", "rating": 5, "title": "Lovely", "body": "Initially they put me in Versailles tower, I was a bit disappointed, great view but loud and elevator issues, it’s not quite as elegant as I expected from this…", "date": "2026-10-28T16:59:35.842Z", "helpfulCount": 0, "images": [ "https://dynamic-media-cdn.tripadvisor.com/media/v2/photo-o/35/0f/26/ce/image.jpg?w=3024&h=4032&s=1", "https://dynamic-media-cdn.tripadvisor.com/media/v2/photo-o/35/0f/26/d0/image.jpg?w=3024&h=4032&s=1" ], "language": "en", "pinned": false, "ext": { "url": "https://www.tripadvisor.com/ShowUserReviews-g45963-d143336-r1083555734-Paris_Las_Vegas-Las_Vegas_Nevada.html", "visit": {"type": "solo", "date": "2026-10"}, "photoCount": 3, "photoCaptions": ["Perfect view"], "trustSafetyAlert": false, "reviewer": {"username": "dorothyi321", "contributions": 8, "helpfulVotes": 0} } } ], "cursor": "CLGdsXzj_3O3ElOeWzJoq8nqyzEjXq15aaxleTqAcTLFSh2SehSKQB2jIsWOaf8IfICs6nJDR5VnR9U0GpzUQSOAoVlzyvpvL9RzaURF88Z0S5LTXzqHsxc3nH0AOmvJCgsfOSRzVgAZi5qoJ_WLj_8Yg12i9w", "fetchedAt": "2026-10-30T01:02:47.016Z", "ext": { "place": { "name": "Paris Las Vegas", "type": "hotel", "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d143336-Reviews-Paris_Las_Vegas-Las_Vegas_Nevada.html" }, "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 }, "languages": { "de": 13697, "no": 16161, "fi": 92, "ru": 19635, "pt": 5745, "zhTW": 13079, "fr": 10019, "hu": 93, "sk": 92, "sr": 92, "zhCN": 12377, "sv": 12000, "ko": 13790, "in": 13751, "el": 13880, "en": 36553, "it": 17367, "es": 17965, "iw": 161, "cs": 93, "ar": 9357, "vi": 170, "th": 13062, "ja": 10254, "pl": 10764, "da": 10191, "nl": 16104, "tr": 7945 } } } } ``` ## 错误 | 状态 | 代码 | 含义 | |---|---|---| | 400 | `INVALID_CURSOR` | 该 `cursor` 不是本操作返回的。请不带它重新开始。 | | 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, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## 说明 - 把 `places` 返回的地点 `id` 作为 `place` 传入。 - 可按 `rating`、`visitType`、`months`、`language` 或 `q`（正文文本）筛选。指定 `language` 时，Tripadvisor 会计入其机器翻译，并在每条评论中注明。