gmr / httpbl

Python client library for the project-honeypot.org Http:BL API

httpbl

Project Honeypot Http:BL API Package

Requires a Http:BL API key from https://www.projecthoneypot.org/

Response Format

dict with keys:

• days_since_last_activity
• name
• threat_score
• types - a list of visitor types (int values)

The list types are enumerated in the module:

• httpbl.COMMENT_SPAMMER
• httpbl.HARVESTER
• httpbl.SEARCH_ENGINE
• httpbl.SUSPICIOUS

Text descriptions are available in the httpbl.DESCRIPTIONS dict.

Example

import httpbl

ip_address = '127.5.20.3'

bl = httpbl.HttpBL('my-key')
response = bl.query(ip_address)

print('IP Address: {}'.format(ip_address))
print('Threat Score: {}'.format(response['threat_score']))
print('Days since last activity: {}'.format(response['days_since_last_activity']))
print('Visitor type: {}'.format(', '.join([httpbl.DESCRIPTIONS[t] for t in response['type']])))