Metadata-Version: 2.1
Name: ipdetective
Version: 1.0.1
Summary: A Python client for IPDetective API
Author: IPDetective
Author-email: andrew@ipdetective.io
Project-URL: Homepage, https://ipdetective.io
Project-URL: Source, https://github.com/AndrewCopeland/ipdetective-client-python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests

# IPDetective Client
[IPDetective](https://ipdetective.io) is an API that focuses on bot and non-human IP detection to quickly identify if an IP address comes from a datacenter, VPN or proxy. You can signup to the free API by simply signing in to access your API key. IPDetective tracks over 1000 ASNs and detects over 250 million IP addresses as non-human users from +100 different origins, ranging from data centers, botnets, proxies and vpns.

## Features
- IP Bot Detection
- IP Geolocation
- IP ASN

## Usage
```python3
import os
from ipdetective import IPDetective

def main():
    api_key = os.getenv('IPDETECTIVE_API_KEY')
    ip_client = IPDetective(api_key)
    
    # Get information about a singular IP address
    ip_info = ip_client.GetIpInfo('8.8.8.8')
    print(ip_info)
    # {'ip': '8.8.8.8', 'bot': True, 'type': 'bot', 'asn': 15169, 'asn_description': 'GOOGLE', 'country_code': 'US', 'country_name': 'United States of America'}

    # Get information about build IP addresses
    bulk_ip_info = ip_client.GetBulkIpInfo(['8.8.8.8', '1.1.1.1'])
    print(bulk_ip_info)
    # [{'ip': '1.1.1.1', 'bot': True, 'type': 'bot', 'asn': 13335, 'asn_description': 'CLOUDFLARENET', 'country_code': 'US', 'country_name': 'United States of America'}, {'ip': '8.8.8.8', 'bot': True, 'type': 'bot', 'asn': 15169, 'asn_description': 'GOOGLE', 'country_code': 'US', 'country_name': 'United States of America'}]

if __name__ == "__main__":
    main()
```

[Check out our website](https://ipdetective.io)
