IP Geolocation n8n Integration
Overview
The n8n+IPGeolocation integration makes it simple to use the full IPGeolocation.io APIs inside your n8n automation workflows. You do not need to write code or handle API requests because everything can be automated through clear and simple actions.
With this integration, you can quickly get helpful information about any IP address. This includes location details, network ownership, security risk information, user agent data, time zone details, and even basic astronomy information. You can use this data to improve your workflows, personalize user experiences, and make your automation more secure.
It allows you to automate retrieval of:
- Geolocation information for any IP address
- Threat intelligence and security risk details
- Network ownership and ASN information
- Time zone data and time conversion tools
- Astronomy information such as sunrise and sunset
- User agent details including browser, operating system, and device type
IPGeolocation Node Installation Guide
1.Community Nodes (Recommended)
For users on n8n v0.187+, your instance owner can install this node from Community Nodes.
- Go to Settings > Community Nodes.
- Select Install.
- Enter
n8n-nodes-ipgeolocationin Enter npm package name. - Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
- Select Install.
2.Manual Installation
It explains how to install and use the official
n8n-nodes-ipgeolocation package, developed and maintained by
IPGeolocation.io.Follow the steps below to integrate our IP Geolocation capabilities
directly into your n8n workflows.
a.Start n8n Once (to generate the .n8n folder)
After it opens, close it. This ensures the .n8n directory is
generated.
b.Navigate to the n8n configuration directory
c.Create a directory for custom nodes
d.Initialize npm inside the custom folder
e.Install the official IPGeolocation.io n8n node
This npm package is the official IPGeolocation.io integration for n8n, enabling powerful IP lookup, timezone, geolocation, and security data directly inside your workflows.
f.Restart n8n
After the installation, restart your n8n instance using:
n8n will automatically load all custom nodes located in the
.n8n/custom folder, including the IPGeolocation.io node.
g.You're Ready to Go!
You can now use the IPGeolocation.io node inside n8n to:
- Retrieve IP Geolocation data
- Detect timezone information
- Perform IP Security checks
- Enrich workflows with location-based intelligence
API Key & Connection Setup
To use IPGeolocation.io with n8n, you need a valid API Key. Follow these steps carefully:
1.Create or log in to your IPGeolocation.io account
- Go to IPGeolocation.io.
- If you don’t have an account, click Sign Up and complete the registration.
- If you already have an account, click Sign in and enter your credentials.
2.Obtain your API Key
- After logging in, go to your dashboard.
- Copy your API Key — you’ll need it to connect Make with IPGeolocation.io.
3.Open n8n and create a scenario
- Go to n8n instance and log in or sign up.
- Click + from your sidebar and create a new workflow from scratch.
- You will see a canvas where you can add nodes.
4.Add an IPGeolocation node
- Make sure you have the IPGeolocation.io node installed.
- Click the + button to add a node.
- Search for IPGeolocation in the nodes search bar.
5.Set up the connection
- Paste the API Key you copied earlier into the required field.
- Click Save to authenticate the connection.
6.Test the connection
- n8n will attempt to connect using your API Key.
- If successful, the module will show a green checkmark and confirmation.
- If there’s an error, double-check your API Key and make sure it’s active and valid for the plan you’re using.
7.Use your connection
- Once connected, this API Key is available for all IPGeolocation modules in your n8n workflows.
- You can now use it to perform actions like Get IP Geolocation, Parse User Agent, or Bulk IP Geolocation, depending on your API plan.
Actions Availability across our Plans
We offer four API plans: Developer, Standard, Security, and Advanced.
The availability of actions depends on the plan you are subscribed to. The following table provides a detailed overview of which actions are included in each plan, helping you quickly identify the plan that suits your needs.
| Action | Developer | Standard | Security | Advance |
|---|---|---|---|---|
| Get IP Geolocation |  | |  | |
| Get Bulk IP Geolocation | | | | |
| Get IP Security | | | | |
| Get Bulk IP Security | | | | |
| Get ASN Info | | | | |
| Get Abuse Contact Info | | | | |
| Get Astronomy Info | | | | |
| Get Astronomy Timeseries Information | | | | |
| Get Timezone Info | | | | |
| Get Time Conversion | | | | |
| Get User Agent Info | | | | |
| Get Bulk User Agents Info | | | | |
If you attempt to use Security-related actions (for example, IP Security Lookup) with an API key from the Standard plan, the request will fail because these actions are exclusive to the Security plan. The API will return an error message indicating unauthorized access.
For full pricing details and to choose your plan, see the pricing page.
Modules
Below is a structured reference of all modules in this integration.
1.Geolocation
a.Get IP Geolocation
Retrieves full geolocation data of a single IPv4/IPv6.
- Input: IP Address
- Outputs: country_name, city, latitude, longitude and many more
b.Get Bulk IP Geolocation
Retrieves geolocation for up to 50,000 IPs per request.
- Input: Array of IPs
- Outputs: Collection of geolocation objects
2.Security
a.IP Security Lookup
Security insights such as proxy, VPN, TOR, threat score, cloud and proxy providers.
- Input: IP Address
- Outputs: security.is_proxy, security.is_vpn, security.threat_score, security.is_cloud_provider and more
b.Bulk IP Security Lookup
Security assessment for multiple IPs.
- Input: Array of IPs
- Outputs: Collection of security data
3.Network Intelligence
a.Lookup ASN
Provides a simple way to retrieve accurate information about an Autonomous System Number (ASN) and its associated IPv4 and IPv6 address ranges.
- Input: IP or ASN number
- Outputs: asn.as_number, asn.organization and more
b.Lookup Abuse Contact Information
Includes details such as the role, handle, organization name, kind (e.g., group or individual), and postal address. This information helps identify the entity responsible for handling abuse reports.
- Input: IP Address
- Outputs: abuse.emails, abuse.handle and more
4.Time Services
Free Timezone API and Time conversion API provides date and time related information such as current time, date in various formats, week, month, year, time in unix timestamp, UTC/GMT offset and day light saving time from timezone name, any IPv4 or IPv6 address or geolocation coordinates, IATA code, ICAO code, or UN/LOCODE.
a.Get Timezone Info
It can be consumed with the following input variations:
- For a Time Zone Name
- For any Address (preferrably, city address)
- For Location Coordinates (latitude & longitude)
- For any IP address
- For any IATA code
- For any ICAO code
- For any UN/LO Code
- Outputs: time_zone.name, time_zone.current_time, time_zone.date_time_wti and more
b.Time Conversion
Converts a time from one of following options
- Convert Time using Time Zone Names
- Convert Time using Location
- Convert Time using Coordinates
- Convert Time using IATA codes
- Convert Time using ICAO codes
- Convert Time using UN/LOCODEs
Output: Converted date/time
5.Astronomy
Provides timings for sunrise, sunset, moonrise, moonset, sun azimuth, moon azimuth, sun altitude, moon altitude, sun distance from the earth and moon distance from the earth.
a.Get Astronomy Details
- Outputs: astronomy.sunrise, astronomy.sunset, astronomy.moon_phase and many more.
b.Astronomy Time Series Lookup
- Outputs: Daily astronomy data for a defined date range.
6.User-Agent Parsing
Provides detailed client system information, allowing for the detection of bots, crawlers, and potential attackers.
a.Parse User Agent String
- Input: User agent string
- Outputs: provides name, device and operating sysem information.
b.Parse Bulk User Agent Strings
- Input: Array of User agent strings
- Outputs: Collection of parsed user agent objects
Use Cases
Some of the use cases are provided as following.
1.E‑commerce Fraud & Network Vetting
Modules: IP Security Lookup, Lookup Abuse, Lookup ASN
Scenario: Validate order IPs before processing.
- Trigger: Shopify/WooCommerce detects new order.
- Step 1: Security Lookup: Check proxy/VPN.
- Step 2: ASN Lookup: Find ISP & organization.
- Filter: Only proceed if not proxy AND not cloud provider.
- If high-risk: Tag the order “Fraud Review”
2.Personalized Content & Time‑Aware Scheduling
Modules: Get IP Geolocation, Get Timezone Info, Time Conversion
Scenario: Send newsletter at 10 AM local time.
- Step 1: Geolocation: Get currency + country.
- Step 2: Timezone Info: Get exact timezone.
- Step 3: Time Conversion: Convert 10 AM UTC to local.
- Step 4: Email tool: Send at converted time.
3.Bulk Data Enrichment & Reporting
Modules: Bulk Geolocation, Bulk Security Lookup, Array Aggregator, Iterator
Scenario: Enrich 5,000+ IPs with location + threat scoring.
- Fetch rows from Google Sheets.
- Aggregate IPs into an array.
- Bulk lookup for location and security.
- Iterate results.
- Update rows with new fields: city, country_name, threat_score.
4.Astronomy‑Based IoT Scheduling
Modules: Astronomy Details, Astronomy Time Series
Scenario: Automate IoT actions based on sunrise, sunset, moon phase.
- Daily schedule at midnight.
- Astronomy Details: Get sunrise & moon phase.
- Save results in Data Store/Airtable.
- IoT app triggers actions after sunrise.
