Get IP location information with ipgeolocation.io
Last updated 4 months ago by alphahydrae .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @mediacomem/ipgeolocation 
SYNC missed versions from official npm registry.


Get the geolocation of IP addresses in a CSV file using https://ipgeolocation.io.

This tool expects a CSV file with IP addresses in the first column and a one-line header, for example:

IP Address,Whatever,foo,bar,baz

It will output a CSV file with geolocation data about each IP address. This is a simplified example of the output:

ip,type,result,country_code2,country_name,state_prov,city,...,ipv4,success,US,United States,New York,Syracuse,...

The description of all returned geolocation data can be found here: https://ipgeolocation.io/documentation/ip-geolocation-api.html



npm install --global @mediacomem/ipgeolocation

Or with npx:

npx @mediacomem/ipgeolocation --help


ipgeolocation [options...]

  --version                Show version number                         [boolean]
  --apiKey, -k, --api-key  Provide your ipgeolocation API key[string] [required]
  --apiUrl, -u, --api-url  Change the default ipgeolocation API URL
                        [string] [default: "https://api.ipgeolocation.io/ipgeo"]
  --input, -i              CSV input file (- for standard input)
                                                         [string] [default: "-"]
  --output, -o             CSV output file (standard output if not specified)
  --help                   Show help                                   [boolean]


  • Geolocate IP addresses in a CSV file and save the results to another file:

    ipgeolocation -i input.csv -o output.csv --api-key CHANGEME
  • Geolocate IP adresses in CSV from standard input and print the results to standard output:

    cat input.csv | ipgeolocation --api-key CHANGEME > output.csv

Current Tags

  • 1.0.0                                ...           latest (4 months ago)

1 Versions

  • 1.0.0                                ...           4 months ago
Maintainers (2)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (8)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |