@iplookup/geocode

This is an API created to make ip-location-api available for browsers. The database itself is large at 132MB, so it is splitted into over 4000 pieces for fast downloading in a browser.

Synopsis

<script src="https://cdn.jsdelivr.net/npm/@iplookup/geocode/iplookup.min.js"></script>
<script type="text/javascript">
var ip = "51.210.219.22"
var location = await IpLookup(ip)
console.log(location)
// {
//   country: 'FR',
//   latitude: 50.9959,
//   longitude: 2.11757
// }
</script>

ESM

import IpLookup from '@iplookup/geocode'
await IpLookup("2402:b801:ea8b:23c0::")

CJS

const IpLookup = require('@iplookup/geocode')
await IpLookup("207.97.227.239")

If you need extra information about country, try to use @iplookup/geocode-extra.

License

The database is published under CC BY 4.0 by DB-IP.

The software itself is published under MIT license by sapics.

Changelog

3.0.2

After this version, the database directory which includes postcode is changed. The database is automatically updated when changing from v2 to v3.

3.0.0 Remake postcode database

If you use postcode field, you need to update database after updating to v3. (As above, it will automatically updates after v3.0.2)

Previous v2 has troubles as #21 with some postcodes. To fix them, we remake database structure for postcode.

2.0.0 Auto-update and create database at initial run.

Automatic updates and creation of databases at initial runtime have been added by default. While many users will not need to make any changes, this is a major update as it may have made a difference in usage for some.

• Add new CLI parameter ILA_AUTO_UPDATE which updates database twice weekly with default setting and you can set cron format.
• Create database at initial run.