NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
TripAdvisor Content API connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 TripAdvisor Content API actions, such as "Get Location Details", "Get Location Photos (Enhanced)" and "Get Location Reviews". 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 Content API, with input parameters and output schema.
TRIPADVISOR_CONTENT_API_GET_LOCATION_DETAILSTool to get comprehensive information about a location (hotel, restaurant, or attraction) including name, address, rating, and contact details. Use when you need detailed information about a specific TripAdvisor location.
Input parameters
The currency code to use for request and response (should follow ISO 4217).
The language in which to return results (e.g. 'en' for English or 'es' for Spanish) from the list of Supported Languages.
A unique identifier for a location on Tripadvisor. The location ID can be obtained using the Location Search.
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_CONTENT_API_GET_LOCATION_PHOTOS_V2Tool to retrieve up to 5 high-quality photos for a specific location with complete metadata and pagination support. Use when you need detailed photo information including user details, source filtering, and pagination. Photos are ordered by recency.
Input parameters
The number of results to return (maximum 5 photos per request)
The index of the first result for pagination
A comma-separated list of allowed photo sources. Allowed values are 'Expert', 'Management', 'Traveler'
The language in which to return results (e.g. 'en' for English or 'es' for Spanish) from the list of Supported Languages.
A unique identifier for a location on Tripadvisor. The location ID can be obtained using the Location Search.
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_CONTENT_API_GET_LOCATION_REVIEWSTool to retrieve up to 5 of the most recent reviews for a specific location. Use when you need customer feedback, ratings, or review content for a TripAdvisor location.
Input parameters
The number of results to return (max 100)
The index of the first result for pagination
The language in which to return results (e.g. 'en' for English or 'es' for Spanish) from the list of Supported Languages.
A unique identifier for a location on Tripadvisor. The location ID can be obtained using the Location Search.
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_CONTENT_API_SEARCH_LOCATIONS2Tool to search for TripAdvisor locations with advanced filtering options. Use when you need to find locations by name, category, phone, address, or coordinates with radius-based filtering.
Input parameters
Phone number to filter the search results by (this can be in any format with spaces and dashes but without the '+' sign at the beginning)
Length of the radius from the provided latitude/longitude pair to filter results
Address to filter the search results by
Latitude/Longitude pair to scope down the search around a specific point - e.g. "42.3455,-71.10767"
Valid category types for filtering location searches.
Supported language codes for TripAdvisor Content API.
Valid radius unit types for distance-based filtering.
Text to use for searching based on the name of the 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_CONTENT_API_SEARCH_NEARBY_LOCATIONSTool to search for locations near a specified latitude/longitude. Returns up to 10 locations with optional filtering by category, phone, or address.
Input parameters
Phone number to filter the search results by. Can be in any format with spaces and dashes but without the '+' sign at the beginning
Length of the radius from the provided latitude/longitude pair to filter results
Address to filter the search results by
Latitude/Longitude pair to scope down the search around a specific point. Format: "latitude,longitude" (e.g., "42.3455,-71.10767")
Valid category types for filtering nearby locations.
Supported language codes for TripAdvisor API.
Valid units for the search radius.
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 5 TripAdvisor Content API actions on Nagent, including "Get Location Details", "Get Location Photos (Enhanced)" and "Get Location Reviews". Get Location Details: Get comprehensive information about a location (hotel, restaurant, or attraction) including name, address, rating, and contact details. Each action is listed on this page with its input parameters and its output.
TripAdvisor Content API 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 Details takes 1 required input: location_id. It also takes 2 optional inputs: currency and language. It returns data, error and successful.