# Tripadvisor reviews

This endpoint provides results from the “Reviews” element on the Tripadvisor platform. Takes url path, keyword, location name and more, all optional. Served by DataForSEO.

This endpoint provides results from the “Reviews” element on the Tripadvisor platform. The results are specific to the URL path or keyword you indicate, and and the selected location (see the List of Locations). Submit once with action=submit. Reuse this same tool with action=result and its id to read status/output at no additional cost. Queued is not finished.

- Tool ID: `dataforseo/business-data-tripadvisor-reviews`
- Name in the catalog: Business Data Tripadvisor Reviews
- Provider: [DataForSEO](/providers/dataforseo.md)
- Capability: [Tripadvisor reviews](/tools/reviews/tripadvisor.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "cost",
  "maxUsdDefault": 0.00075,
  "maxUsdCap": 100,
  "multipliers": [
    {
      "when": {
        "field": "priority",
        "equals": 2
      },
      "totalFactor": 2
    },
    {
      "when": {
        "field": "language_code",
        "truthy": true
      },
      "addUsd": 0.00075
    },
    {
      "when": {
        "field": "language_name",
        "truthy": true
      },
      "addUsd": 0.00075
    },
    {
      "addUsdPer": {
        "field": "depth",
        "usd": 0.00075,
        "per": 10,
        "minus": 10,
        "default": 10,
        "max": 1000
      }
    }
  ],
  "requireCost": true
}
```

### Action-specific pricing


```json
[
  {
    "field": "action",
    "equals": "result",
    "pricing": {
      "model": "per_call",
      "amountUsd": 0
    }
  }
]
```

Pricing source: [https://docs.dataforseo.com/v3/appendix/user_data/](https://docs.dataforseo.com/v3/appendix/user_data/). Account tariff business_data/tripadvisor/reviews/task_post; bounds applied to inputs; actual cost from provider response..

Price verification date: 2026-10-10.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "url_path": {
      "type": "string",
      "description": "URL path of the business entity required field if you do not specify keyword URL path to the Tripadvisor page of the business entity; examples: Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html ht",
      "maxLength": 2000,
      "minLength": 1
    },
    "keyword": {
      "type": "string",
      "description": "keyword required field if you do not specify url_path the keyword you specify should indicate a name of an existing business or prominent place on Tripadvisor; you can specify up to 700 characters in the keyword filed; all %## will be decod",
      "maxLength": 700,
      "minLength": 1
    },
    "location_name": {
      "type": "string",
      "description": "full name of search engine location required field if you don't specify location_code or url_path you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_",
      "maxLength": 2000,
      "minLength": 1
    },
    "location_code": {
      "type": "integer",
      "description": "search engine location code required field if you don't specify location_name or url_path you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/tri"
    },
    "priority": {
      "type": "integer",
      "description": "task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priorityYou will be additionally charged for the tasks with high execution priority. The cost can be calculated on",
      "enum": [
        1,
        2
      ]
    },
    "language_name": {
      "type": "string",
      "description": "full name of search engine language optional field if you use this field, your account will be charged for one extra request you can receive the list of available languages with language_name by making a separate request to the https://api.",
      "maxLength": 2000,
      "minLength": 1
    },
    "language_code": {
      "type": "string",
      "description": "search engine language code optional field if you use this field, your account will be charged for one extra request you can receive the list of available languages with language_code by making a separate request to the https://api.datafors",
      "maxLength": 10,
      "minLength": 1
    },
    "depth": {
      "type": "integer",
      "description": "parsing depth optional field number of reviews in SERP; we strongly recommend setting the parsing depth in the multiples of ten, because our systems processes ten reviews in a row; default value: 10; max value: 4490 Your account will be bil",
      "maximum": 1000,
      "minimum": 1
    },
    "ratings": {
      "type": "array",
      "description": "Tripadvisor traveler rating for a place of interest optional field rating based on the written reviews by a traveler after they visited a place. possible values: excellent, very_good, average, poor, terrible you can specify several values a",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1
    },
    "visit_type": {
      "type": "array",
      "description": "filter by type of travelers who left a review optional field possible values: families, couples, solo, business, friends you can specify several values at once",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1
    },
    "months": {
      "type": "array",
      "description": "filter by months when a traveler made a visit optional field possible values: january, february, march, april, may, april, june, july, august, september, october, november, december you can specify several values at once",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1
    },
    "sort_by": {
      "type": "string",
      "description": "results sorting parameters optional field you can use this field to sort the results; possible types of sorting: most_recent detailed_reviews",
      "maxLength": 2000,
      "minLength": 1
    },
    "translate_reviews": {
      "type": "boolean",
      "description": "translate reviews according to the URL path optional field if set to true, returned reviews will be translated to the language matching the specified url_path; for example, if url_path contains tripadvisor.it and translate_reviews is true, "
    },
    "tag": {
      "type": "string",
      "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
      "maxLength": 255
    },
    "action": {
      "type": "string",
      "enum": [
        "submit",
        "result"
      ],
      "default": "submit"
    },
    "id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 80,
      "pattern": "^[A-Za-z0-9-]+$"
    }
  },
  "allOf": [
    {
      "if": {
        "properties": {
          "action": {
            "const": "result"
          }
        },
        "required": [
          "action"
        ]
      },
      "then": {
        "type": "object",
        "properties": {
          "action": {
            "const": "result"
          },
          "id": {
            "type": "string",
            "minLength": 8,
            "maxLength": 80,
            "pattern": "^[A-Za-z0-9-]+$"
          }
        },
        "required": [
          "action",
          "id"
        ],
        "additionalProperties": false
      },
      "else": {
        "type": "object",
        "properties": {
          "url_path": {
            "type": "string",
            "description": "URL path of the business entity required field if you do not specify keyword URL path to the Tripadvisor page of the business entity; examples: Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html ht",
            "maxLength": 2000,
            "minLength": 1
          },
          "keyword": {
            "type": "string",
            "description": "keyword required field if you do not specify url_path the keyword you specify should indicate a name of an existing business or prominent place on Tripadvisor; you can specify up to 700 characters in the keyword filed; all %## will be decod",
            "maxLength": 700,
            "minLength": 1
          },
          "location_name": {
            "type": "string",
            "description": "full name of search engine location required field if you don't specify location_code or url_path you can receive the list of available locations with location_name by making a separate request to the https://api.dataforseo.com/v3/business_",
            "maxLength": 2000,
            "minLength": 1
          },
          "location_code": {
            "type": "integer",
            "description": "search engine location code required field if you don't specify location_name or url_path you can receive the list of available locations with location_code by making a separate request to the https://api.dataforseo.com/v3/business_data/tri"
          },
          "priority": {
            "type": "integer",
            "description": "task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priorityYou will be additionally charged for the tasks with high execution priority. The cost can be calculated on",
            "enum": [
              1,
              2
            ],
            "default": 1
          },
          "language_name": {
            "type": "string",
            "description": "full name of search engine language optional field if you use this field, your account will be charged for one extra request you can receive the list of available languages with language_name by making a separate request to the https://api.",
            "maxLength": 2000,
            "minLength": 1
          },
          "language_code": {
            "type": "string",
            "description": "search engine language code optional field if you use this field, your account will be charged for one extra request you can receive the list of available languages with language_code by making a separate request to the https://api.datafors",
            "maxLength": 10,
            "minLength": 1
          },
          "depth": {
            "type": "integer",
            "description": "parsing depth optional field number of reviews in SERP; we strongly recommend setting the parsing depth in the multiples of ten, because our systems processes ten reviews in a row; default value: 10; max value: 4490 Your account will be bil",
            "maximum": 1000,
            "minimum": 1,
            "default": 10
          },
          "ratings": {
            "type": "array",
            "description": "Tripadvisor traveler rating for a place of interest optional field rating based on the written reviews by a traveler after they visited a place. possible values: excellent, very_good, average, poor, terrible you can specify several values a",
            "items": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "maxItems": 100,
            "minItems": 1
          },
          "visit_type": {
            "type": "array",
            "description": "filter by type of travelers who left a review optional field possible values: families, couples, solo, business, friends you can specify several values at once",
            "items": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "maxItems": 100,
            "minItems": 1
          },
          "months": {
            "type": "array",
            "description": "filter by months when a traveler made a visit optional field possible values: january, february, march, april, may, april, june, july, august, september, october, november, december you can specify several values at once",
            "items": {
              "type": "string",
              "maxLength": 2000,
              "minLength": 1
            },
            "maxItems": 100,
            "minItems": 1
          },
          "sort_by": {
            "type": "string",
            "description": "results sorting parameters optional field you can use this field to sort the results; possible types of sorting: most_recent detailed_reviews",
            "maxLength": 2000,
            "minLength": 1
          },
          "translate_reviews": {
            "type": "boolean",
            "description": "translate reviews according to the URL path optional field if set to true, returned reviews will be translated to the language matching the specified url_path; for example, if url_path contains tripadvisor.it and translate_reviews is true, "
          },
          "tag": {
            "type": "string",
            "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
            "maxLength": 255
          },
          "action": {
            "const": "submit"
          }
        },
        "additionalProperties": false,
        "allOf": [
          {
            "anyOf": [
              {
                "required": [
                  "location_code"
                ]
              },
              {
                "required": [
                  "location_name"
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "dataforseo/business-data-tripadvisor-reviews",
  "input": {
    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
    "location_code": 1003854,
    "tag": "some_string_123",
    "priority": 1,
    "depth": 10,
    "action": "submit"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://docs.dataforseo.com/v3/business_data/tripadvisor/reviews/task_post/)

[REST inspection](https://api.agentik.cc/v1/tools/dataforseo/business-data-tripadvisor-reviews) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/dataforseo/business-data-tripadvisor-reviews) · [Agent index](/llms.txt)