NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Tripadvisor connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Tripadvisor actions, such as "Get Location Activities", "Get Location Awards" and "Get Location Details V2". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Tripadvisor, with input parameters and output schema.
TRIPADVISOR_GET_LOCATION_ACTIVITIESTool to retrieve an ordered list of all bookable activities for a destination. Use when you need to get available activities for a specific location by its ID. Returns activity details including pricing, descriptions, images, and availability information.
Input parameters
Desired language locale for response content (e.g., 'en', 'fr', 'es')
ISO 4217 currency code for pricing display (e.g., 'USD', 'EUR', 'GBP')
Unique identifier for the destination location
Pipe-separated list of activity categories to filter results. Valid categories include: 'Air/Helicopter Tours', 'Cruises/Water Tours', 'Cultural Tours', 'Day Trips', 'Food/Wine/Nightlife', 'Outdoor Activities', 'Walking Tours', 'Water Sports', etc. Example: 'Food/Wine/Nightlife\\ | Walking Tours'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TRIPADVISOR_GET_LOCATION_AWARDSTool to retrieve all awards earned by a TripAdvisor location. Use when you need to fetch awards history for a specific destination. Returns Traveler's Choice Awards, Certificates of Excellence, and Green Leader awards with badge images and metadata.
Input parameters
Unique ID for a TripAdvisor location/destination to retrieve awards for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TRIPADVISOR_GET_LOCATION_DETAILS_V2Tool to retrieve comprehensive information about a TripAdvisor location including name, address, ratings, reviews, and links. Requires an authenticated TripAdvisor API connection. Use when you need detailed information about a hotel, restaurant, attraction, or destination by its location ID.
Input parameters
ISO 4217 currency code for request and response (e.g., 'USD', 'EUR', 'GBP')
Desired language locale for localized responses. Supported languages include 'en', 'es', 'fr', 'de', 'ja', 'zh', and others. Default: 'en'
Unique TripAdvisor location ID of the destination or POI
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TRIPADVISOR_GET_LOCATION_GEOSTool to retrieve immediate children in the geographical location hierarchy for a given destination. Use when exploring location hierarchies or browsing geographical areas within a parent location.
Input parameters
The desired language locale for the response (e.g., 'en', 'fr', 'es').
Maximum quantity of items returned per request.
Starting position in the result set for pagination.
Filter for city listings when the location is a country. Use 'cities' to list all cities in a country, sorted to match the website order.
Currency code to use for request and response, following ISO 4217 standard (e.g., 'USD', 'EUR').
Unique identifier for the destination location.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TRIPADVISOR_GET_LOCATION_HOTELSRetrieves hotels near a specified TripAdvisor location. Returns up to 10 hotels sorted by proximity to the location's geographic center. Use this tool when you need to find hotels in a city, region, or geographic area. Provide a TripAdvisor location ID (e.g., '60745' for Boston, '60763' for New York City, '186338' for London) to get nearby hotels with their names, addresses, and distances from the center point. The tool performs a two-step process: 1. Retrieves location details (coordinates) for the given location_id 2. Searches for hotels near those coordinates Results are limited to 10 hotels per request, sorted by distance from the location center.
Input parameters
Language code for localized results (e.g., 'en' for English, 'de' for German, 'fr' for French). If not specified, defaults to English.
TripAdvisor location identifier for the geographic area (e.g., '60745' for Boston).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TRIPADVISOR_GET_LOCATION_PHOTOS_V2Retrieves up to 5 high-quality photos for a specific TripAdvisor location by location ID. Returns photos with multiple size variants (thumbnail, small, medium, large, original), user information, captions, and metadata. The API returns a maximum of 5 photos per request with no pagination options. Use this to display location images for hotels, restaurants, attractions, or destinations.
Input parameters
Language preference for results (e.g., 'en' for English, 'de' for German)
Unique TripAdvisor location ID for which to retrieve photos
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TRIPADVISOR_GET_LOCATION_REVIEWS_V2Tool to retrieve up to 5 of the most recent reviews for a specific TripAdvisor location. Use when you need to get user reviews, ratings, and feedback for a hotel, restaurant, attraction, or destination by its location ID.
Input parameters
Language locale code for the response (e.g., 'en_US', 'fr_FR', 'de', 'es'). See supported languages list in API docs
ISO 4217 currency code for request/response (e.g., 'USD', 'EUR', 'GBP')
When true, returns shared reviews from the Review Collection Platform (for partners only). Cannot be combined with regular recent reviews in the same call
Unique TripAdvisor location ID to retrieve reviews for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 7 Tripadvisor actions on Nagent, including "Get Location Activities", "Get Location Awards" and "Get Location Details V2". Get Location Activities: Retrieve an ordered list of all bookable activities for a destination. Each action is listed on this page with its input parameters and its output.
Tripadvisor connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Location Activities takes 1 required input: location_id. It also takes 3 optional inputs: lang, currency and product_groups. It returns data, error and successful.