DocumentationDashboard

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 only

Calling 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.

NameTypeRequiredDescription
url_pathstringone ofThe Tripadvisor page path, e.g. "/Hotel_Review-g293974-d456...". Use Business Search to resolve a name to it.
keywordstringone ofBusiness name, when you don't have the url_path. Needs a location alongside it.
location_namestringoptionalFull location name, e.g. "Istanbul,Turkey". Either this or location_code.
location_codenumberoptionalNumeric location code. Either this or location_name.
language_codestringoptionalLanguage code, e.g. "tr". Either this or language_name.
language_namestringoptionalFull language name, e.g. "Turkish". Either this or language_code.
depthnumberoptionalReviews to return, 1-4490. Default 10. Billed per 10.
sort_bystringoptionalReview ordering. One of: most_recent, detailed_reviews.
ratingsstringoptionalComma-separated rating filter: excellent, very_good, average, poor, terrible.
visit_typestringoptionalComma-separated visit-type filter: families, couples, solo, business, friends.
task_idstringoptionalCollect an upstream task that timed out earlier instead of starting a new one. Pass the `task_id` from the failed task's error.

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.