View as Markdown
WhoisFreaks icon

WhoisFreaks ACTION

IP Geolocation Lookup

Retrieve geolocation details (country, city, region, ASN, ISP, coordinates) for a single IP address. Supports both IPv4 and IPv6 addresses. Use this action to enrich events with location data, perform fraud detection, or geo-target users. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's WhoisFreaks account once, then configure and run IP Geolocation Lookup from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "whoisfreaks-ip-geolocation-lookup",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    whoisfreaks: { authProvisionId: "apn_xxxxxxx" },
    ip: "IP Address",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

IP Geolocation Lookup inputs
Property Type Description
ip IP Address string
The IP address to look up. Must be a valid IPv4 (e.g. 8.8.8.8) or IPv6 (e.g. 2001:4860:4860::8888) address.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
whoisfreaks-ip-geolocation-lookup
Version
0.0.2
App
WhoisFreaks
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes