plasticuproject/hibpwned

Python API wrapper for haveibeenpwned.com (API v3)

hibpwned

A friendly, low-level, fully functional, Python API wrapper for haveibeenpwned.com
All data sourced from https://haveibeenpwned.com
Visit https://haveibeenpwned.com/API/v3 to read the Acceptable Use Policy
for rules regarding acceptable usage of this API.

Installation

pip install hibpwned

Making calls to the HIBP API requires a key. You can purchase an HIBP-API-Key at
https://haveibeenpwned.com/API/Key

Usage

This module contains the class Pwned with functions:

search_all_breaches
all_breaches
single_breach
data_classes
search_pastes
search_password
search_hashes

All functions return a list of JSON objects containing relevent data, with the exception
of search_password and search_hashes, which returns an integer and a string object,
respectively.

See module DocStrings for function descriptions and parameters

Examples

import hibpwned

my_app = hibpwned.Pwned("[email protected]", "My_App", "My_API_Key")

my_breaches = my_app.search_all_breaches()
breaches = my_app.all_breaches()
adobe = my_app.single_breach("adobe")
data = my_app.data_classes()
my_pastes = my_app.search_pastes()
password = my_app.search_password("BadPassword")
my_hashes = my_app.search_hashes("21BD1")

hibpwned's Issues

Forbidden: No user agent has been specified in the request

I'm using this snippet to get breaches (copied from the README):

import hibpwned
myApp = hibpwned.Pwned('[email protected]', 'My_App')
myBreaches = myApp.searchAllBreaches()

It doesn't work. Even if I try manually accessing the API using the browser (url https://haveibeenpwned.com/api/v2/breachedaccount/test%40example.com) I get a 403 HTTP error.

I also tried this, but it does not work:

import requests
import urllib
headers = {'User-Agent': 'My_App'}
url = "https://haveibeenpwned.com/api/v2/breachedaccount/%s" % urllib.parse.quote("[email protected]")
response = requests.get(url, headers=headers)
json = response.json()

Is it my internet that has some problems or has the API changed its requirements?

Too many requests: The rate limit has been exceeded

Hello,

Do you know how many time i must wait until i'll retrieve the access to haveibeenpwned through your api ?