Project

ipapi-ruby

0.0
The project is in a healthy, maintained state
Ruby bindings for ipquery.io | A free and performant IP address API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

~> 0.23.1
 Project Readme

ipapi-ruby

A Ruby gem to query IP addresses using the ipquery.io API.

Overview

Ipapi is a lightweight utility module written in Ruby that allows you to fetch detailed information about any IP address. It uses the public ipquery.io API and is ideal for quick integrations, CLI tools, or small-scale applications that need geolocation or network data based on IP addresses.

Features

  • Query your own IP address data.
  • Query information for any valid IP address.
  • Choose the response format (JSON by default).

Installation

gem install ipapi

Dependencies

  • httparty -> "0.23.1"

Usage

First, make sure to require the module in your script:

require "ipapi"

Query your own IP:

Ipapi.query_own_ip()

Query a specific IP:

Ipapi.query_ip("8.8.8.8", "yaml")

Example Output:

ip: 8.8.8.8
isp:
  asn: AS15169
  org: Google LLC
  isp: Google LLC
location:
  country: United States
  country_code: US
  city: Mountain View
  state: California
  zipcode: "94043"
  latitude: 37.436551599813335
  longitude: -122.09383799087185
  timezone: America/Los_Angeles
  localtime: 2025-04-06T19:36:06
risk:
  is_datacenter: true

License

  • This project is open-source and available under the MIT License.