Requirements

The following requirements can be obtained/set via contacting support.

 API Key

  - Private API keys are provided by the Leak-Lookup staff.

  - Public API keys can be found under your account-settings.

 Static IP or CIDR Range (Optional)

  - Restrict API access to an IP or a range of IP addresses.

---

Usage

Leak-Lookup's API is easy to use. Clients must send a POST request to the URL address specified below:

 https://leak-lookup.com/api/search

---

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.

---

Accepted Values

The fields specified below can be used within the type field to perform more precise searches.

 domain email_address fullname  ipaddress phone password username

Please note certain domains have been blacklisted due to abuse concerns.

---

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'

---

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}'

---

Public

Leak-Lookup provides a free API service in the applications listed below:

 SpiderFoot

 h8mail

 iKy (I Know You)

---

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 Public Key Response:

{
    "error": "false",
    "message": {
        "sitename": [
        ],
        "sitename2": [
        ]
    }
}
              

Standard Private Key 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:

RATE LIMIT REACHED               - You have performed more than 5 requests in the last minute, please wait a further minute before querying again.
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.
MISSING QUERY                         - Your query is invalid, please refer to the documentation above.
MISSING TYPE                             - Your query is invalid, please refer to the documentation above.

---

Example Public Key Response:

{
    "error": "false",
    "message": {
        "netease.com":[
        ],
        "pemiblanc.com":[
        ]
    }
}
              

Example Private Key Response:

{
    "error": "false",
    "message": {
        "netease.com":[
            {
                "firstname":"John",
                "lastname":"Smith",
                "ipaddress":"184.72.192.49",
                "email_address":"[email protected]",
                "password":"example1"
            }
        ],
        "pemiblanc.com":[
            {
                "email_address":"[email protected]",
                "password":"example2"
            },
            {
                "email_address":"[email protected]",
                "password":"example3"
            },
        ]
    }
}
              

---