Geofeed

Geofeed is a collection of IP networks accompanied by geolocation information that is typically distributed in CSV format via an http(s) link. These links are usually exchanged informally among trusted parties.

What is the format of a Geofeed?

Geofeeds are published using https URLs using CSV file format. It consists of four values per line:

• IP network in CIDR (Classless Inter-Domain Routing) format (e.g. 192.168.1.0/24)
• Country (optional): defined using a 2-letter ISO 3166-1 country code (e.g. DE for Germany)
• Region (optional): defined using ISO 3166-2 region and country code (e.g. DE-HE for Germany and Region Hessen.
• City (optional): defined using UTF-8 encoded text. It is recommended to use an English version like Munich for German München.

By example such a feed can look like:

# Published at https://mysite.public/geofeed.csv
# Updated at 2023-03-17
# ip_prefix,alpha2code,region,city,postal_code
123.124.0.0/16,DE,DE-BE,Berlin,12345
2001:df8::/32,DE,DE-BE,Berlin,12345
34.30.128.0/17,NL,NL-GR,Groningen,
34.31.0.0/16,US,US-IA,Council Bluffs,
34.32.0.0/16,NL,NL-GR,Groningen,
34.64.32.0/19,KR,KR-11,Seoul,

What are real world examples of a Geofeed?

You can have a look at some Geofeeds from:

• Google: https://www.gstatic.com/ipranges/cloud_geofeed
• Starlink: https://geoip.starlinkisp.net/feed.csv

These Geofeeds were selected, because they are bigger and can be viewed in a browser.