Python guide

Use FindIP with Python

Call the FindIP REST API from Python and read geolocation, network traits, and privacy/security intelligence from one response.

Endpoint

Authenticated IP lookup

GET https://api.findip.net/{ip}/?token={token}

Geolocationcity, country, location, subdivisions, and traits.

Intelligenceintelligence.summary, risk, flags, categories, tags, and evidence.

Response guideView the full response model

Production-ready Python example

Requires requests.

import requests

ip = "8.8.8.8"
token = "YOUR_API_KEY"

response = requests.get(
    f"https://api.findip.net/{ip}/",
    params={"token": token, "returnIp": "true"},
    timeout=10,
)
response.raise_for_status()
data = response.json()

intelligence = data["intelligence"]

print("City:", data.get("city", {}).get("names", {}).get("en"))
print("Country:", data.get("country", {}).get("names", {}).get("en"))
print("Coordinates:", data.get("location", {}).get("latitude"), data.get("location", {}).get("longitude"))
print("ISP:", data.get("traits", {}).get("isp"))
print("ASN:", data.get("traits", {}).get("autonomous_system_number"))

print("Verdict:", intelligence["summary"]["verdict"])
print("Risk:", intelligence["risk"]["score"], intelligence["risk"]["level"])
print("VPN:", intelligence["flags"]["is_vpn"])
print("Proxy:", intelligence["flags"]["is_proxy"])
print("Tor:", intelligence["flags"]["is_tor"])
print("Tags:", ", ".join(intelligence["tags"]) or "none")