Anycast ranges, where one address has many locations.
Address ranges reachable from many physical locations at once, a start and an end address per range, so an address with no single place can be handled on its own in geolocation, latency and abuse attribution.
Schema at a glance.
See documentation →The database's schema and metadata are documented carefully. It is published as CSVGZ and MMDB.
| start_ip | end_ip |
|---|---|
| 1.1.1.0 | 1.1.1.255 |
| 8.8.8.0 | 8.8.8.255 |
| 9.9.9.0 | 9.9.9.255 |
| 198.41.0.0 | 198.41.0.255 |
| 2606:4700:100:: | 2606:4700:100:ffff:ffff:ffff:ffff:ffff |
Downloading it from code.
Database API reference →One call gets you the current Anycast IP build. Every official client wraps it three ways: straight to disk, a time-limited link you hand to your own runner, or bytes in memory. A file written to disk lands only once the whole transfer has arrived, and checksums() returns the published digests to verify it against.
download()downloadUrl()downloadBytes()metadata()checksums()import osfrom internetdata import InternetDataclient = InternetData(os.environ["INTERNETDATA_API_KEY"])# what is in today's build, without moving the filemeta = client.database.metadata("anycast_ip_v1")client.database.download("anycast_ip_v1", "mmdb", "./anycast_ip_v1.mmdb")sums = client.database.checksums("anycast_ip_v1", "mmdb")print(meta.updated, meta.entries, sums["sha256"])
Getting your hands on it.
The file is the product. Teams join Anycast IP against traffic they already log, inside their own infrastructure, and never send an address anywhere to get an answer.
Geolocation
An anycast address is reachable from many places, so treat its location as unknown rather than pin it to one city.
Latency
A different instance answers from each place, so round-trip times from two vantage points can both be right.
Abuse attribution
One address can front many machines in many places, so attribute its traffic to the network, not to a host.
An official client for every major language.
All SDKs on GitHub →Twelve official clients for the languages you ship in, each wrapping the database endpoints — list what you are licensed for, poll a build, follow the download redirect, verify what landed. Install commands are in the docs.
No loose ends.
How often does this database rebuild?
Daily. The metadata call answers when the current build landed and how many rows it holds, before you fetch it.
What is in a row?
One range: a start and an end address, both inclusive. IPv4 and IPv6 are in the same file.
Which formats does a build ship in?
Gzipped CSV and MMDB, both cut from the same build. The schema section above names them.
Test the real build first.
An evaluation license puts a full current build in your hands — every row, every column, no sampling — so you can measure it against your own traffic before anyone talks about terms.