IPinfo LiteInstall

Overview

This node integrates with the IPinfo Lite API to provide detailed information about IP addresses. It supports various operations such as retrieving general info, IPv4 or IPv6 details, and specific data like organization, city, or country associated with an IP address. This node is useful for scenarios like enriching datasets with geolocation or organizational data, performing security checks, or customizing content based on user location.

For example, you can use it to:

• Lookup the country of a visitor's IP to tailor website content.
• Retrieve the organization name behind an IP for network analysis.
• Get detailed JSON info about an IP for threat intelligence.

Properties

The node also has an Operation property (not listed here) that determines which type of IP information to retrieve, including options like:

• Get Self IP (General)
• Get Lookup IP (General)
• Get Self IPv4
• Get IPv4
• Get Self IPv6
• Get Lookup IPv6
• Base - JSON Info (Lookup)
• Base - Organization (Lookup)
• Base - City (Lookup)
• Base - Country (Lookup)

Output

The output is an array of JSON objects, each containing two fields:

• operation: The operation performed (e.g., "baseCountryLookup").
• A key corresponding to the data type requested, holding the response from the IPinfo API:
  • For general or JSON lookups, this is "ipinfo".
  • For organization lookup, "organization".
  • For city lookup, "city".
  • For country lookup, "country".

Example output snippet for a country lookup:

{
  "json": {
    "country": "US",
    "operation": "baseCountryLookup"
  }
}

No binary data is output by this node.

Dependencies

• Requires an API authentication token credential for the IPinfo service.
• The node makes HTTP GET requests to various IPinfo endpoints depending on the operation.
• No additional environment variables are required beyond the API credential.

Troubleshooting

• Common issues:

  • Invalid or missing API authentication token will cause request failures.
  • Providing an invalid IP address format may result in errors or empty responses.
  • Network connectivity issues can prevent successful API calls.

• Error messages:

  • "Unknown operation: <operation>" indicates an unsupported operation was selected.
  • HTTP errors from the IPinfo API will be returned as error messages in the output if "Continue On Fail" is enabled; otherwise, they will throw exceptions stopping execution.

• Resolutions:

  • Ensure a valid API key is configured in the node credentials.
  • Validate IP address inputs before running the node.
  • Check network access to the IPinfo API endpoints.

Links and References

• IPinfo API Documentation
• n8n Documentation on HTTP Request Node (for understanding HTTP request handling)