# Username Leaks API

## Description

Data updates API can be used for retrieving data showed in <https://whiteintel.io/data-updates> page.

## Endpoint

`POST /api/get_username_leaks.php`

## Required Headers

| Name         | Description                       |
| ------------ | --------------------------------- |
| Content-Type | Must be set to `application/json` |

## Parameters

| Name                  | Type   | Required | Default        | Description                                                |
| --------------------- | ------ | -------- | -------------- | ---------------------------------------------------------- |
| apikey                | string | Yes      | N/A            | Your API key.                                              |
| query                 | string | Yes      | N/A            | Email to search                                            |
| start\_date           | string | Optional | Today - 1 Week | The start date for retrieving leaks in `YYYY-MM-DD` format |
| end\_date             | string | Optional | Current date   | The end date for retrieving leaks in `YYYY-MM-DD` format   |
| include\_system\_info | int    | Optional | 0              | Include system information of compromised devices (0 or 1) |
| limit                 | int    | Optional | N/A            | Limits the results to given number                         |

### Request URL

`POST /api/get_username_leaks.php`

```json
{
    "apikey": "your api key",
    "query":"test@example.com",
    "include_system_info": 0
}
```

### Example Success Response

```json
{"total_leaks":2,"remaining_daily_api_calls":176,"data":[{"url":"https:\/\/outlook.microsoftonline.com\/","username":"sampleuser@test.com","password":"123*****","log_date":"2024-05-16"}]}
```

### Example Error Response

```json
{"error":"Generic error message."}
```

## Code Examples

Example with Curl

```bash
curl -X POST https://whiteintel.io/api/get_username_leaks.php \
     -H "Content-Type: application/json" \
     -d '{
           "apikey": "yourapikey",
           "query": "sampleuser@test.com",
           "include_system_info": 0,
           "start_date": "2023-12-30"
         }'
```

Example with Python

```python

import requests

url = "https://whiteintel.io/api/get_username_leaks.php"
payload = {
    "apikey": "yourapikey",
    "query":"test@example.com",
    "include_system_info": 0,
    "start_date": "2023-01-01"
}
headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    print("Response:", response.json())
else:
    print("Failed to retrieve data updates", response.status_code, response.text)

```