Lookup files reference

One row per estimated location. The CSV and MMDB ZIPs of a package carry the same file.

Sample rows from the 11 October 2026 Compact release

LocationId,Latitude,Longitude,ContinentIso,CountryIso,SubdivisionIso,SubdivisionGeonamesId,CityGeonamesId,LocalityGeonamesId,Postcode,Timezone
150626,-37.82,145.16,AU,AU,AU-VIC,2145234,2158177,7932624,3130,Australia/Melbourne
2001,14.77,121,AS,PH,PH-03,7521305,1699802,1699802,,Asia/Manila
59587,43.15,-77.65,NA,US,US-NY,5128638,5134086,5134086,14611,America/New_York

One row per area polygon. The CSV and MMDB ZIPs of a package carry the same file. Most rows are confidence areas, referenced from Ranges-* and the geolocation MMDBs: a polygon of where the network serving an address operates. In Complete, Asns.csv also points here for each ASN's most active operational area: where that ASN operates most, as a polygon for the whole network rather than one IP range.

The size of an area isn't a confidence measure. Use ConfidenceScore for confidence in the location estimate.

Sample rows from the 11 October 2026 Compact release (WKT shortened with …)

ConfidenceAreaId,GeometryWkt
690,"POLYGON ((120.967 12.149, 120.93 12.172, 120.897 12.201, …))"
1742,"MULTIPOLYGON (((144.671 -37.872, 144.66 -37.838, 144.296 -36.087, …)))"

Place names in 10 languages, compiled and maintained by BigDataCloud, keyed by GeoNames ID. One file per language: de, en, es, fr, it, ja, ko, pt, ru, zh. Every language file has the same IDs, and the files are the same in Compact and Complete and in the CSV and MMDB ZIPs. Each language falls back to the English name where a translation isn't published, so every file has a name for every ID.

Sample rows from the 11 October 2026 Compact release

Geonames-en.csv

GeonamesId,Name
2145234,"Victoria"
2158177,"Melbourne"
7932624,"Blackburn"

Geonames-ja.csv: Blackburn uses its English name

GeonamesId,Name
2145234,"ビクトリア州"
2158177,"メルボルン"
7932624,"Blackburn"

One row per ASN, with the ASN's most active operational area. Complete only, in both the CSV and the MMDB ZIP.

ASN statistics are calculated with each release of each package.

Sample rows from the 1 October 2026 Complete release

Asn,Organisation,AsnName,Registry,RegisteredCountry,TotalIpv4Addresses,TotalIpv4Prefixes,BogonIpv4Prefixes,TotalIpv6Prefixes,BogonIpv6Prefixes,ConfidenceAreaId
1221,"Telstra Limited","ASN-TELSTRA",Apnic,AU,13386112,299,1,2,0,2430
4775,"Globe Telecom (GMCR,INC)","GLOBE-TELECOM-AS",Apnic,PH,426665,856,0,1001,0,310196
132199,"Globe Telecom Inc.","GLOBE-MOBILE-5TH-GEN-AS",Apnic,PH,310528,552,0,220,0,301369

In Network, in both the CSV and the MMDB ZIP. The same ten columns as Asns.csv, in the same order, without the operational area (ConfidenceAreaId).

Sample rows from the 11 October 2026 release

Asn,Organisation,AsnName,Registry,RegisteredCountry,TotalIpv4Addresses,TotalIpv4Prefixes,BogonIpv4Prefixes,TotalIpv6Prefixes,BogonIpv6Prefixes
940,Private Use AS,,,,2304,9,0,0,0
1221,"Telstra Limited","ASN-TELSTRA",Apnic,AU,13386624,297,1,2,0
4775,"Globe Telecom (GMCR,INC)","GLOBE-TELECOM-AS",Apnic,PH,426928,858,0,1006,0

README.txt: in every Flat Data ZIP, a plain-text overview of the package with links to its documentation.

Every ZIP has a Manifest.csv. The CSV ZIP and the MMDB ZIP of a package carry the same statistics and data timestamps, then one row per other file in that ZIP, including NOTICE.txt where present, with its byte count. Read the rows by Description, not by row position.

Statistics

Time rows

Build Complete, the release time, then the data timestamps for the package. A data-timestamp row appears when its source time is recorded. Each value is an RFC 1123 date and time in GMT, in quotes.

• Compact: IP Geolocation data timestamp.
• Network: BGP data timestamp.
• Complete: IP Geolocation data timestamp, BGP data timestamp and Threat lists data timestamp.

Totals, by package

• Compact: Total Ranges, Total IPv4 Ranges, Total IPv6 Ranges, Total Distinct locations, Total Areas.
• Network: Total Asns, Total IPv4 Bgp Ranges, Total IPv6 Bgp Ranges, Total IPv4 RIR Ranges, Total IPv6 RIR Ranges.
• Complete: all of the above, plus Total IsKnownAsVpn, Total IsKnownAsProxy and Total IsKnownAsTorServer.

For IPv4 and IPv6 separately (Compact and Complete)

Total ranges, Total ips, Percentage basis, then distribution rows for Cellular=…, HostingLikelihood=… and Confidence=…. IPv4 percentages are by address count; IPv6 percentages are by range count.

File rows

After the statistics, File: <name> (bytes) rows: one row per other file in that ZIP, including NOTICE.txt where present, with the file's byte count in Value, in file-name order (ordinal, case-sensitive, so capitals sort before lower case). In the MMDB ZIP that means the .mmdb files and the lookup files that ship with them; in the CSV ZIP, the CSV files. A manifest has no row for itself.

Sample: Compact CSV ZIP (layout only; values change with every release)

Description,Value,Percentage,RangeCount,IpCount
Build Complete,"<build time, GMT>"
IP Geolocation data timestamp,"<data time, GMT>"
Total Ranges,<count>
Total IPv4 Ranges,<count>
IPv4 Cellular=False,<count>,<percent>,<count>,<count>
File: NOTICE.txt (bytes),<byte count>,,,
File: Ranges-IPv4.csv (bytes),<byte count>,,,

Sample: Network MMDB ZIP (layout only; values change with every release)

Description,Value,Percentage,RangeCount,IpCount
Build Complete,"<build time, GMT>"
BGP data timestamp,"<data time, GMT>"
Total Asns,<count>
Total IPv4 Bgp Ranges,<count>
File: Asns-Basic.csv (bytes),<byte count>,,,
File: bigdatacloud-network-bgp.mmdb (bytes),<byte count>,,,
File: bigdatacloud-network-rir.mmdb (bytes),<byte count>,,,

In the Compact and Complete ZIPs, CSV and MMDB. Third-party data attributions, as plain text.

These apply to every CSV file, in the CSV ZIPs and in the MMDB ZIPs alike.

• Overview
• Downloads & automation
• Compact CSV · Compact MMDB
• Network CSV · Network MMDB
• Complete CSV · Complete MMDB
• Flat Data Standard Licence