Metadata-Version: 2.1
Name: sherlock_lib
Version: 0.0.3
Summary: 🔎 Hunt down social media accounts by username across social networks
Author: Paulo Ricardo Mesquita
Author-email: pauloricardomrs2002@gmail.com
License: MIT License
Keywords: sherlock,stalking,sherlock lib,sherlock-lib
Description-Content-Type: text/markdown
License-File: LICENSE

<p align=center>
  <br>
  <img width="70%" height="70%" src="https://raw.githubusercontent.com/PaPaPaulitos/sherlock-lib/master/images/sherlock-lib-logo.svg">
  <br>
  <span>A fork of the <a href="https://github.com/sherlock-project/sherlock">Sherlock Project</a></span>
  <br>
  <a href="https://github.com/sherlock-project/sherlock/blob/master/sites.md">List of social networks</a>
  <br>
</p>

This library was created to use the Sherlock Project in your own personal scripts.


## Installation

```console
# installing using pip
$ pip install sherlock-lib==1.0.0
```

## Usage

```python
def search_target(username,timeout=60)
```

- **Username**: Target's name on social media
- **Timeout**: Maximum search time on each site

> This function returns a dictionary with the name of the sites and the link to the target's profile on the sites.

### Example

```python
from sherlock-lib import search_target

username = "john_doe"

result = search_target(username)

```

## Contributing
We would love to have you help us with the development of Sherlock. Each and every contribution is greatly valued!

Here are some things we would appreciate your help on:
- Addition of new site support Â¹
- Bringing back site support of [sites that have been removed](removed_sites.md) in the past due to false positives

[1] Please look at the Wiki entry on [adding new sites](https://github.com/sherlock-project/sherlock/wiki/Adding-Sites-To-Sherlock)
to understand the issues.



## License

- MIT Â© Sherlock Project<br/>
- Original Creator - [Siddharth Dushantha](https://github.com/sdushantha)
- Lib Creator - [Paulo Ricardo Mesquita](https://github.com/PaPaPaulitos)
