Records go stale
Blocks of addresses are sold and moved between networks. The record follows later, or not at all.
Product · IP location
{ "id": "geo_9f4a21c8e1104b20", "ip": "140.82.112.4", "confidence": "high", "radius_km": 118, "point": null, "country": "US", "city": "Ashburn", "target_class": "datacenter", "asn": 36459, "as_name": "GitHub, Inc.", "method": "cbg_icmp", "vps_used": 4, "probes": [ { "country": "US", "asn": 7922, "rtt_ms": 6.84, "exclusion_radius_km": 809.0 }, { "country": "DE", "asn": 24940, "rtt_ms": 79.12, "exclusion_radius_km": 8037.0 } ], "credits_charged": 6}Nodes in known places time the replies from an IP address. Nothing travels faster than light, so each reply limits how far away the address can be. You get the area where it can be, with a confidence, and a verdict on the country it claims.
Why
IP location databases are built from records. Records go out of date, and a tunnel or a proxy can sit anywhere.
Blocks of addresses are sold and moved between networks. The record follows later, or not at all.
A hosting region, a VPN exit or a signup form can name any country. A record cannot check the claim.
A lookup gives you one place and no reason to believe it. You cannot tell a good record from a bad one.
How it works
Look an address up in the Console's Playground, or with one API call.
Give an IP address and, if you like, the country or the city it claims to be in.
Nodes in known places time its replies. Nothing travels faster than light, so each time sets a limit on how far away the address can be.
Where all the limits overlap is where the address can be: an area with a confidence, and a verdict on the claim.
What you get
No feature is held back for a larger plan. A package is its credits and nothing else.
The answer is a region with a radius in kilometres. Hopbits does not pretend to know a street.
High, medium or low, by how tightly the measurements close in. An address that answers nothing gets no location at all.
Name a country, or a city with a distance. The answer says whether the measurements agree with it, rule it out, or cannot tell.
Each answer lists the measurements it rests on: from which country and kind of network, how long the reply took, and how far that allows.
The measured area stands next to what an IP database says, so a record that has gone stale stands out.
The operator of the address, and whether it is a home, mobile, satellite or datacenter line.
An address announced from many places at once has no single location. The answer says so.
Both kinds of address are measured in the same way.
An answer measured in the last seven days costs five credits. A fresh measurement costs five to sixty.
In practice
Four situations teams bring to it.
A signup comes from an address whose record says one country, and the rest of the account says another.
Name the country it claims. If a node far from that country gets a reply sooner than light could make the trip, the claim is ruled out.
You keep or buy IP location data, and need to know which records to trust.
Each answer puts the measured area beside the record. Where the record lies outside the area, it has gone stale.
You pay for a server or an exit in a certain country, for speed or for the law.
Before you rely on it, measure where the machine can physically be.
A connection behaves oddly, and you want to know what you are talking to.
The answer names the operator of the address and says whether it is a home, mobile or datacenter line, or one address announced from many places.
Tools
Try an address in the Console's Playground first. The same lookup is one call to the REST API, and its answer can be read again later.
POST https://api.hopbits.io/v1/geolocate{ "target": "203.0.113.42", "mode": "fresh", "claim": { "country": "US" }}200 OK{ "ip": "203.0.113.42", "confidence": "high", "radius_km": 118, "country": "DE", "city": "Frankfurt am Main", "target_class": "datacenter", "method": "cbg_icmp", "vps_used": 4, "claim_check": { "verdict": "implausible" }, "credits_charged": 6}Cost
Every account gets 1,000 free credits a day. That covers at least 16 fresh measurements a day, or 200 saved answers. More credits come by the month or as a one-time top-up.
The packages
Questions
More in the docsHow IP location works
Other productsUptime monitoringNetwork tests
It gives an area, not a point. How small the area is depends on how near the closest nodes are to the address. Every answer carries its radius and a confidence, so you can see how much it knows.
A reply can be held back, never hurried. So an address can look farther away than it is, but not closer: a place the measurements rule out stays ruled out.
Then there is nothing to measure. You get an answer without a location, and it costs nothing.
From DB-IP, a public IP location database. It is shown beside the measurement and named in every answer.
An answer measured in the last seven days costs five credits. A fresh one costs one credit for each node that gets a reply, at least five and at most sixty.
Yes. Give a point with a distance, such as a city and 250 kilometres, and the verdict is about that circle.
Get started
Create an account and you have 1,000 credits every day. No purchase. No wallet.