Search Tripadvisor businesses
search_tripadvisor_businessesFinds hotels, restaurants, attractions, and other businesses on Tripadvisor by name or category within a city or region, with rating, review count, category, and the url_path that get_tripadvisor_reviews takes. Usually completes within this call; a 'processing' response returns a taskId to call back with in 30-60 seconds at no extra cost. Estimated price: $0.01 for 30 results, billed per 30 at twice the Local page's normal-priority rate, so the call usually returns them. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "search_tripadvisor_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Number of results to collect (30-210). Defaults to 30. Billed per 30 results. | |
| taskId | No | Resume a previous call that returned status "processing". Pass back the taskId exactly as returned (format "tripadvisor_search:<id>"). Resuming charges no extra credits. | |
| keyword | No | Business name, category, or place to find on Tripadvisor (e.g. 'seafood restaurant'). Required unless resuming with taskId. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| locationCode | No | Tripadvisor's own code for a city or region, as an alternative to locationName. The codes find_location returns are not Tripadvisor codes; pass locationName instead. | |
| locationName | No | City or region to search, as Tripadvisor names it: city, region and country, comma separated (e.g. "London,England,United Kingdom"). A name without its country is looked up in the project's country; a name Tripadvisor does not list is refused with the nearest names it does. Tripadvisor cannot search a whole country. Supply exactly one of locationName or locationCode unless resuming with taskId. | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| meta | No | ||
| status | Yes | ||
| taskId | Yes | ||
| businesses | No | ||
| savedResultId | No |