Official Node.js/TypeScript client for ipdata.info — a free, fast IP geolocation, ASN, and threat-intelligence API. Look up country, city, ASN, timezone, currency, and security flags (proxy/VPN/Tor/hosting) for any IPv4 or IPv6 address. Powered by ipdata.info.
The public endpoint is free — 50 requests/min, no signup, no key. For higher rate limits and batch lookups, create a free API key at ipdata.info/register and manage it in your dashboard.
npm install ipdatainfo
import { IPDataClient } from "ipdatainfo"; const client = new IPDataClient(); // free tier; or new IPDataClient({ apiKey: "KEY" }) const info = await client.lookup("8.8.8.8"); console.log(info.city, info.country, info.asn_org); // Mountain View United States Google LLC
CommonJS works too: const { IPDataClient } = require("ipdatainfo");
| Method | What it returns |
|---|---|
lookup(ip?) |
Full geolocation record (own IP if omitted) |
geo(ip) |
Geo subset (city/region/country/lat/lon/tz) |
asn(ip) |
ASN + ISP/registry for an IP |
batch(ips) |
Many IPs at once (requires an API key) |
asnDetail(n) |
ASN detail incl. prefixes |
asnWhoisHistory(n) |
ASN whois history |
asnChanges() |
ASN change feed |
threatDomain/Hash/Url(x) |
Threat-intel lookup (domain / file hash / URL) |
new IPDataClient(options?: { apiKey?: string; // sent as X-Api-Key; switches default host to pro.ipdata.info baseUrl?: string; // default: https://ipdata.info (or pro host when apiKey is set) timeout?: number; // request timeout in ms, default 10000 });
Full response schema: ipdata.info API docs · SDK contract.
Non-2xx responses (and transport failures like timeouts) throw IpDataError
with status and message:
import { IPDataClient, IpDataError } from "ipdatainfo"; try { await new IPDataClient().batch(["8.8.8.8"]); // no key -> 403 } catch (err) { if (err instanceof IpDataError) { console.error(err.status, err.message); // 403 batch lookup requires a paid tier API key } }
- Free (
ipdata.info): 50 req/min, no key. - Paid (
pro.ipdata.info): higher limits +batch, with an API key.
12 official SDKs — see the full list at ipdata.info/docs/sdks: Python, Node.js, Go, PHP, Java, Rust, .NET, Kotlin, Swift, Dart, Bash, Objective-C.
MIT © ipdata.info