Skip to content

turian/sherlock-rest

Repository files navigation

sherlock-rest

A Django JSON REST API for Sherlock 1.4.3.

Deploy to Render for Free

Deploy to Render

Note that the Render deploy is pure python, because I couldn't figure out how to get the render.yaml.Docker version to work.

Usage:

curl -X POST -H "Content-Type: application/json" -d '{"usernames": ["user1", "user2"], "site": ["reddit", "twitter"]}' https://your-render-host.onrender.com/api/v1/sherlock/

Motivation

We wrote this because sherlock-project/api is full of gaping security holes:

  • not sanitizing input to subprocess
  • hard-coding the DJANGO_SECRET_KEY and never retrieving it from the environment With that said, this API does no authentication and is open.

We had to make a few minor changes to sherlock to get it to work through Django:

  • Creating sherlock.sherlock.run_sherlock that contains the functionality of sherlock.sherlock.main, which sherlock.sherlock.main now calls. (non-intrusive change)
  • Disabling the use of signals in sherlock.sherlock, which allowed the user to gracefully Ctrl-C in an interactive environment. (an intrusive change which could be made optional) If there is interest, we could push the changes upstream to sherlock as options. We also wouldn't mind optionally disabling the super chatty colarama output of sherlock in the server logs.

Testing locally

# clone the repo
git clone https://github.com/sherlock-project/sherlock.git

# create a secret key
export DJANGO_SECRET_KEY=`python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"`

# build the docker image
docker build -t mysherlock-rest-image .

# run docker in debug mode
docker run -p 8000:8000 --rm -t -e DJANGO_SECRET_KEY=$DJANGO_SECRET_KEY -e DJANGO_DEBUG=True mysherlock-rest-image

You can now query it as follows:

curl -X POST -H "Content-Type: application/json" -d '{"usernames": ["user1", "user2"], "site": ["reddit", "twitter"]}' http://localhost:8000/api/v1/sherlock/

Those are the only parameters supported.

Although you can batch the usernames and sites queried, we recommend doing them one at a time so you can progressively load the results.

We are open to PRs adding other arguments (e.g. proxies) that sherlock supports.

Output:

{"result": [{"username": "user1", "results": {"Reddit": {"url_main": "https://www.reddit.com/", "url_user": "https://www.reddit.com/user/user1", "status": "Claimed", "http_status": 200}, "Twitter": {"url_main": "https://twitter.com/", "url_user": "https://twitter.com/user1", "status": "Claimed", "http_status": 200}}}, {"username": "user2", "results": {"Reddit": {"url_main": "https://www.reddit.com/", "url_user": "https://www.reddit.com/user/user2", "status": "Claimed", "http_status": 200}, "Twitter": {"url_main": "https://twitter.com/", "url_user": "https://twitter.com/user2", "status": "Claimed", "http_status": 200}}}]}⏎

We strip the full response_text because YAGNI.

Contributing

Each and every contribution is greatly valued!

But if you love Sherlock, it's even better if you contribute to their repo.

About

A Django JSON REST API for Sherlock

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published