Official python package for apiip.net, it offers one of the leading IP to geolocation API, get the location of any IP with a world-class API serving city, region, country, lat/long data, etc.
Reason this release was yanked:
readme update
Project description
IP to Location
Find geolocation data from IP addresses (e.g. city, country, lat/long) using the apiip.net API.
apiip.net provides 5.000 free requests per month. For higher plans, check out the website
Installation
You need to get your API key from here: https://apiip.net/get-started and you'll get 5.000 free requests/month
For more details, please visit: API Documentation
To install this package type the following (for PyPI):
pip install apiip
Usage
The package needs to be configured with your account's API key, which is available in the Apiip.net Dashboard
from apiip import apiip
api_client = apiip('YOUR_API_KEY')
info = api_client.get_location()
print(info)
HTTPS Encryption
By default, the SSL/TLS is turned off, if you want to enable it just pass the options parameter
Example
from apiip import apiip
api_client = apiip('YOUR_API_KEY', {'ssl': True})
info = api_client.get_location()
print(info)
Configuration
Call getLocation method with config object
from apiip import apiip
api_client = apiip('YOUR_API_KEY', {'ssl': True})
info = api_client.getLocation({
'ip': "67.250.186.196", # '67.250.186.196, 188.79.34.191, 60.138.7.24' - for bulk request
'output': "xml",
'fields': "city, countryName, currency.name",
'languages': "es",
})
print(info)
Option | Type | Description | Default |
---|---|---|---|
ip |
string |
Optional. Get location about the specify IP or multiple IPs. | Requester IP |
output |
string |
Optional. Specify response format, XML or JSON. | JSON |
fields |
string |
Optional. Specify response fields. | All fields |
languages |
string |
Optional. Specify response language. | EN |
callback |
string |
Optional. The callback function name (JSONP Callbacks) | - |
Example complete response
{
"ip": "67.250.186.196",
"continentCode": "NA",
"continentName": "North America",
"countryCode": "US",
"countryName": "United States",
"countryNameNative": "United States",
"regionCode":"NY"
"regionName":"New York"
"cityGeoNameId":5128581,
"city": "New York",
"postalCode": "10001",
"latitude": 40.8271,
"longitude": -73.9359,
"capital": "Washington D.C.",
"phoneCode": "1",
"countryFlagEmoj": "🇺🇸",
"countryFlagEmojUnicode": "U+1F1FA U+1F1F8",
"isEu": false,
"borders": [
"CAN",
"MEX"
],
"topLevelDomains": [
".us"
],
"languages": {
"en": {
"code": "en",
"name": "English",
"native": "English"
}
},
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$",
"number": "840",
"rates": {
"EURUSD": 0.99518
}
},
"timeZone": {
"id": "America/New_York",
"currentTime": "10/26/2021, 2:54:10 PM",
"code": "EDT",
"timeZoneName": "EDT",
"utcOffset": -14400
},
"userAgent": {
"isMobile": false,
"isiPod": false,
"isTablet": false,
"isDesktop": true,
"isSmartTV": false,
"isRaspberry": false,
"isBot": false,
"browser": "Chrome",
"browserVersion": "100.0.4896.127",
"operatingSystem": "Windows 10.0",
"platform": "Microsoft Windows",
"source": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Safari/537.36"
},
"connection": {
"asn": 12271,
"isp": "Charter Communications Inc"
},
"security": {
"isProxy": false,
"isBogon": false,
"isTorExitNode": false,
"isCloud": false,
"isHosting": false,
"isSpamhaus": false,
"suggestion": "allow",
"network": "67.250.176.0/20"
}
}
More Information
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.