Overview

This node performs a geolocation lookup for a given IP address, optionally using a user agent string for additional context. It queries the Bento API to retrieve location details associated with the IP address, which can be useful for understanding the geographic origin of web traffic, enhancing security measures, or personalizing user experiences based on location.

Use Case Examples

1. Look up the geographic location of a visitor's IP address to customize website content.
2. Identify the country or city of an IP address for fraud detection or compliance purposes.

Properties

Output

JSON

• operation - The operation performed, here it will be 'geolocationLookup'.
• success - Boolean indicating if the lookup was successful.
• ip - The IP address that was looked up.
• userAgent - The user agent string provided, if any.
• apiResponse - The full response from the Bento API containing geolocation data.
• location - The location details extracted from the API response, such as city, region, country, etc.
• message - A message describing the result of the geolocation lookup.

Dependencies

• Requires Bento API credentials including a publishable key, secret key, and site UUID for authentication.

Troubleshooting

• Ensure the IP address is provided and correctly formatted; missing or invalid IP will cause errors.
• Check that Bento API credentials are correctly configured and valid to avoid authentication failures.
• Network issues or Bento API downtime can cause request failures; verify network connectivity and Bento service status.
• If the API response is unexpected or empty, verify the IP address and user agent inputs for correctness.