Dark Web and Threat Exposure Test: API Documentation
The ImmuniWeb® Community Edition also provides a premium account status to run increased number of tests for a monthly fee. The premium status also unlocks full technical details in the reports (if applicable), allows to download the full data in PDF format and provides an API key that unlocks API's full functionality. For more information, please refer to the Monthly Limits tab.
Dark Web and Threat Exposure Test: CLI
Overview
Dark Web and Threat Exposure Test can be performed using the service’s CLI to assess your domain’s exposure on the Dark Web. You can use a Docker image or a Python script as described below.
Installing Python Script
Create virtual environment and install dependencies. Python >= 3.7 required.
git clone "https://github.com/immuniweb/iwtools.git" && cd iwtools/iwtools
python3 -m venv env
source ./env/bin/activate
pip install -r requirements.txt
python3 -m venv env
source ./env/bin/activate
pip install -r requirements.txt
Using Python Script or Docker Container
Check your company’s data leaks on Dark Web and get your cyber threat exposure report.
Start a new test or get the results from cache:
./iwtools.py darkweb example.com
Get raw API response in JSON format:
./iwtools.py darkweb --format raw_json example.com
Force to refresh a test using the Docker container with an API key
docker run immuniweb/iwtools darkweb --api-key ABCDE-12345-FGHIJ-67890 --recheck example.com
Force to refresh a test using the Python script with an API key
./iwtools.py darkweb --api-key ABCDE-12345-FGHIJ-67890 --recheck example.com
