JavaScript guide

Use FindIP with JavaScript

Fetch IP geolocation, network traits, and risk intelligence from Node.js or modern server-side JavaScript runtimes.

Endpoint

Authenticated IP lookup

GET https://api.findip.net/{ip}/?token={token}

Server-side firstKeep your token out of browser source whenever possible.

IntelligenceUse intelligence.flags for fast VPN/proxy/Tor decisions.

Response guideView the full response model

Modern JavaScript example

Uses built-in fetch.

const ip = "8.8.8.8";
const token = "YOUR_API_KEY";

const url = new URL(`https://api.findip.net/${ip}/`);
url.searchParams.set("token", token);
url.searchParams.set("returnIp", "true");

const response = await fetch(url, { headers: { "Accept": "application/json" } });
if (!response.ok) {
  throw new Error(`FindIP request failed: ${response.status}`);
}

const data = await response.json();
const intelligence = data.intelligence;

console.log("City:", data.city?.names?.en);
console.log("Country:", data.country?.names?.en);
console.log("Coordinates:", data.location?.latitude, data.location?.longitude);
console.log("ISP:", data.traits?.isp);
console.log("ASN:", data.traits?.autonomous_system_number);

console.log("Verdict:", intelligence.summary.verdict);
console.log("Risk:", intelligence.risk.score, intelligence.risk.level);
console.log("VPN:", intelligence.flags.is_vpn);
console.log("Proxy:", intelligence.flags.is_proxy);
console.log("Tor:", intelligence.flags.is_tor);
console.log("Tags:", intelligence.tags.join(", ") || "none");