APIFreaks n8n Integration

Use the full APIFreaks API hub directly inside your n8n workflows — no code, no manual HTTP requests. A single verified node exposes 113 operations across 22 categories, so you can enrich, validate, convert, and automate with APIFreaks data using clear point‑and‑click actions.

With this integration you can automate:

• IP intelligence — geolocation and threat/security lookups (single & bulk)
• Domain & DNS — WHOIS (domain / IP / ASN), DNS records, availability, subdomains, SSL
• Geo data — forward/reverse geocoding, countries, regions, cities, ZIP/postal codes
• Finance — currency & commodity rates, conversions, VAT/IBAN/SWIFT validation
• Weather & environment — current, forecast, historical, marine, air quality, flood, astronomy
• Utilities — timezone lookup & conversion, user‑agent parsing, PDF tools, screenshots, web scraping, OCR, email & phone validation

This node ships two API versions side by side — the original v1.0 operations plus newer v2.0 operations for IP geolocation, timezone, astronomy, and domain WHOIS. See Choosing between v1.0 and v2.0.

Table of contents

• Installation
  • Install from the n8n editor (verified)
  • Install via Community Nodes
  • Manual / self‑hosted install
• API key & connection setup
• Using the node in a workflow
• Choosing between v1.0 and v2.0
• Using the node with AI Agents
• Module reference
• Example workflows
• Troubleshooting
• Support
• License

Installation

You only need to install the node once. Pick the method that matches how you run n8n.

Install from the n8n editor (verified)

Once the node is verified by n8n, this is the easiest path and works on both n8n Cloud and self‑hosted:

1. Open your n8n instance and open (or create) a workflow.
2. Click the + (Add node) button to open the nodes panel.
3. Type APIFreaks in the search bar.
4. Select the APIFreaks node from the results — n8n installs and enables it automatically.
5. That's it. The node is ready to use.

Verification status: if APIFreaks doesn't appear in editor search yet, the node is still pending n8n verification. In the meantime, use Community Nodes on a self‑hosted instance.

Install via Community Nodes

For self‑hosted n8n (v0.187+), an instance owner can install the published npm package:

1. Go to Settings → Community Nodes.
2. Click Install.
3. In npm package name, enter:

   n8n-nodes-apifreaks

4. Tick I understand the risks of installing unverified code from a public source.
5. Click Install.

The APIFreaks node will appear in the nodes panel after installation.

Community Nodes are not available on n8n Cloud — Cloud users must use the verified editor install above.

Manual / self‑hosted install

Useful for local development or air‑gapped setups.

# 1. Start n8n once so the ~/.n8n folder exists, then stop it
npx n8n

# 2. Go to the n8n config directory and create a custom-nodes folder
cd ~/.n8n
mkdir -p custom
cd custom

# 3. Initialise a package and install the node
npm init -y
npm install n8n-nodes-apifreaks@latest

# 4. Restart n8n — it auto-loads everything in ~/.n8n/custom
npx n8n

On restart, n8n loads the APIFreaks node from ~/.n8n/custom.

Docker: mount a custom folder into the container and set N8N_COMMUNITY_PACKAGES_ENABLED=true. To use the node inside AI Agents as a tool, also set N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true.

API key & connection setup

The node authenticates with a single APIFreaks API key (sent automatically as the X-apiKey header on every request).

1. Get your API key

• Sign up for free or log in.
• Open your dashboard and copy your key from API Keys. (You can reset it there anytime if it's compromised.)

2. Create the credential in n8n

• Add an APIFreaks node to a workflow (or go to Credentials → New).
• Choose APIFreaks API as the credential type.
• Paste your API key into the API Key field.
• Click Save.

3. Test the connection

• n8n runs a small test lookup automatically. A green check means you're connected.
• If it fails, confirm the key is active and valid for your plan, then save again.

Once saved, the same credential works for every APIFreaks operation in all your workflows.

Using the node in a workflow

1. Add the APIFreaks node to your canvas.
2. Select a Resource (e.g. IP Geolocation, WHOIS, Weather).
3. Select an Operation (e.g. IP geolocation lookup, Domain WHOIS lookup).
4. Fill in the required fields shown for that operation. Optional parameters live under Additional Fields.
5. Connect an input and click Execute (or run the workflow).

The node returns one output item per result, so you can chain it straight into filters, spreadsheets, databases, or messaging nodes. It supports Continue On Fail, and works with n8n expressions so you can feed values from earlier nodes (e.g. an IP column from a Google Sheet).

Choosing between v1.0 and v2.0

Some capabilities are available in two versions. Both are live; they take the same inputs but return different response formats:

| Capability | v1.0 operation | v2.0 operation | | --- | --- | --- | | IP geolocation (single) | Get Geolocation Lookup | IP geolocation lookup (v2.0) | | IP geolocation (bulk) | Bulk IP Lookup | Bulk IP geolocation lookup (v2.0) | | Timezone | Get Timezone | Timezone lookup (v2.0) | | Astronomy | Get Geolocation Astronomy | Astronomy lookup (v2.0) | | Domain WHOIS (single) | Retrieve the WHOIS Data for any domain | Domain WHOIS lookup (v2.0) | | Domain WHOIS (bulk) | Retrieve WHOIS data of multiple domains… | Bulk domain WHOIS lookup (v2.0) |

Which should I use?

• New workflows → pick the (v2.0) operations. They return the newer normalized response structure.
• Existing workflows → the v1.0 operations are unchanged, so nothing breaks. Migrate to v2.0 when you're ready to update how you read the response.

Both versions appear together under the same resource in the operation dropdown, so they're easy to find side by side.

Using the node with AI Agents

The APIFreaks node is exposed as a tool (usableAsTool), so an n8n AI Agent can call any operation on its own — for example, "look up the WHOIS for this domain" or "get the threat score for this IP."

On self‑hosted instances, enable tool usage for community nodes before it appears in the Agent's tool list:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

Restart n8n, then add the APIFreaks node as a tool on your AI Agent node.

Module reference

All operations are grouped by Resource. Required inputs vary by operation and are shown in the node UI; optional parameters appear under Additional Fields. Full field‑level details for every endpoint live in the APIFreaks API docs and Swagger reference.

| Resource | # ops | Highlights | | --- | ---: | --- | | IP Geolocation | 6 | IP geolocation & security lookups, single + bulk (v1.0 & v2.0) | | WHOIS | 8 | Domain / IP / ASN WHOIS, history, reverse, bulk (v1.0 & v2.0) | | DNS | 4 | Live, historical, reverse, and bulk DNS lookups | | Domain | 4 | Availability, bulk availability, suggestions, subdomains | | SSL | 2 | Certificate & certificate‑chain lookups | | Geocoding | 2 | Forward (address → coords) & reverse geocoding | | GeoDB | 10 | Countries, regions, subregions, admin units, cities, flags | | ZIP Code | 7 | Lookup, search by city/region/radius, distance & matching | | Currency | 10 | Latest/historical rates, conversion, time series, fluctuation | | Commodity | 5 | Latest/historical prices, time series, fluctuation, symbols | | Financial | 8 | VAT rates & validation, IBAN validation, SWIFT lookup/finder | | Weather | 8 | Current, forecast, historical, marine, air quality, flood | | Timezone | 3 | Timezone lookup (v1.0 & v2.0) and time conversion | | Astronomy (Other) | 2 | Sun/moon data (v1.0 & v2.0) | | User Agent | 2 | Parse single & bulk user‑agent strings | | Email Validation | 2 | Single & bulk email validation | | Phone Validation | 2 | Single & bulk phone validation | | PDF | 23 | Merge, split, rotate, compress, convert, encrypt, upload/download… | | Screenshot | 2 | Single & bulk website screenshots | | Web Scraping | 1 | Scrape pages with custom instructions | | OCR | 1 | Extract text from images, PDFs, or ZIP archives | | General | 1 | Check your API credit usage |

IP Geolocation — Get Geolocation Lookup · IP geolocation lookup (v2.0) · Bulk IP Lookup · Bulk IP geolocation lookup (v2.0) · Retrieve security information for an IP address · Bulk IP Security Lookup

WHOIS — Retrieve the WHOIS Data for any domain · Domain WHOIS lookup (v2.0) · Retrieve WHOIS data of multiple domains in a single request · Bulk domain WHOIS lookup (v2.0) · Access the WHOIS Data for any IP · ASN WHOIS Live · Domain WHOIS history · Reverse domain WHOIS

DNS — DNS Lookup · Bulk DNS Lookup · DNS History Lookup · Reverse DNS Lookup

Domain — Check whether a domain is available · Check availability of multiple domains · Domain availability suggestions · Subdomains lookup

SSL — SSL Certificate Lookup · SSL Certificate Chain Lookup

Geocoding — Forward geocoding (address → coordinates) · Reverse geocoding (coordinates → address)

GeoDB — List of countries · Country details · Regions · Subregions by region · Administrative units for a country · Administrative units by country · Admin unit details · Cities by country & admin unit · Supported flags · Flag for country

ZIP Code — Lookup ZIP/postal codes · Bulk lookup ZIP/postal codes · Search by city · Search by region · Find within a radius · Distance between codes · Matching pairs within a distance

Currency — Latest exchange rates · Historical exchange rates · Convert with latest rates · Convert with historical rates · Convert by IP geolocation · Time series · Fluctuations · Supported currencies · Currency symbols · Historical data limits

Commodity — Latest prices · Historical prices · Time series · Fluctuations · Supported symbols

Financial — VAT rate by country · VAT rate by IP · Bulk VAT by country · Supported VAT countries · Validate EU/UK VAT number · Validate IBAN · Find SWIFT codes · Lookup SWIFT code details

Weather — Current (GET & POST) · Forecast · Historical · Time series · Marine · Air quality · Flood

Timezone — Get Timezone · Timezone lookup (v2.0) · Convert Timezone

Astronomy (under the “Other” resource) — Get Geolocation Astronomy · Astronomy lookup (v2.0)

User Agent — Parse user‑agent (single) · Parse user‑agents (bulk)

Email Validation — Validate a single email · Validate multiple emails

Phone Validation — Validate a single phone number · Bulk validate phone numbers

PDF — Merge · Split · Extract pages · Remove pages · Rotate · Compress · Linearize · Encrypt · Decrypt · Restrict · Unrestrict · Convert to PNG/JPG/TIFF/BMP/GIF · Upload · Upload (binary) · Download resource · Task status · File status · List files · Delete file

Screenshot — Website screenshot · Bulk screenshots

Web Scraping — Perform web scraping with custom instructions

OCR — Extract text from images, PDFs, or ZIP archives

General — Get credits usage information

Example workflows

1. Fraud & network vetting on new orders IP Geolocation (security) → check proxy/VPN and threat score → WHOIS (IP) for network owner → Filter: only proceed if not a proxy → tag risky orders for review.

2. Localized send times IP geolocation lookup (v2.0) → get country → Timezone lookup (v2.0) → Convert Timezone → send the email/notification at the recipient's local time.

3. Bulk domain due‑diligence Read a domain list from a spreadsheet → Aggregate into an array → Bulk domain WHOIS lookup (v2.0) → write registrar, creation/expiry dates, and status back to the sheet.

4. Weather‑aware automation Geocoding (forward) → coordinates → Weather (forecast) + Astronomy lookup (v2.0) → trigger downstream actions around sunrise/sunset or forecast conditions.

Troubleshooting

• Node doesn't show in editor search — it's likely not yet verified; install via Community Nodes (self‑hosted).
• 401 / authentication errors — re‑check the API key in the credential; make sure it's active in your dashboard.
• 403 / plan errors — the operation may not be included in your current plan; see pricing.
• Node not available as an AI Agent tool — set N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true and restart n8n.
• Credit usage — use General → Get credits usage information to monitor consumption.

Support

• API documentation: https://apifreaks.com/docs
• Swagger reference: https://apifreaks.com/api/swagger
• Email: [email protected]
• Bugs & feature requests: open an issue in this repository.

License

MIT © APIFreaks