Tripadvisor
Reviews
Tripadvisor reviews for a business — rating, title, text, visit type and owner responses. Up to 4490 in one task.
GET
/v1/tripadvisor/reviews10 creditsheavyqueue onlyCalling this endpoint
The source behind this endpoint answers from a queue, and that queue outlives an HTTP request — so there is no live call to make. Queue it as a task and poll for the result; /v1/tripadvisor/reviews itself answers 400 async_only.
curl --request POST 'https://data-api.roketfy.com/v1/tasks' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"platform": "tripadvisor",
"endpoint": "reviews",
"params": {
"url_path": "<url_path>",
"keyword": "<keyword>"
}
}'See batch tasks for the full lifecycle.
Parameters
Supply at least one of url_path or keyword. Neither is required on its own.
| Name | Type | Required | Description |
|---|---|---|---|
| url_path | string | one of | The Tripadvisor page path, e.g. "/Hotel_Review-g293974-d456...". Use Business Search to resolve a name to it. |
| keyword | string | one of | Business name, when you don't have the url_path. Needs a location alongside it. |
| location_name | string | optional | Full location name, e.g. "Istanbul,Turkey". Either this or location_code. |
| location_code | number | optional | Numeric location code. Either this or location_name. |
| language_code | string | optional | Language code, e.g. "tr". Either this or language_name. |
| language_name | string | optional | Full language name, e.g. "Turkish". Either this or language_code. |
| depth | number | optional | Reviews to return, 1-4490. Default 10. Billed per 10. |
| sort_by | string | optional | Review ordering. One of: most_recent, detailed_reviews. |
| ratings | string | optional | Comma-separated rating filter: excellent, very_good, average, poor, terrible. |
| visit_type | string | optional | Comma-separated visit-type filter: families, couples, solo, business, friends. |
| task_id | string | optional | Collect an upstream task that timed out earlier instead of starting a new one. Pass the `task_id` from the failed task's error. |
Request
curl --request GET 'https://data-api.roketfy.com/v1/tripadvisor/reviews?url_path=%3Curl_path%3E' \
--header 'Authorization: Bearer YOUR_TOKEN'MCP
Available to AI agents as the tool tripadvisor_reviews, with the same parameters and the same credit cost. The tool queues a task and returns its id, like the HTTP flow above.