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"
     },
    ]
  }
}