Skip to content
PT Start free

// docs

Tripadvisor: Read reviews

Extracts paginated reviews of hotels, restaurants and attractions from Tripadvisor, sorted by relevance or most recent.

tripadvisor.com.br:review · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

HTTP request

cURL 
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "tripadvisor.com.br",
  "type": "review",
  "url": "https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html",
  "page": 1,
  "sort": "most_relevant"
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

tripadvisor_com_br_review · tools/call 
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "tripadvisor_com_br_review",
    "arguments": {
      "url": "https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html",
      "page": 1,
      "sort": "most_relevant",
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

FieldTypeRequirementRuleDefaultExample
url
URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.
 string (URL) Required URL public Hotel_Review, Restaurant_Review, or Attraction_Review on tripadvisor.com.br or tripadvisor.com. - https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html
sort
Ordering for VivaReal, Chaves na Mão, OLX and Webmotors PLP, Booking Review and Hotels Review. VivaReal: relevance/date/price/biggest_price/biggest_area. Webmotors: relevance/price/biggest_price/year_desc/mileage_asc. OLX: relevance/date/price/biggest_price/price_relevance. Booking/Hotels Review: most_relevant/newest_first/oldest_first/score_desc/score_asc.
 "relevance" | "date" | "price" | "biggest_price" | "biggest_area" | "price_relevance" | "most_relevant" | "newest_first" | "oldest_first" | "score_desc" | "score_asc" | "year_desc" | "mileage_asc" Optional Ordering: most_relevant or newest_first. most_relevant most_relevant
target
Target source for extraction.
 enum Required Always required and must be tripadvisor.com.br. - tripadvisor.com.br
type
Extraction type: pdp, idp, plp, ilp, quote, review or places.
 enum Required Always required and must be review. - review
page
Pagination. In PLP, including Trivago, and in Reclame AQUI ILP starts in 1; in review (MercadoLivre, Booking and Hotels) starts in 0. The Reclame AQUI ILP even accepts the page 100.
 integer Optional Reviews page, starting at 1. 1 1

Request examples

Most Relevant Reviews

Returns the first page using the default ordering.

Most Relevant Reviews 
{
  "target": "tripadvisor.com.br",
  "type": "review",
  "url": "https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html",
  "page": 1,
  "sort": "most_relevant"
}

Latest Reviews

Sorts by data and requests the second page.

Latest Reviews 
{
  "target": "tripadvisor.com.br",
  "type": "review",
  "url": "https://www.tripadvisor.com/Restaurant_Review-g303631-d123456-Reviews-Restaurante_Exemplo-Sao_Paulo.html",
  "page": 2,
  "sort": "newest_first"
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema 
{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "\"review\"",
  "data.requestUrl": "string (standard URL)",
  "data.extractedAt": "string (ISO datetime)",
  "data.locationId": "number",
  "data.geoId": "number | null",
  "data.name": "string",
  "data.placeType": "\"hotel\" | \"restaurant\" | \"attraction\"",
  "data.page": "number",
  "data.resultsPerPage": "number",
  "data.sort": "\"most_relevant\" | \"newest_first\"",
  "data.totalReviews": "number | null",
  "data.ratingHistogram": "object<\"1\" | \"2\" | \"3\" | \"4\" | \"5\", number | null>",
  "data.hasNextPage": "boolean",
  "data.nextPage": "number | null",
  "data.nextPageUrl": "string (URL) | null",
  "data.reviews[].reviewId": "number",
  "data.reviews[].url": "string (URL) | null",
  "data.reviews[].rating": "number | null",
  "data.reviews[].title": "string | null",
  "data.reviews[].text": "string | null",
  "data.reviews[].language": "string | null",
  "data.reviews[].originalLanguage": "string | null",
  "data.reviews[].publishedDate": "string | null",
  "data.reviews[].tripDate": "string | null",
  "data.reviews[].tripType": "string (optional)",
  "data.reviews[].helpfulVotes": "number | null",
  "data.reviews[].author": "object | null",
  "data.reviews[].additionalRatings": "Array<{ label: string | null, rating: number | null }>",
  "data.reviews[].photos": "TripadvisorPhoto[]",
  "data.reviews[].ownerResponse": "object (optional)"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample 
{
  "requestId": "fe28ad04-b88d-4fb4-99ae-631bd6eb03af",
  "executionId": "01K1TRIPADVISORREVIEW00001",
  "data": {
    "source": "tripadvisor.com.br",
    "type": "review",
    "requestUrl": "https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html",
    "extractedAt": "2026-07-27T18:03:00.000Z",
    "locationId": 311968,
    "geoId": 303631,
    "name": "Museu de Arte de São Paulo Assis Chateaubriand - MASP",
    "placeType": "attraction",
    "page": 1,
    "resultsPerPage": 10,
    "sort": "newest_first",
    "totalReviews": 7012,
    "ratingHistogram": {
      "1": 76,
      "2": 96,
      "3": 604,
      "4": 2316,
      "5": 3919
    },
    "hasNextPage": true,
    "nextPage": 2,
    "nextPageUrl": "https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-or10-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html",
    "reviews": [
      {
        "reviewId": 100000001,
        "url": "https://www.tripadvisor.com.br/ShowUserReviews-g303631-d311968-r100000001-MASP.html",
        "rating": 5,
        "title": "Visita imperdível",
        "text": "Ótimo acervo e localização.",
        "language": "pt",
        "originalLanguage": "pt",
        "publishedDate": "2026-07-20",
        "tripDate": "2026-07",
        "helpfulVotes": 2,
        "author": {
          "id": "ABC123",
          "displayName": "Viajante",
          "username": "viajante_sp",
          "hometown": "São Paulo, SP",
          "contributions": 42,
          "verified": false
        },
        "additionalRatings": [],
        "photos": []
      }
    ]
  }
}

Complete field reference

PathTypeDescriptionExample
data.extractedAt string (ISO datetime) Date and time UTC of extraction. 2026-07-27T18:03:00.000Z
data.geoId number | null Geographic identifier of the destination. 303631
data.hasNextPage boolean Indicates whether there is another reviews page. true
data.locationId number Public identifier of the location in Tripadvisor. 311968
data.name string Public name of the establishment or attraction. Museu de Arte de São Paulo Assis Chateaubriand - MASP
data.nextPage number | null Next page number or null. 2
data.nextPageUrl string (URL) | null public URL equivalent to the next page. https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-or10-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html
data.page number Current page, always starting at 1. 1
data.placeType "hotel" | "restaurant" | "attraction" Category inferred from URL. attraction
data.ratingHistogram object<"1" | "2" | "3" | "4" | "5", number | null> Distribution of evaluations by grade. {"1":76,"2":96,"3":604,"4":2316,"5":3919}
data.requestUrl string (standard URL) URL equivalent to request; never exposes the queried internal endpoint. https://www.tripadvisor.com.br/Attraction_Review-g303631-d311968-Reviews-Museu_de_Arte_de_Sao_Paulo_Assis_Chateaubriand_MASP-Sao_Paulo_State_of_Sao_Paulo.html
data.resultsPerPage number Number of reviews returned per page. 10
data.reviews[].additionalRatings Array<{ label: string | null, rating: number | null }> Additional notes per criteria when published. []
data.reviews[].author object | null Summary public profile of the author. {"id":"ABC123","displayName":"Viajante","username":"viajante_sp","hometown":"São Paulo, SP","contributions":42,"verified":false}
data.reviews[].helpfulVotes number | null Public number of helpful votes. 2
data.reviews[].language string | null Language of the returned text. pt
data.reviews[].originalLanguage string | null Original language provided by the source. pt
data.reviews[].ownerResponse object (optional) Public response from the establishment when existing. N/A
data.reviews[].photos TripadvisorPhoto[] Public photos attached to review. []
data.reviews[].publishedDate string | null Review publication date. 2026-07-20
data.reviews[].rating number | null Note attributed by the author. 5
data.reviews[].reviewId number Public identifier for the assessment. 100000001
data.reviews[].text string | null Public text of the assessment. Ótimo acervo e localização.
data.reviews[].title string | null Assessment title. Visita imperdível
data.reviews[].tripDate string | null Month or data of visit when published. 2026-07
data.reviews[].tripType string (optional) Trip type when published. N/A
data.reviews[].url string (URL) | null URL public evaluation. https://www.tripadvisor.com.br/ShowUserReviews-g303631-d311968-r100000001-MASP.html
data.sort "most_relevant" | "newest_first" Order effectively applied. newest_first
data.source string Public source consulted. tripadvisor.com.br
data.totalReviews number | null Total number of reviews disclosed by the source. 7012
data.type "review" Type of extraction performed. review
executionId string (uuid) Idempotent identifier of the execution. 01K1TRIPADVISORREVIEW00001
requestId string (uuid) Request identifier in GeckoAPI. fe28ad04-b88d-4fb4-99ae-631bd6eb03af

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP statusError codeMeaning
400INVALID_PAYLOADInvalid JSON or a request that violates the documented validation rules.
401UNAUTHORIZEDMissing authorization or an invalid API key or token.
402INSUFFICIENT_CREDITSThe account has insufficient credits for this operation.
403FORBIDDENThe account does not have access, or the API is temporarily disabled.
409EXECUTION_CONFLICTThe execution identifier conflicts with an incompatible execution state.
429RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTSA rate limit or simultaneous request limit was exceeded.
5xxUPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERRORAn upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Other Tripadvisor operations