PHP Classes


Recommend this page to a friend!
  Classes of Ivan Melgrati  >  FreeGoIP  >  >  Download  
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: FreeGoIP
Get the location of an address with FreeGoIP API
Author: By
Last change: Update of
Date: 10 months ago
Size: 2,632 bytes


Class file image Download


GitHub license GitHub release Total Downloads GitHub issues GitHub stars

FreeGoIP - A PHP wrapper for FreeGoIP reverse geolocation API. 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 Twitter


  • PHP >= 5.3.0



The recommended installation method is through Composer, a dependency manager for PHP. Just add imelgrat/freegoip to your project's composer.json file:

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

More details can be found over at Packagist.


  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.


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.


  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.
For more information send a message to info at phpclasses dot org.