API Documentation
a. Requirements
( These can be obtained/set via contacting support. )
- API Key
- Static IPV4 Address / Range (optional)
b. Usage
Leak-Lookup's API is relatively easy to use, clients must send a POST request to the URL address specified below:
c. Parameters
Each request should contain the type
and key
field.
Each successful request that utilizes the query
field (and returns content) will increment your daily request count by 1.
- type - This is the column/field to search.
- query - This is your search query.
- key - This is your API key.
c.1 Accepted Values
The fields specified below can be used within the type
field to perform more precise searches.
Please note certain domains have been blacklisted due to abuse concerns.
domain email_address fullname ipaddress phone password username
d. Examples
Here are some command line examples using curl, replace {API_KEY}
with the API key provided to you.
- curl 'https://leak-lookup.com/api/search' -d 'key=
{API_KEY}
[email protected]' - curl 'https://leak-lookup.com/api/search' -d 'key=
{API_KEY}
&type=username&query=david.smith' - curl 'https://leak-lookup.com/api/search' -d 'key=
{API_KEY}
&type=ipaddress&query=112.109.11.112' - curl 'https://leak-lookup.com/api/search' -d 'key=
{API_KEY}
&type=domain&query=example.com'
d.1 Additional
- curl 'https://leak-lookup.com/api/search' -d 'key=
{API_KEY}
&type=count' - curl 'https://leak-lookup.com/api/search' -d 'key=
{API_KEY}
&type=hash&query={PASSWORD_HASH}'
d.2 Public
Leak-Lookup provides a free API service in the applications listed below:
e. Responses
All of the above commands will return a valid JSON response.
Please note; Fields change from index to index, we have provided a list of available fields and have tried to standardize them across all indexes.
Standard response:
{
"error": "false",
"message": {
"sitename": [
{
"column1": "value1",
"column2": "value2"
}
],
"sitename2": [
{
"column1": "value1",
"column2": "value2",
"column3": "value3",
}
]
}
}
Column index:
address
address1
address2
country
email_address
firstname
ipaddress
lastname
middlename
mobile
number
password
phone
postcode
salt
state
userid
username
zip
zipcode
Error response:
{
"error": "true",
"message": "error_string"
}
Error messages:
REQUEST LIMIT REACHED - Your api limit has been reached, please wait until your daily allowance renews.
INACTIVE API KEY - Your api key is inactive, please contact support.
INVALID API KEY - Your api key is invalid, please contact support.
MISSING API KEY - Your query is invalid, please refer to the documentation above.
Example response:
{
"error": "false",
"message": {
"netease.com":[
{
"firstname":"John",
"lastname":"Smith",
"ipaddress":"184.72.192.49",
"email_address":"[email protected]",
"password":"jinxed"
}
],
"pemiblanc.com":[
{
"email_address":"[email protected]",
"password":"yomama2u"
},
{
"email_address":"[email protected]",
"password":"youporn"
},
]
}
}