• Add --output csv to get results as CSV from every command.
• Write one row per record for bulk lookups, with nested fields as dotted columns such as location.city.
• Save CSV to a file with --output-file on bulk-ip-geo and bulk-ip-security.
• Add the .csv or .json extension to --output-file only when the name does not already end in it.
• Fix --output-file=output.json, which saved output.json.json.
• Point the pkg.go.dev link at the /v2 module path, which serves the current release.
• Correct the UN/LOCODE spelling and an --include example in the README.

Existing commands and output formats remain available.

• Add --timeout to set how long an API request can take.
• Add --max-response-mb to set the largest response to read.
• Stop requests that exceed these limits without printing or saving partial results.
• Add checks for large bulk lookups and Arabic requests.

Existing commands and output formats remain available.

What's Changed

• docs: consistent free plan naming in README by @MudassarTariq in #1
• fix: readme time-conversion examples by @mateen993 in #2
• docs(readme): use "User Agent API" product name by @MudassarTariq in #3
• Fix CLI security issues and release builds by @MudassarTariq in #4
• docs(readme): use "IP Geolocation API" product name by @MudassarTariq in #5
• docs(readme): write the brand as "IPGeolocation.io" by @MudassarTariq in #6

New Contributors

• @MudassarTariq made their first contribution in #1
• @mateen993 made their first contribution in #2

Full Changelog: v2.1.0...v2.1.1

Contributors

This release adds the my-ip command and makes the --exclude flag consistent across all commands.

Changes

• Added the my-ip command (alias getip) to get the public IP address of the machine running the CLI. It does not require an API key.
• my-ip supports --output text to print only the IP address, which is useful in shell scripts.
• ipgeo now uses --exclude, matching all other commands. The old --excludes flag is still accepted, so existing scripts keep working.
• Fixed README flag tables that listed --excludes for commands that use --exclude.
• Fixed the ip-security help text, which mentioned flags the command does not have.

Installation

Install the CLI using Go:

go install github.com/IPGeolocation/cli/v2/cmd/ipgeolocation@latest

or a specific version:

go install github.com/IPGeolocation/cli/v2/cmd/[email protected]

Prebuilt binaries for Linux, macOS and Windows are attached below.

This release fixes the Go module path for the v2 release by adopting Go's semantic import versioning.

Changes

• Updated module path to github.com/IPGeolocation/cli/v2
• Updated internal imports to reflect the new module path
• Ensures compatibility with Go module tooling and pkg.go.dev indexing

Installation

Install the CLI using Go:

go install github.com/IPGeolocation/cli/v2/cmd/ipgeolocation@latest

or a specific version:

go install github.com/IPGeolocation/cli/v2/cmd/[email protected]

Note

The previous v2.0.0 release did not include the required /v2 module path, which is necessary for Go modules. This release corrects that issue.

[2.0.0] — Targeting IPGeolocation.io v3 APIs

Changed

• Targeting v3 IPGeolocation.io APIs
• Updated response output structure for:
  • Get IP Geolocation (ipgeo command)
  • Get Bulk IP Geolocation (bulk-ip-geo command)
  • Get IP Security (ip-security command)
  • Get Bulk IP Security (bulk-ip-security command)
• Removed deprecated response fields:
  • handle and role fields removed from Get Abuse Contact Info (abuse command).
• Updated Timezone API response:
  • Replaced date_time_unix with current_time_unix
  • Added new field current_time
• Removed lang and include input parameters from ip-security and bulk-ip-security commands.
• Updated README documentation to reflect all v3 API changes.

Updates

• updated ipgeolocation references and minor fixes

IPGeolocation CLI - Release Notes v1.0.1

Release Date

2026-01-13

Version

1.0.1 release

Overview

This release corrected minor mistakes in the CLI Tool and updated README to standard format.

This release includes prebuilt binaries for multiple platforms and architectures for easy installation.

Highlights / Features

Installation Options

1. Go Install - Install directly using go install:

go install github.com/IPGeolocation/cli/cmd/[email protected]

2. Download and Build from Source - Clone the repository and run the build script:

git clone https://github.com/IPGeolocation/cli.git
cd cli
./build-release.sh

3. Download Pre-built Binaries - Prebuilt binaries for Linux, macOS, and Windows are provided in the dist/ folder or via GitHub Releases.

Global Flags

• All commands support global flags like --output, --lang, and more for customizing the output format.

Commands Included

1. config - Manage API keys and configuration.
2. ipgeo - Retrieve geolocation data for a single IP or domain.
3. bulk-ipgeo - Bulk lookup for multiple IP addresses.
4. ip-security - Retrieve security-related data for a single IP.
5. bulk-ip-security - Bulk IP security lookups.
6. asn - Query ASN information.
7. abuse - Retrieve abuse contact information for an IP or ASN.
8. timezone - Get timezone information for an IP.
9. time-conversion - Convert time between different timezones.
10. astronomy - Retrieve astronomy data for a location.
11. astronomy-timeseries - Generate astronomy timeseries data.
12. parse-user-agent - Parse a single user-agent string.
13. parse-bulk-user-agents - Parse multiple user-agent strings in bulk.

Prebuilt Binaries

Prebuilt binaries are available for the following platforms:

• Linux: amd64, arm64
• macOS: amd64, arm64
• Windows: amd64

Files include versioning in their names, e.g., ipgeolocation-1.0.1-linux-amd64.tar.gz.

Notes

• Make sure to use the binaries or Go install matching your OS and architecture.
• The CLI requires a valid API key from ipgeolocation.io to function.

License

MIT License

IPGeolocation CLI - Release Notes v1.0.0

Release Date

2025-09-02

Version

1.0.0 - Initial stable release

Overview

This is the first stable release of the IPGeolocation CLI, providing full access to the IPGeolocation.io API endpoints directly from the terminal. Users can now retrieve geolocation, timezone, IP security, ASN, abuse, user-agent parsing, astronomy data, and more.

This release includes prebuilt binaries for multiple platforms and architectures for easy installation.

Highlights / Features

Installation Options

1. Go Install - Install directly using go install:

go install github.com/IPGeolocation/cli/cmd/[email protected]

2. Download and Build from Source - Clone the repository and run the build script:

git clone https://github.com/IPGeolocation/cli.git
cd cli
./build-release.sh

3. Download Pre-built Binaries - Prebuilt binaries for Linux, macOS, and Windows are provided in the dist/ folder or via GitHub Releases.

Global Flags

• All commands support global flags like --output, --lang, and more for customizing the output format.

Commands Included

1. config - Manage API keys and configuration.
2. ipgeo - Retrieve geolocation data for a single IP or domain.
3. bulk-ipgeo - Bulk lookup for multiple IP addresses.
4. ip-security - Retrieve security-related data for a single IP.
5. bulk-ip-security - Bulk IP security lookups.
6. asn - Query ASN information.
7. abuse - Retrieve abuse contact information for an IP or ASN.
8. timezone - Get timezone information for an IP.
9. time-conversion - Convert time between different timezones.
10. astronomy - Retrieve astronomy data for a location.
11. astronomy-timeseries - Generate astronomy timeseries data.
12. parse-user-agent - Parse a single user-agent string.
13. parse-bulk-user-agents - Parse multiple user-agent strings in bulk.

Prebuilt Binaries

Prebuilt binaries are available for the following platforms:

• Linux: amd64, arm64
• macOS: amd64, arm64
• Windows: amd64

Files include versioning in their names, e.g., ipgeolocation-1.0.0-linux-amd64.tar.gz.

Notes

• This is the first stable release; please report any issues or bugs on the GitHub repository.
• Make sure to use the binaries or Go install matching your OS and architecture.
• The CLI requires a valid API key from ipgeolocation.io to function.

License

MIT License