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:

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.

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: support@apifreaks.com
• Bugs & feature requests: open an issue in this repository.

License

MIT © APIFreaks