1m+ IPs mapped and rising

Programmatically convert any IP into GEO location data instantly.

Ip2Geo is a super-lightweight and type-safe library that allows you to convert any IP to geolocation data, 100% free with unlimited uses—no catch. It works exclusively online and can run on both the client and server.

Install via @npm

1 minute walkthrough (old types)

FAQ

Everything you need to know about Ip2Geo.

Is this 100% free?

When we say this is free—even without running locally—they freak out. But yes, for now, we offer 100% unlimited conversions.

How it works?

We convert the IP on our services and collaborate with services that have large databases for geo-location data.

Does it support type safety?

We love types, so we built the library using TypeScript.

Is the conversion fast?

Our converter is blazing fast — we complete all conversions in under 10 ms. Of course, you should also consider users’ internet speed and similar factors.

Can I run it on both the client and the server?

Yes, Ip2Geo is designed to be used in any environment, including both client and server side.

Why is the package lightweight?

Because we host the databases and everything else, you only need to use it online. This way, the package stays lightweight (only 16.4 kB) and easy to use.

Does it support all runtimes?

Yes, it’s compatible with all major TypeScript runtimes including Bun, Node, and Deno.

Can I use other package managers?

Yes, you can install it using popular package managers like bun, npm, yarn, and pnpm.

Will this stay free forever?

No, we plan to introduce paid plans in the future because running the service has costs. We want to grow, make it faster, and offering paid plans is one way to do that. But when we say paid, we mean affordable pricing — about 5 times cheaper than other platforms.