https://github.com/o-x-l/geoip-asn
Open & Free IP to ASN/Internet Provider Database
https://github.com/o-x-l/geoip-asn
abuse-reporting asn asn-lookup bgp geoip ip ip-address ip-geolocation ip-geolocation-api ip-lookup ipinfo maxmind-database maxmind-db mmdb network networking
Last synced: 8 months ago
JSON representation
Open & Free IP to ASN/Internet Provider Database
- Host: GitHub
- URL: https://github.com/o-x-l/geoip-asn
- Owner: O-X-L
- License: gpl-3.0
- Created: 2024-05-17T11:28:03.000Z (over 1 year ago)
- Default Branch: latest
- Last Pushed: 2024-11-13T14:56:20.000Z (11 months ago)
- Last Synced: 2024-11-13T15:45:01.000Z (11 months ago)
- Topics: abuse-reporting, asn, asn-lookup, bgp, geoip, ip, ip-address, ip-geolocation, ip-geolocation-api, ip-lookup, ipinfo, maxmind-database, maxmind-db, mmdb, network, networking
- Language: Python
- Homepage: https://geoip.oxl.app
- Size: 64.5 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Open IP to ASN/Internet Provider Database
[](https://github.com/O-X-L/geoip-asn/actions/workflows/lint.yml)
If you have an idea on how to improve this project: [feel free to start a discussion](https://github.com/O-X-L/geoip-asn/discussions)
Thanks go to the author of [hackitu.de](https://www.hackitu.de/geoip/) for sharing his knowledge about this topic.
If you don't care about the License restrictions - you may get data of better quality by using the free [IPInfo](https://ipinfo.io/products/free-ip-database) or [MaxMind](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) databases. In comparison with these - the database provided by **this project has pretty much NO usage restrictions**.
Also check out our [Risk-Database](https://github.com/O-X-L/risk-db).
## Data sources
IP to ASN:
* BGP routing data (https://thyme.apnic.net/.combined/ or https://bgp.nsrc.org/REN/.combined/)
ASN information:
* https://www.peeringdb.com/
----
## Databases
[](https://geoip.oxl.app/file/updated.svg)
Data is updated daily.
### Download
Note: Databases in MMDB format might be faster and cheaper to query.
#### IPv4
* [IPv4 Stripped in MMDB format](https://geoip.oxl.app/file/asn_ipv4_small.mmdb.zip) (*recommended*)
* [IPv4 Full in MMDB format](https://geoip.oxl.app/file/asn_ipv4_full.mmdb.zip)
* [IPv4 Stripped in JSON format](https://geoip.oxl.app/file/asn_ipv4_small.json.zip)
* [IPv4 Full in JSON format](https://geoip.oxl.app/file/asn_ipv4_full.json.zip)
#### IPv6
* [IPv6 Stripped in MMDB format](https://geoip.oxl.app/file/asn_ipv6_small.mmdb.zip)
* [IPv6 Full in MMDB format](https://geoip.oxl.app/file/asn_ipv6_full.mmdb.zip)
* [IPv6 Stripped in JSON format](https://geoip.oxl.app/file/asn_ipv6_small.json.zip)
* [IPv6 Full in JSON format](https://geoip.oxl.app/file/asn_ipv6_full.json.zip)
#### IPv4 + IPv6
* [IPv4+IPv6 Stripped in JSON format](https://geoip.oxl.app/file/asn_small.json.zip)
* [IPv4+IPv6 Full in JSON format](https://geoip.oxl.app/file/asn_full.json.zip)
#### Schema Examples
* [MMDB Full](https://github.com/O-X-L/geoip-asn/blob/latest/example/mmdb_full.json)
* [MMDB Small](https://github.com/O-X-L/geoip-asn/blob/latest/example/mmdb_small.json)
* [JSON Full](https://github.com/O-X-L/geoip-asn/blob/latest/example/json_full.json)
* [JSON Small](https://github.com/O-X-L/geoip-asn/blob/latest/example/json_small.json)
**Limits**:
* Without token: 2 Downloads per IP & day
* With token: 5 Downloads per IP & day
----
### API
[](https://status.oxl.at/endpoints/2--oxl-apis_geoip-db)
* [IP-to-ASN API](https://geoip.oxl.app/api/ip)
* [ASN Lookup API](https://geoip.oxl.app/api/asn/13335)
```
# IP to ASN
curl -XGET https://geoip.oxl.app/api/ip/1.1.1.1
# ASN Lookup
curl -XGET https://geoip.oxl.app/api/asn/13335
```
**Limits**:
* Without token:
* 500 Requests per IP & 10 min
* 5000 Requests per IP & day
* Anti-DOS
* With token:
* 5000 Requests per IP & 10 min
* Anti-DOS
If you want to get a (free) token for your systems - feel free to contact us at: [geoip@oxl.at](mailto:risk-db@oxl.at)
----
## License(s)
### Databases
**[BSD-3-Clause](https://opensource.org/license/bsd-3-clause)**
Free to use.
If you are nice, you can **optionally** mention that you use this IP data:
```html
IP address data powered by OXL
```
### Build Script (this repository)
**[GPLv3](https://www.gnu.org/licenses/gpl-3.0.en.html)**