Skip to content
Nappai Documentation

TripAdvisor Api Toolkit

The TripAdvisor Api Toolkit is a ready‑to‑use set of tools that connects your Nappai workflow to the TripAdvisor Content API.
With it you can pull information about places, hotels, restaurants, attractions, reviews, and photos directly into your automation processes.

How it Works

When you add the component to your dashboard, it creates a connection to the TripAdvisor API using the API key you provide in the Credential field.
You can choose which specific tools you want to enable (e.g., Hotel Search, Review tools).
The component then builds a BaseToolkit that contains only the selected tools.
Each tool knows how to call the TripAdvisor API with the default currency and language you set, so the data it returns is already formatted for your region and language.

Inputs

  • Default Currency: Select the default currency for the API.
  • Default Language: Select the default language for the API.
  • Selected Tools: Choose which TripAdvisor tools you want to include in the toolkit (Location Details, Attractions Search, Hotel Search, Restaurant Search, Geo Search, Review tools, Photos tools).

Credential
This component requires a TripAdvisor API credential.

  1. Go to the Credentials section of Nappai and add a new credential of type TripAdvisor API.
  2. Enter your TripAdvisor API Key (you can obtain it from https://www.tripadvisor.com/developers?screen=credentials).
  3. In the component, select the credential you just created from the Credential dropdown.

Outputs

  • BaseToolkit: A BaseToolkit object that contains the tools you selected.
    Use this output to feed into other components that can execute the tools, such as a Tool Executor or a Chatbot that can ask the user for a location and then retrieve the relevant data.

Usage Example

  1. Add the TripAdvisor Api Toolkit to your workflow.
  2. In the Credential field, choose the TripAdvisor API credential you created.
  3. Set Default Currency to USD and Default Language to en.
  4. In Selected Tools, tick Hotel Search and Review tools.
  5. Connect the BaseToolkit output to a Tool Executor component.
  6. In the executor, ask the user for a city name, then run the Hotel Search tool to get a list of hotels and the Review tools to fetch recent reviews.
  7. The results can be displayed in a dashboard card or sent to another system.
  • TripAdvisor Location Details Tool – Retrieves detailed information about a specific location.
  • TripAdvisor Hotel Search Tool – Finds hotels in a given area.
  • TripAdvisor Restaurant Search Tool – Finds restaurants in a given area.
  • TripAdvisor Attractions Search Tool – Finds attractions in a given area.
  • TripAdvisor Geo Search Tool – Searches for places by geographic coordinates.
  • TripAdvisor Reviews Tool – Retrieves reviews for a place.
  • TripAdvisor Photos Tool – Retrieves photos for a place.

Tips and Best Practices

  • Choose only the tools you need – Each tool adds a small cost to your API usage.
  • Set the correct currency – The API will return prices in the currency you specify.
  • Use the language that matches your audience – This ensures that names, descriptions, and reviews are returned in the language you expect.
  • Keep your credential secure – Never expose the API key in public workflows or share the credential with untrusted users.
  • Test with a small dataset first – Verify that the tools return the expected data before scaling up.

Security Considerations

  • The API key is stored in a credential, not in the component’s inputs, so it is protected by Nappai’s credential management.
  • Make sure only authorized users have access to the credential.
  • If you suspect the key has been compromised, revoke it in the TripAdvisor developer portal and create a new one.