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 network administrators, security analysts, or developers who need to enrich data with IP-related metadata, perform geolocation lookups, or identify organizational ownership of IPs.

Practical examples include:

• Enriching logs with geographic location or organization info based on IP addresses.
• Validating user IPs by checking their general or protocol-specific details.
• Automating workflows that require IP-based decision making, such as access control or fraud detection.

Properties

The IP Address property is shown only for these operations:

• Get Lookup IP (General)
• Get IPv4
• 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 name executed.
• A key representing the type of data returned, which varies by operation:
  • For general or IP info operations, the key is "ipinfo" containing the full JSON response from the API.
  • For organization lookup, the key is "organization" with plaintext organization info.
  • For city lookup, the key is "city" with plaintext city info.
  • For country lookup, the key is "country" with plaintext country code.

If an error occurs and the node is configured to continue on failure, the output JSON will contain an error field with the error message instead of the expected data.

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 API endpoints depending on the operation.
• No additional environment variables are required beyond the API credential configuration.

Troubleshooting

• Common issues:

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

• Error messages:

  • "Unknown operation: <operation>": Indicates an unsupported operation was requested; verify the operation parameter.
  • API errors returned from IPinfo (e.g., rate limiting, unauthorized) will be passed through unless "continue on fail" is disabled, in which case the node execution stops with an error.

• Resolutions:

  • Ensure the API token is correctly set up and has sufficient permissions.
  • Validate IP address inputs before running the node.
  • Check network connectivity and firewall settings if requests fail.

Links and References

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