provides a public HTTP API for software developers to search the geolocation of IP addresses. It uses a database of IP addresses that are associated to cities along with other relevant information like time zone, latitude and longitude.

You’re allowed up to 10,000 queries per hour by default. Once this limit is reached, all of your requests will result in HTTP 403, forbidden, until your quota is cleared.

Geocoding (IP Address)

>>> import geocoder
>>> g = geocoder.freegeoip('')
>>> g.json

Command Line Interface

$ geocode '' --provider freegeoip


  • location: Your search location you want geocoded.
  • method: (default=geocode) Use the following:
    • geocode