PHPackages                             imelgrat/freegoip - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. imelgrat/freegoip

ActiveLibrary[API Development](/categories/api)

imelgrat/freegoip
=================

FreeGoIP - A PHP wrapper for FreeGoIP reverse geolocation API.

1.2.1(8y ago)2302[1 issues](https://github.com/imelgrat/freegoip/issues)MITPHPPHP >=5.3.0

Since Sep 13Pushed 8y ago1 watchersCompare

[ Source](https://github.com/imelgrat/freegoip)[ Packagist](https://packagist.org/packages/imelgrat/freegoip)[ Docs](https://github.com/imelgrat/freegoip)[ RSS](/packages/imelgrat-freegoip/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

FreeGoIP
========

[](#freegoip)

[![GitHub license](https://camo.githubusercontent.com/fd22d3d5d769a12a8d7433b2483936676b480fc3f43c1b0ee1810137566526a8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f696d656c677261742f66726565676f69702e7376673f7374796c653d666c61742d737175617265)](https://github.com/imelgrat/freegoip/blob/master/LICENSE)[![GitHub release](https://camo.githubusercontent.com/fd8675c516c99f3f22b7f07d8e68266784e5043b30b66fdcbbec1182d0b42f44/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f696d656c677261742f66726565676f69702e7376673f7374796c653d666c61742d737175617265)](https://github.com/imelgrat/freegoip/releases)[![Total Downloads](https://camo.githubusercontent.com/f0155e684ad944239082c668ed0ce96ea700dceecd6ad8595f8a89a023a040e4/68747470733a2f2f706f7365722e707567782e6f72672f696d656c677261742f66726565676f69702f646f776e6c6f616473)](https://packagist.org/packages/imelgrat/freegoip)[![GitHub issues](https://camo.githubusercontent.com/d509b93c7489c5d306056f8e762a0074844d3121aa9ec8ae8f74875c5ec810c6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f696d656c677261742f66726565676f69702e7376673f7374796c653d666c61742d737175617265)](https://github.com/imelgrat/freegoip/issues)[![GitHub stars](https://camo.githubusercontent.com/82c2c95d68437c7c2173925e65c22863d3dddb3e7fe6a41c690272bc9df4a53c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f696d656c677261742f66726565676f69702e7376673f7374796c653d666c61742d737175617265)](https://github.com/imelgrat/freegoip/stargazers)

FreeGoIP - A PHP wrapper for FreeGoIP reverse geolocation API.

freegeoip.net is a service providing a public HTTP API for software developers to search the geolocation of IP addresses. It uses a database of IP addresses associated to cities along with other relevant information such as time zone, latitude and longitude.

The freegeoip web server is free and open source but the public service limit up to 10,000 queries per hour by default. Once this limit is reached, all requests from the IP will result in HTTP 403, forbidden, until the quota is cleared.

Developed by [Ivan Melgrati](https://imelgrat.me) [![Twitter](https://camo.githubusercontent.com/1476af6a00bb9d30a5d7d79ac278ac5fd7b5544c8f6b71a39ae67cdd269b09f2/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f75726c2f68747470732f6769746875622e636f6d2f696d656c677261742f7461622d636f6c6c617073652e7376673f7374796c653d736f6369616c)](https://twitter.com/imelgrat)

Requirements
------------

[](#requirements)

- PHP >= 5.3.0

Installation
------------

[](#installation)

### Composer

[](#composer)

The recommended installation method is through [Composer](http://getcomposer.org/), a dependency manager for PHP. Just add `imelgrat/freegoip` to your project's `composer.json` file:

```
{
    "require": {
        "imelgrat/freegoip": "*"
    }
}
```

[More details](http://packagist.org/packages/imelgrat/freegoip) can be found over at [Packagist](http://packagist.org).

### Manually

[](#manually)

1. Copy `src/freegoip.php` to your codebase, perhaps to the `vendor`directory.
2. Add the `freegoip` class to your autoloader or `require` the file directly.

Feedback
--------

[](#feedback)

Please open an issue to request a feature or submit a bug report. Or even if you just want to provide some feedback, I'd love to hear. I'm also available on Twitter as [@imelgrat](https://twitter.com/imelgrat).

Contributing
------------

[](#contributing)

1. Fork it.
2. Create your feature branch (`git checkout -b my-new-feature`).
3. Commit your changes (`git commit -am 'Added some feature'`).
4. Push to the branch (`git push origin my-new-feature`).
5. Create a new Pull Request.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~265 days

Total

3

Last Release

2995d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1771952?v=4)[Iván Melgrati](/maintainers/imelgrat)[@imelgrat](https://github.com/imelgrat)

---

Top Contributors

[![imelgrat](https://avatars.githubusercontent.com/u/1771952?v=4)](https://github.com/imelgrat "imelgrat (9 commits)")

---

Tags

composerfregoipgeocodinggeocoding-apigeolocationgeolocation-apiip-geoip-geolocationlatitude-and-longitudephpphp-wrapperreverse-geocodingtime-zonetimezoneapigeocodinggeolocationtime zonelatitudelongitudetimezonereverse-geocoding

### Embed Badge

![Health badge](/badges/imelgrat-freegoip/health.svg)

```
[![Health](https://phpackages.com/badges/imelgrat-freegoip/health.svg)](https://phpackages.com/packages/imelgrat-freegoip)
```

###  Alternatives

[league/geotools

Geo-related tools PHP 7.3+ library

1.4k5.3M26](/packages/league-geotools)[jcf/geocode

Google Geocoding API for Laravel

48160.5k](/packages/jcf-geocode)[anthonymartin/geo-location

Powerful GeoCoding library: Retrieve bounding box coordinates, distances between geopoints, point in polygon, get longitude and latitude from addresses and more with GeoLocation for PHP

196949.5k5](/packages/anthonymartin-geo-location)[toin0u/geotools

Geo-related tools PHP 7.3+ library

1.4k1.3k](/packages/toin0u-geotools)[jackmartin/laravel-yandex-geocode

Simply service laravel Yandex Geocoding

1016.6k](/packages/jackmartin-laravel-yandex-geocode)[1001pharmacies/geolocation-bundle

Provides an abstraction layer for geocoding services.

116.8k](/packages/1001pharmacies-geolocation-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)