sniffcat 0.1.5

Python client for Sniffcat API.

sniffcat

Python client for the Sniffcat IP reputation and abuse reporting API.

Features

• Fetch blacklist of suspicious IPs
• Check reputation and abuse score for any IP
• View reports about IP activity
• Report suspicious IPs (e.g., for port scanning)

Installation

pip install sniffcat

Usage

from sniffcat import SniffcatClient

# Initialize the client with your API token
client = SniffcatClient("your_api_token")

# Example 1: Get blacklist with default confidence
blacklist = client.get_blacklist()
print("Blacklist:", blacklist)

# Example 2: Get blacklist with custom confidence
blacklist_80 = client.get_blacklist(confidence_min=80)
print("Blacklist (confidence >= 80):", blacklist_80)

# Example 3: Check reputation and abuse score for an IP
ip_info = client.check_ip("1.1.1.1")
print("IP info:", ip_info)

# Example 4: Get reports for an IP
reports = client.get_ip_reports("1.1.1.1")
print("IP reports:", reports)

# Example 5: Report an IP for port scanning with default comment
result = client.report_ip_port_scan("1.1.1.1")
print("Report result:", result)

# Example 6: Report an IP for port scanning with custom comment
result_custom = client.report_ip_port_scan("1.1.1.1", comment="Suspicious port scan detected from this IP")
print("Custom report result:", result_custom)

API Documentation

See full API docs at https://sniffcat.com/documentation/api