Actions3
- IP Lookup Actions
Overview
This node integrates with the IPstack API to provide IP geolocation data. It supports looking up information for single or multiple IP addresses, as well as retrieving data about the requester’s own IP address. The "Bulk Lookup" operation allows users to query up to 50 IP addresses at once, making it useful for scenarios such as analyzing traffic sources, enriching logs with location data, or performing security assessments on multiple IPs simultaneously.
Practical examples:
- Enriching a list of visitor IPs with geographic and security details.
- Performing batch lookups for threat intelligence on multiple suspicious IP addresses.
- Automatically tagging incoming requests with location metadata in workflows.
Properties
| Name | Meaning |
|---|---|
| IP Addresses | Comma-separated list of IP addresses (maximum 50) to perform bulk lookup on. |
| Additional Fields | Optional settings to customize the API response: |
| - Fields | Comma-separated list of specific fields to return from the API (per IPstack documentation). |
| - Language | Language code for the API response. Options: Chinese, English, French, German, Japanese, Portuguese (Brazil), Russian, Spanish. Default is English. |
| - Enable Hostname Lookup | Boolean flag to include hostname information in the response. |
| - Enable Security Module | Boolean flag to include security threat information in the response. |
Output
The node outputs an array of JSON objects, each corresponding to one IP address queried. Each JSON object contains the geolocation and optionally hostname and security data returned by the IPstack API for that IP.
If the API returns an error for any IP, the output for that item will contain an error field describing the issue.
No binary data is produced by this node.
Dependencies
- Requires an API key credential for the IPstack service.
- The node uses either HTTP or HTTPS based on the credential configuration.
- No additional environment variables are needed beyond the API key setup.
Troubleshooting
- Maximum IPs exceeded: The node enforces a maximum of 50 IP addresses per bulk request. Exceeding this limit will throw an error. To resolve, reduce the number of IPs per execution.
- API errors: If the IPstack API returns an error (e.g., invalid API key, quota exceeded), the node throws an error with details from the API response. Check your API key validity and usage limits.
- Empty or malformed IP list: Ensure the IP addresses input is a properly formatted comma-separated string without extra spaces or empty entries.
- Network issues: Connectivity problems to the IPstack API endpoint can cause failures. Verify network access and proxy settings if applicable.