Product
Introducing License Enforcement in Socket
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
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
Learn more about IPStack here: ipstack.net
from ipstack import GeoLookup
geo_lookup = GeoLookup(".....")
location = geo_lookup.get_location("github.com")
print(location)
Note: See IPStack: Response Objects for a list of available properties in a response object.
from ipstack import GeoLookup
# Create the GeoLookup object using your API key.
geo_lookup = GeoLookup("acecac3893c90871c3")
# Lookup a location for an IP Address
# and catch any exceptions that might
# be thrown
try:
# Retrieve the location information for
# github.com by using it's hostname.
#
# This function will work with hostnames
# or IP addresses.
location = geo_lookup.get_location("github.com")
# 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.")
else:
# Print the Location dictionary.
print(location)
except Exception as e:
print(e)
For looking up your own location we use https://ip.42.pl/raw
location = geo_lookup.get_own_location()
print(location)
There are also a few other useful features built into this library and the IPStack API.
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("github.com", "stackoverflow.com")
print(locations)
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("1.1.1.1")
print(location["hostname"])
one.one.one.one
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("github.com")
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.
location = geo_lookup.language("en").get_location("github.com")
Configuring your request
# Use HTTPS
# This requires IPStack Basic plan or higher.
location = geo_lookup.use_https().get_location("github.com")
# Configure the timeout for requests
location = geo_lookup.timeout(10).get_location("github.com")
Before commiting anything, please create a pre-commit hook with the following content.
This will ensure that the pycodestyle badge is properly updated.
#!/bin/bash
python3 tests/style.py
FAQs
A Python library for interfacing with IPStack Geo API
We found that ipstack demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
Product
We're launching a new set of license analysis and compliance features for analyzing, managing, and complying with licenses across a range of supported languages and ecosystems.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.