Skip to main content

A Python library for interfacing with IPStack Geo API

Project description

IPStack for Python (Geo Location Library)

IPStack for Python is a simple library used to interface with an IPStack Geo API.

Hint: IPStack for Python is available through Python PIP. pip install ipstack

Supports Python 2.7+

PyPI version PyCodeStyle Downloads GitHub issues GitHub license

Learn more about IPStack here:

Looking for the PHP version?


  • Retrieve the Geo Location data for any IP address.
  • Retrieve the Geo Location data for the system executing this code.
  • Retrieve the Geo Location data for a client.
  • Retrieve the Geo Location data for a batch of IP addresses.
  • Assess the security of an IP address.

Basic Usage

from ipstack import GeoLookup
geo_lookup = GeoLookup(".....")
location = geo_lookup.get_location("")

Example Usage

Note: See IPStack: Response Objects for a list of available properties in a response object.

Create the GeoLookup object

from ipstack import GeoLookup

# Create the GeoLookup object using your API key.
geo_lookup = GeoLookup("acecac3893c90871c3")

Lookup a location for an IP Address

# Lookup a location for an IP Address
# and catch any exceptions that might
# be thrown
    # Retrieve the location information for 
    # by using it's hostname.
    # This function will work with hostnames
    # or IP addresses.
    location = geo_lookup.get_location("")

    # If we are unable to retrieve the location information
    # for an IP address, null will be returned.
    if location is None:
        print("Failed to find location.")
        # Print the Location dictionary.
except Exception as e:

Look up own location

For looking up your own location we use

location = geo_lookup.get_own_location()

Other Features

There are also a few other useful features built into this library and the IPStack API.

  1. Bulk Location Lookup

    The ipstack API also offers the ability to request data for multiple IPv4 or IPv6 addresses at the same time. This requires the PROFESSIONAL teir API key or higher and is limitted to 50 IPs at a time.


    locations = geo_lookup.get_location("", "")
  2. Requesting the hostname for an IP address.

    By default, the ipstack API does not return information about the hostname the given IP address resolves to. In order to include the hostname use the following.


    location = geo_lookup.find_hostname().get_location("")
  3. Assessing Security

    Customers subscribed to the Professional Plus Plan may access the ipstack API's Security Module, which can be used to assess risks and threats originating from certain IP addresses before any harm can be done to a website or web application.


    location = geo_lookup.assess_security().get_location("")
  4. Set the language for a response

    The ipstack API is capable of delivering its result set in different languages. To request data in a language other than English (default) use following with one of the supported language codes.


    Supported Langauges

    location = geo_lookup.language("en").get_location("")
  5. Configuring your request

    # Use HTTPS
    # This requires IPStack Basic plan or higher.
    location = geo_lookup.use_https().get_location("")
    # Configure the timeout for requests
    location = geo_lookup.timeout(10).get_location("")


Before commiting anything, please create a pre-commit hook with the following content.

This will ensure that the pycodestyle badge is properly updated.

python3 tests/

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ipstack-0.1.4.tar.gz (3.9 kB view hashes)

Uploaded source

Built Distribution

ipstack-0.1.4-py3-none-any.whl (4.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page