Skip to content
Nappai Documentation

Locations Details

The Locations Details component lets you pull information from TripAdvisor about a place you’re interested in.
You can ask for the place’s basic details, its customer reviews, or the photos people have uploaded.
All you need is the place’s TripAdvisor ID and a valid TripAdvisor API key.

How it Works

When you drop this component into your workflow, it talks to TripAdvisor’s public API.
First, it reads the data you feed into the Input field. That data should contain a location_id key with the TripAdvisor ID of the place you want to look up.
Next, you choose which type of information you want in the Api Selection dropdown:

  • Location details – basic info such as name, address, and rating.
  • Location reviews – all the reviews written for that place.
  • location photos – the photos that visitors have shared.

The component then sends a request to TripAdvisor, receives the JSON response, and attaches it to the original data under a new key (details, reviews, or photos). The enriched data is returned as a Data output that you can feed into other components.

Inputs

Credential
Before you can use this component, you must set up a TripAdvisor API credential in Nappai’s credential manager.

  1. Go to Settings → Credentials and add a new TripAdvisor API credential.
  2. Enter your API key (you can get one at https://www.tripadvisor.com/developers?screen=credentials).
  3. In the component, select that credential from the Credential dropdown.

Input Fields

  • Input: The data you want to enrich. It should be a JSON object that includes a location_id field.
  • Api Selection: Choose which TripAdvisor API call to make – “Location details”, “Location reviews”, or “location photos”.
  • Default Currency: Pick the currency you want monetary values displayed in (e.g., EUR, USD).
  • Default Language: Pick the language for the returned text (e.g., en, es, fr).

Outputs

  • Data: The original input data with an added key containing the TripAdvisor information you requested.
    • If you chose Location details, the new key is details.
    • If you chose Location reviews, the new key is reviews.
    • If you chose location photos, the new key is photos.

You can use this output to feed into tables, charts, or other components that display or analyze the data.

Usage Example

  1. Set up the credential as described above.
  2. Drag the Locations Details component onto the canvas.
  3. In the Credential field, pick the TripAdvisor credential you created.
  4. Set Api Selection to Location reviews.
  5. In Input, provide a JSON object such as: 
    {
      "location_id": "123456"
    }
  6. Connect the Data output to a Table component to display the reviews.

When you run the workflow, the component will fetch all reviews for the place with ID 123456 and show them in the table.

  • TripAdvisor Search – Find a TripAdvisor ID by searching for a place name.
  • TripAdvisor Photo Gallery – Display photos from a TripAdvisor location.

Tips and Best Practices

  • Keep the API key secret: Never expose the key in public code or shared dashboards.
  • Validate the location_id before sending the request to avoid errors.
  • Use the default language that matches your audience to improve readability.
  • Cache results if you’ll request the same location multiple times to reduce API calls.

Security Considerations

The component uses your TripAdvisor API key to authenticate requests.
Store the key in Nappai’s credential manager, not in the workflow itself.
Ensure that only authorized users have access to the credential and the component.