https://github.com/ardatetikbey/ipapi-ruby
A Ruby gem to query IP addresses using the ipquery.io API.
https://github.com/ardatetikbey/ipapi-ruby
ipapi
Last synced: 7 months ago
JSON representation
A Ruby gem to query IP addresses using the ipquery.io API.
- Host: GitHub
- URL: https://github.com/ardatetikbey/ipapi-ruby
- Owner: ardatetikbey
- License: mit
- Created: 2025-04-06T18:46:02.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-04-07T20:31:33.000Z (11 months ago)
- Last Synced: 2025-04-12T17:54:14.286Z (11 months ago)
- Topics: ipapi
- Language: Ruby
- Homepage: https://ipquery.io/
- Size: 15.6 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this 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
```bash
gem install ipapi
```
## Dependencies
- httparty -> "0.23.1"
## Usage
First, make sure to require the module in your script:
```ruby
require "ipapi"
```
Query your own IP:
```ruby
Ipapi.query_own_ip()
```
Query a specific IP:
```ruby
Ipapi.query_ip("8.8.8.8", "yaml")
```
Example Output:
```yaml
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.