// docs
Lists hotels, restaurants or attractions in a destination in Tripadvisor with automatic location resolution and pagination starting at 1.
tripadvisor.com.br:plp · 1 credit per request
Standard credit cost. Your account pricing is shown in the sandbox.
Try this operation in the sandbox
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": "plp",
"location": "São Paulo, SP",
"placeType": "attraction",
"page": 1
}'Keep your API key on your server. See the quickstart for authentication and response handling.
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
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "tripadvisor_com_br_plp",
"arguments": {
"location": "São Paulo, SP",
"placeType": "attraction",
"page": 1,
"executionId": "exec_example_123"
}
}
}Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.
| Field | Type | Requirement | Rule | Default | Example |
|---|---|---|---|---|---|
| location Textual location used in Glassdoor PLP, Hoteis.com PLP, Trivago PLP and Tripadvisor PLP (e.g.: Brazil, Curitiba, Sao Paulo). | string | Required | City, region or destination that will be automatically resolved in Tripadvisor. | - | São Paulo, SP |
| 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" | Required | Listing category: 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 plp. | - | plp |
| 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 | Listing page, starting at 1. | 1 | 1 |
Resolves São Paulo in Tripadvisor and returns the first page of attractions.
{
"target": "tripadvisor.com.br",
"type": "plp",
"location": "São Paulo, SP",
"placeType": "attraction",
"page": 1
}Returns the destination's second restaurant page.
{
"target": "tripadvisor.com.br",
"type": "plp",
"location": "Rio de Janeiro, RJ",
"placeType": "restaurant",
"page": 2
}Leaf paths and expected types. Field names and enum values are part of the API contract.
{
"requestId": "string (uuid)",
"executionId": "string (uuid)",
"data.source": "string",
"data.type": "\"plp\"",
"data.requestUrl": "string (URL)",
"data.extractedAt": "string (ISO datetime)",
"data.location": "string",
"data.geoId": "number",
"data.placeType": "\"hotel\" | \"restaurant\" | \"attraction\"",
"data.page": "number",
"data.resultsPerPage": "number",
"data.totalResults": "number | null",
"data.hasNextPage": "boolean",
"data.nextPage": "number | null",
"data.nextPageUrl": "string (URL) | null",
"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[].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[].sponsored": "boolean"
}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.
{
"requestId": "4af78836-29dc-4182-8311-89e8bc531880",
"executionId": "01K1TRIPADVISORPLP00000001",
"data": {
"source": "tripadvisor.com.br",
"type": "plp",
"requestUrl": "https://www.tripadvisor.com.br/Attractions-g303631-Activities-Sao_Paulo_State_of_Sao_Paulo.html",
"extractedAt": "2026-07-27T18:01:00.000Z",
"location": "São Paulo, SP",
"geoId": 303631,
"placeType": "attraction",
"page": 1,
"resultsPerPage": 30,
"totalResults": 1149,
"hasNextPage": true,
"nextPage": 2,
"nextPageUrl": "https://www.tripadvisor.com.br/Attractions-g303631-Activities-oa30-Sao_Paulo_State_of_Sao_Paulo.html",
"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",
"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,
"sponsored": false
}
]
}
}| Path | Type | Description | Example |
|---|---|---|---|
| data.extractedAt | string (ISO datetime) | Date and time UTC of extraction. | 2026-07-27T18:01:00.000Z |
| data.geoId | number | Destination resolved on Tripadvisor. | 303631 |
| data.hasNextPage | boolean | Indicates whether another page can be requested. | true |
| data.items[].address | string | null | Address published in the listing. | 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. | 303631 |
| data.items[].locationId | number | Public identifier for the location. | 311968 |
| 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[].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 listing. | 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.location | string | Textual location received in the request. | São Paulo, SP |
| 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/Attractions-g303631-Activities-oa30-Sao_Paulo_State_of_Sao_Paulo.html |
| data.page | number | Current page, always starting at 1. | 1 |
| data.placeType | "hotel" | "restaurant" | "attraction" | Category requested for listing. | attraction |
| data.requestUrl | string (URL) | URL equivalent to request; never exposes the queried internal endpoint. | https://www.tripadvisor.com.br/Attractions-g303631-Activities-Sao_Paulo_State_of_Sao_Paulo.html |
| data.resultsPerPage | number | Page size used by the font. | 30 |
| data.source | string | Public source consulted. | tripadvisor.com.br |
| data.totalResults | number | null | Total disclosed by the source, when available. | 1149 |
| data.type | "plp" | Type of extraction performed. | plp |
| executionId | string (uuid) | Idempotent identifier of the execution. | 01K1TRIPADVISORPLP00000001 |
| requestId | string (uuid) | Request identifier in GeckoAPI. | 4af78836-29dc-4182-8311-89e8bc531880 |
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. |