Endpoint Playground

Try the TripAdvisor Reviews API

Returns reviews for a TripAdvisor place identified by `id` (location id) or `url`. `limit` defaults to 20 (max 50); `page` is 1-based; `language`, `ratings` (1 to 5) and `sort_by` refine the list. Each review has author, title, text, dates, rating, language, helpful votes, photos and URL. A page beyond `total` returns an empty `reviews` array.

What a live request returned

14 Oct 2026: 3 reviews; 15 fields had a value in every checked item and 1 varied between items.

Observed request: GET /tripadvisor/reviews?id=113311&language=en&limit=3&page=1
Fields with a value in every checked item: id, url, title, text, author, author_id, author_url, author_avatar

Sample value profiles: date: 2026-08-08 to 2026-08-30; url: tripadvisor.com; text: median 683 characters.

Request: GET /tripadvisor/reviews
Cost: 5 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.64 s
Monitored request: GET /tripadvisor/reviews?id=113311&language=en&limit=3&page=1

TripAdvisor Reviews API documentation TripAdvisor platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/tripadvisor/reviews?id=113311&sort_type=ML_SORTED&sort_by=FAVORABLE_RATING" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	No	113311	TripAdvisor location id
url	string	No		TripAdvisor place URL
page	integer	No		1-based review page
limit	integer	No		Maximum reviews
language	string	No		Review language
sort_type	string	No	ML_SORTED	Legacy sort type; DEFAULT selects newest first, ML_SORTED uses upstream order unless sort_by is DATE
sort_by	string	No	FAVORABLE_RATING	Legacy sort field; DATE selects newest first, FAVORABLE_RATING uses upstream order
ratings	array	No		Rating filters
do_machine_translation	boolean	No		Enable upstream machine translation
photos_per_review_limit	integer	No		Maximum photos per review

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "113311",
    "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
    "page": 1,
    "limit": 3,
    "language": "en",
    "total": 1517,
    "reviews": [
      {
        "id": "1060008752",
        "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d113311-r1060008752-The_Peninsula_New_York-New_York_City_New_York.html",
        "title": "Outstanding weekend at the Peninsula",
        "text": "Excellent stay with attentive service.",
        "author": "Jane D.",
        "date": "2026-05-01",
        "created_date": "2026-05-01",
        "language": "en",
        "rating": 5,
        "helpful": 1,
        "photos": [
          "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg"
        ]
      }
    ]
  }
}

More TripAdvisor endpoints

Autocomplete TripAdvisor locations and places Get TripAdvisor enum metadata Search TripAdvisor hotels Get TripAdvisor place Search TripAdvisor places

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey5 credits/requesttripadvisor.tripadvisorReviewsResponseDocTripAdvisor

GET /tripadvisor/reviews

Get TripAdvisor reviews

Response behavior

Query parameters: pass either `id` with a TripAdvisor location id or `url` with a TripAdvisor place URL. Optional parameters include `page`, `limit`, `language`, `sort_type`, `sort_by`, repeated `ratings`, `do_machine_translation`, and `photos_per_review_limit`. `sort_type` accepts `ML_SORTED` (default) and `DEFAULT`. `sort_by` accepts `FAVORABLE_RATING` (default) and `DATE`. These legacy labels are compatibility inputs for the current frontend: `DEFAULT` or `DATE` selects newest first; otherwise Tripadvisor determines the order. `FAVORABLE_RATING` no longer guarantees an ordering by highest rating. `ratings` accepts repeated values `1`, `2`, `3`, `4`, and `5`. `limit` defaults to 20 and is capped at 50. Requests above 20 combine bounded upstream pages and detail batches while preserving the requested page offset and order. `photos_per_review_limit` defaults to 7 and is capped at 20. `do_machine_translation` defaults to true: title/text use the list’s requested-language version. When false, the detail query returns original-language text. The language filter selects reviews available in the requested language, including translations; photos are capped after normalization. Pagination preserves the upstream list order, and `total` is the count after filters. A verified empty list or a page beyond `total` returns an empty `reviews` array. Missing list/detail data, query retirement, and blocked requests return an upstream error. Returns TripAdvisor public reviews. Review records include author, title, text, dates, rating, language, helpful votes, photos, and public review URLs when available.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

Provide either a TripAdvisor location id or a place URL. You do not need both.

optionalstring

TripAdvisor location idurl

optionalstring

TripAdvisor place URL

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

tripadvisor_reviews

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "113311",
    "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
    "page": 1,
    "limit": 3,
    "language": "en",
    "total": 1517,
    "reviews": [
      {
        "id": "1060008752",
        "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d113311-r1060008752-The_Peninsula_New_York-New_York_City_New_York.html",
        "title": "Outstanding weekend at the Peninsula",
        "text": "Excellent stay with attentive service.",
        "author": "Jane D.",
        "date": "2026-05-01",
        "created_date": "2026-05-01",
        "language": "en",
        "rating": 5,
        "helpful": 1,
        "photos": [
          "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg"
        ]
      }
    ]
  }
}

Try the TripAdvisor Reviews API

What a live request returned

14 Oct 2026: 3 reviews; 15 fields had a value in every checked item and 1 varied between items.

Observed request: GET /tripadvisor/reviews?id=113311&language=en&limit=3&page=1
Fields with a value in every checked item: id, url, title, text, author, author_id, author_url, author_avatar

Sample value profiles: date: 2026-08-08 to 2026-08-30; url: tripadvisor.com; text: median 683 characters.

Request: GET /tripadvisor/reviews
Cost: 5 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.64 s
Monitored request: GET /tripadvisor/reviews?id=113311&language=en&limit=3&page=1

TripAdvisor Reviews API documentation TripAdvisor platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/tripadvisor/reviews?id=113311&sort_type=ML_SORTED&sort_by=FAVORABLE_RATING" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	No	113311	TripAdvisor location id
url	string	No		TripAdvisor place URL
page	integer	No		1-based review page
limit	integer	No		Maximum reviews
language	string	No		Review language
sort_type	string	No	ML_SORTED	Legacy sort type; DEFAULT selects newest first, ML_SORTED uses upstream order unless sort_by is DATE
sort_by	string	No	FAVORABLE_RATING	Legacy sort field; DATE selects newest first, FAVORABLE_RATING uses upstream order
ratings	array	No		Rating filters
do_machine_translation	boolean	No		Enable upstream machine translation
photos_per_review_limit	integer	No		Maximum photos per review

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "113311",
    "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
    "page": 1,
    "limit": 3,
    "language": "en",
    "total": 1517,
    "reviews": [
      {
        "id": "1060008752",
        "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d113311-r1060008752-The_Peninsula_New_York-New_York_City_New_York.html",
        "title": "Outstanding weekend at the Peninsula",
        "text": "Excellent stay with attentive service.",
        "author": "Jane D.",
        "date": "2026-05-01",
        "created_date": "2026-05-01",
        "language": "en",
        "rating": 5,
        "helpful": 1,
        "photos": [
          "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg"
        ]
      }
    ]
  }
}

Get TripAdvisor reviews

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "id": "113311", "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html", "page": 1, "limit": 3, "language": "en", "total": 1517, "reviews": [ { "id": "1060008752", "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d113311-r1060008752-The_Peninsula_New_York-New_York_City_New_York.html", "title": "Outstanding weekend at the Peninsula", "text": "Excellent stay with attentive service.", "author": "Jane D.", "date": "2026-05-01", "created_date": "2026-05-01", "language": "en", "rating": 5, "helpful": 1, "photos": [ "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg" ] } ] } }