A Python library to query IP addresses using the ipquery.io API. This library allows you to easily retrieve detailed information about IP addresses, including ISP data, geolocation details, and risk analysis.

• Query detailed information for a specific IP address.
• Fetch your own public IP address.
• Perform bulk queries for multiple IP addresses.
• Includes Pydantic models for easy data validation and parsing.

Install the package using pip:

pip install ipcore

from ipapi.client import IPAPIClient

Fetch information about a specific IP address:

from ipapi.client import IPAPIClient client = IPAPIClient() ip_info = client.query_ip("8.8.8.8") print(ip_info)

from ipapi.client import AsyncIPAPIClient async def main(): client = AsyncIPAPIClient() ip_info = await client.query_ip("8.8.8.8") print(ip_info) if __name__ == "__main__": import asyncio asyncio.run(main())

IPInfo(ip='8.8.8.8', isp=ISPInfo(asn='AS15169', org='Google LLC', isp='Google LLC'), location=LocationInfo(country='United States', country_code='US', city='Mountain View', state='California', zipcode='94035', latitude=37.386, longitude=-122.0838, timezone='America/Los_Angeles', localtime='2024-11-09T12:45:32'), risk=RiskInfo(is_mobile=False, is_vpn=False, is_tor=False, is_proxy=False, is_datacenter=True, risk_score=0)) 

Retrieve your machine's public IP address:

ip = client.query_own_ip() print(f"Your IP: {ip}")

Your IP: 203.0.113.45 

Fetch details for multiple IP addresses in a single request:

ips = ["8.8.8.8", "1.1.1.1"] results = client.query_bulk(ips) for ip_info in results: print(ip_info)

IPInfo(ip='8.8.8.8', ...) IPInfo(ip='1.1.1.1', ...) 

If you want to run tests to verify functionality:

pytest tests/

• Python 3.7+
• Pydantic 2.x
• httpx

This project is licensed under the MIT License. See the LICENSE file for more information.

• GitHub Repository
• PyPI Project Page