// docs
Extracts details for a hotel, restaurant, or attraction from Tripadvisor, including reputation, address, contacts, hours, photos, and category-specific fields.
tripadvisor.com.br:pdp · 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": "pdp",
"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"
}'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_pdp",
"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",
"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 |
|---|---|---|---|---|---|
| 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 |
| 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 pdp. | - | pdp |
Category and identifiers are automatically inferred from URL.
{
"target": "tripadvisor.com.br",
"type": "pdp",
"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"
}URLs from tripadvisor.com are also accepted and normalized to tripadvisor.com.br.
{
"target": "tripadvisor.com.br",
"type": "pdp",
"url": "https://www.tripadvisor.com/Hotel_Review-g303631-d123456-Reviews-Hotel_Exemplo-Sao_Paulo.html"
}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": "\"pdp\"",
"data.requestUrl": "string (standard URL)",
"data.extractedAt": "string (ISO datetime)",
"data.data.locationId": "number",
"data.data.geoId": "number | null",
"data.data.url": "string (URL)",
"data.data.name": "string",
"data.data.placeType": "\"hotel\" | \"restaurant\" | \"attraction\"",
"data.data.address": "string | null",
"data.data.latitude": "number | null",
"data.data.longitude": "number | null",
"data.data.rating.rating": "number | null",
"data.data.rating.reviewCount": "number | null",
"data.data.ranking": "string | null",
"data.data.priceLevel": "string (optional)",
"data.data.categories[]": "string",
"data.data.description": "string | null",
"data.data.phone": "string | null",
"data.data.email": "string (optional)",
"data.data.website": "string (URL) | null",
"data.data.openingHours.isOpenNow": "boolean | null",
"data.data.openingHours.status": "string | null",
"data.data.openingHours.schedule": "object<string, string[]>",
"data.data.awards": "string[]",
"data.data.ratingHistogram": "object<\"1\" | \"2\" | \"3\" | \"4\" | \"5\", number | null>",
"data.data.photos[].id": "number | null",
"data.data.photos[].url": "string (URL)",
"data.data.photos[].caption": "string | null",
"data.data.hotel": "object (optional)",
"data.data.restaurant": "object (optional)",
"data.data.attraction": "object (optional)"
}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": "5adc7a31-6663-4dc8-b27c-20ff88ddcb15",
"executionId": "01K1TRIPADVISORPDP00000001",
"data": {
"source": "tripadvisor.com.br",
"type": "pdp",
"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:02:00.000Z",
"data": {
"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,
"description": "Museu de arte localizado na Avenida Paulista.",
"phone": "+55 11 3149-5959",
"website": "https://masp.org.br/",
"openingHours": {
"isOpenNow": true,
"status": "Aberto agora",
"schedule": {
"terça-feira": [
"10:00–20:00"
]
}
},
"awards": [],
"ratingHistogram": {
"1": 76,
"2": 96,
"3": 604,
"4": 2316,
"5": 3919
},
"photos": [
{
"id": 123456,
"url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/masp-gallery.jpg",
"caption": "Vista do museu",
"width": 1200,
"height": 800
}
],
"attraction": {
"attractionTypes": [
"Museus de arte"
],
"suggestedDuration": "1 a 2 horas",
"accessibility": []
}
}
}
}| Path | Type | Description | Example |
|---|---|---|---|
| data.data.address | string | null | Public address displayed by Tripadvisor. | Avenida Paulista, 1578, São Paulo, SP |
| data.data.attraction | object (optional) | Attraction specific fields. | {"attractionTypes":["Museus de arte"],"suggestedDuration":"1 a 2 horas","accessibility":[]} |
| data.data.awards | string[] | Awards and recognition published. | [] |
| data.data.categories[] | string | Categories assigned to the location. | Museus de arte |
| data.data.description | string | null | Public description of the location. | Museu de arte localizado na Avenida Paulista. |
| data.data.email | string (optional) | E-public email when available. | N/A |
| data.data.geoId | number | null | Geographic identifier of the destination. | 303631 |
| data.data.hotel | object (optional) | Hosting-specific fields. | N/A |
| data.data.latitude | number | null | Published latitude for location. | -23.5614 |
| data.data.locationId | number | Public identifier of the location in Tripadvisor. | 311968 |
| data.data.longitude | number | null | Published longitude for the location. | -46.6559 |
| data.data.name | string | Public name of the establishment or attraction. | Museu de Arte de São Paulo Assis Chateaubriand - MASP |
| data.data.openingHours.isOpenNow | boolean | null | Indicates whether the location is open at the time of extraction. | true |
| data.data.openingHours.schedule | object<string, string[]> | Weekly schedule grouped by day. | {"terça-feira":["10:00–20:00"]} |
| data.data.openingHours.status | string | null | Public health status text. | Aberto agora |
| data.data.phone | string | null | Public telephone of the establishment. | +55 11 3149-5959 |
| data.data.photos[].caption | string | null | Public photo caption. | Vista do museu |
| data.data.photos[].id | number | null | Photo identifier when available. | 123456 |
| data.data.photos[].url | string (URL) | URL public photo. | https://dynamic-media-cdn.tripadvisor.com/media/photo-o/masp-gallery.jpg |
| data.data.placeType | "hotel" | "restaurant" | "attraction" | Category inferred from URL. | attraction |
| data.data.priceLevel | string (optional) | Textual price range when published. | N/A |
| data.data.ranking | string | null | Position of the location in the destination ranking. | #7 de 1149 coisas para fazer em São Paulo |
| data.data.rating.rating | number | null | Aggregated site note. | 4.5 |
| data.data.rating.reviewCount | number | null | Public number of reviews. | 8072 |
| data.data.ratingHistogram | object<"1" | "2" | "3" | "4" | "5", number | null> | Number of reviews per note from 1 to 5. | {"1":76,"2":96,"3":604,"4":2316,"5":3919} |
| data.data.restaurant | object (optional) | Restaurant-specific fields. | N/A |
| data.data.url | string (URL) | URL public canonical 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.data.website | string (URL) | null | Public website linked to profile. | https://masp.org.br/ |
| data.extractedAt | string (ISO datetime) | Date and time UTC of extraction. | 2026-07-27T18:02:00.000Z |
| data.requestUrl | string (standard URL) | Same value as `data.data.url`; 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.source | string | Public source consulted. | tripadvisor.com.br |
| data.type | "pdp" | Type of extraction performed. | pdp |
| executionId | string (uuid) | Idempotent identifier of the execution. | 01K1TRIPADVISORPDP00000001 |
| requestId | string (uuid) | Request identifier in GeckoAPI. | 5adc7a31-6663-4dc8-b27c-20ff88ddcb15 |
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. |