// docs

Tripadvisor: Search places

Searches for hotels, restaurants and attractions on Tripadvisor by keyword, with optional category filter and standardized results.

tripadvisor.com.br:search · 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": "search",
  "keyword": "MASP"
}'

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_search · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "tripadvisor_com_br_search",
    "arguments": {
      "keyword": "MASP",
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

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

Field	Type	Requirement	Rule	Default	Example
keyword Keyword for PLP searches. In Google Search it represents the query sent to Google; in Booking PLP is mandatory; in other PLPs it can replace URL.	string	Required	Free text searched in Tripadvisor.	-	MASP
placeType Location category in Tripadvisor. It is mandatory in PLP, optional in the general search and automatically inferred from URL in PDP and Review.	"hotel" \| "restaurant" \| "attraction"	Optional	Filters results by hotel, restaurant or attraction.	-	attraction
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 search.	-	search

Request examples

Search all categories

Returns the locations found for the keyword, regardless of category.

Search all categories

{
  "target": "tripadvisor.com.br",
  "type": "search",
  "keyword": "MASP"
}

Search attractions only

Restricts normalized results to attractions.

Search attractions only

{
  "target": "tripadvisor.com.br",
  "type": "search",
  "keyword": "museus em São Paulo",
  "placeType": "attraction"
}

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": "\"search\"",
  "data.requestUrl": "string (URL)",
  "data.extractedAt": "string (ISO datetime)",
  "data.keyword": "string",
  "data.placeType": "\"hotel\" | \"restaurant\" | \"attraction\" | null",
  "data.totalResults": "number",
  "data.items[].locationId": "number",
  "data.items[].geoId": "number | null",
  "data.items[].url": "string (URL)",
  "data.items[].name": "string",
  "data.items[].placeType": "\"hotel\" | \"restaurant\" | \"attraction\"",
  "data.items[].address": "string | null",
  "data.items[].latitude": "number | null",
  "data.items[].longitude": "number | null",
  "data.items[].rating.rating": "number | null",
  "data.items[].rating.reviewCount": "number | null",
  "data.items[].ranking": "string | null",
  "data.items[].priceLevel": "string (optional)",
  "data.items[].categories[]": "string",
  "data.items[].thumbnail": "string (URL) | null",
  "data.items[].openNow": "boolean | null",
  "data.items[].openStatus": "string | null",
  "data.items[].sponsored": "boolean"
}

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": "8dad333d-ae0c-47d7-bdd7-6de811a25d99",
  "executionId": "01K1TRIPADVISORSEARCH000001",
  "data": {
    "source": "tripadvisor.com.br",
    "type": "search",
    "requestUrl": "https://www.tripadvisor.com.br/Search?q=MASP",
    "extractedAt": "2026-07-27T18:00:00.000Z",
    "keyword": "MASP",
    "placeType": "attraction",
    "totalResults": 1,
    "items": [
      {
        "locationId": 311968,
        "geoId": 303631,
        "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",
        "name": "Museu de Arte de São Paulo Assis Chateaubriand - MASP",
        "placeType": "attraction",
        "address": "Avenida Paulista, 1578, São Paulo, SP",
        "latitude": -23.5614,
        "longitude": -46.6559,
        "rating": {
          "rating": 4.5,
          "reviewCount": 8072
        },
        "ranking": "#7 de 1149 coisas para fazer em São Paulo",
        "categories": [
          "Museus de arte"
        ],
        "thumbnail": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/masp.jpg",
        "openNow": true,
        "openStatus": "Aberto agora",
        "sponsored": false
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.extractedAt	string (ISO datetime)	Date and time UTC of extraction.	2026-07-27T18:00:00.000Z
data.items[].address	string \| null	Address published in the result.	Avenida Paulista, 1578, São Paulo, SP
data.items[].categories[]	string	Public categories for the location.	Museus de arte
data.items[].geoId	number \| null	Geographic identifier of the destination in Tripadvisor.	303631
data.items[].latitude	number \| null	Published latitude for location.	-23.5614
data.items[].locationId	number	Public identifier of the establishment in Tripadvisor.	311968
data.items[].longitude	number \| null	Published longitude for the location.	-46.6559
data.items[].name	string	Public name of the location.	Museu de Arte de São Paulo Assis Chateaubriand - MASP
data.items[].openNow	boolean \| null	Indicates whether the location is open.	true
data.items[].openStatus	string \| null	Public health status text.	Aberto agora
data.items[].placeType	"hotel" \| "restaurant" \| "attraction"	Standard site category.	attraction
data.items[].priceLevel	string (optional)	Textual price range when published.	N/A
data.items[].ranking	string \| null	Position in the destination ranking.	#7 de 1149 coisas para fazer em São Paulo
data.items[].rating.rating	number \| null	Aggregated site note.	4.5
data.items[].rating.reviewCount	number \| null	Public number of reviews.	8072
data.items[].sponsored	boolean	Indicates whether the result was identified as sponsored.	false
data.items[].thumbnail	string (URL) \| null	Main image displayed in the result.	https://dynamic-media-cdn.tripadvisor.com/media/photo-o/masp.jpg
data.items[].url	string (URL)	URL public location.	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.keyword	string	Keyword received in the request.	MASP
data.placeType	"hotel" \| "restaurant" \| "attraction" \| null	Category applied to the search or null when all were accepted.	attraction
data.requestUrl	string (URL)	URL equivalent to request; never exposes the queried internal endpoint.	https://www.tripadvisor.com.br/Search?q=MASP
data.source	string	Public source consulted.	tripadvisor.com.br
data.totalResults	number	Number of results returned in this search.	1
data.type	"search"	Type of extraction performed.	search
executionId	string (uuid)	Idempotent identifier of the execution.	01K1TRIPADVISORSEARCH000001
requestId	string (uuid)	Request identifier in GeckoAPI.	8dad333d-ae0c-47d7-bdd7-6de811a25d99

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 status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Tripadvisor: Search places

HTTP request

MCP request

Supported inputs

Request examples

Search all categories

Search attractions only

Response schema

Example response

Complete field reference

Errors and missing data

Other Tripadvisor operations