Skip to content

Releases: IPGeolocation/cli

v1.0.0 - Initial Stable Release

02 Sep 12:43

Choose a tag to compare

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]
  1. 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
  1. 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