# Onionsearch (otlite)

OnionSearch is a script that scrapes urls on different.

- Takes: URL
- Install: `otlite install onionsearch`, into its own virtualenv
- Pinned: [onionsearch==1.3](https://pypi.org/project/onionsearch/1.3/)
- Command: `onionsearch`
- Python: any otlite runs on (3.10 or newer)
- Verified: 24 Sept 2026, version 1.3 on Ubuntu 26.04 LTS, Python 3.12.14
- Licence: GPL-3.0; 1,792 GitHub stars
- Source: https://github.com/megadose/OnionSearch

otlite is the no-Docker edition of OTInstaller for Linux and macOS: [install it](https://otinstaller.com/otlite) with `curl -fsSL https://get.otinstaller.com/otlite | sh`.

## Run it

| Input | otlite command | Onionsearch receives |
| --- | --- | --- |
| Search term | `otlite run onionsearch -- q:example` | `onionsearch example` |

Arguments after `--` that aren't typed inputs go to the tool unchanged.

## What a run leaves

- `results/onionsearch/example/<time>_onionsearch_example_<run id>.txt`
- `results/onionsearch/example/<time>_onionsearch_example_<run id>.meta.json`
- `results/onionsearch/example/<time>_onionsearch_example_<run id>.envelope.json`

The envelope is the same shape for every tool: the tool and version, the input, timing, exit code and status, the emails, domains, IP addresses and URLs found in the output, and the output file's path, hash and size. `otlite results --tool onionsearch` lists saved runs, `otlite extract onionsearch` pulls out indicators and `otlite diff onionsearch example` compares the two latest runs.

## With other tools

Batch runs can't pass it a value; run it on its own.

## Related tools

- [Instaloader](https://otinstaller.com/otlite/tools/instaloader.md): Download pictures (or videos) along with their captions and other metadata from Instagram
- [Torbot](https://otinstaller.com/otlite/tools/torbot.md): Dark Web OSINT Tool
- [Paramspider](https://otinstaller.com/otlite/tools/paramspider.md): Mining URLs from dark corners of Web Archives for bug hunting/fuzzing/further probing
- [Finalrecon](https://otinstaller.com/otlite/tools/finalrecon.md): All In One Web Recon
- [Yark](https://otinstaller.com/otlite/tools/yark.md): OSINT for YouTube made simple
- [Auto Archiver](https://otinstaller.com/otlite/tools/auto-archiver.md): Automatically archive web content from various sources

[All 47 otlite tools](https://otinstaller.com/otlite/tools) · [otlite docs](https://otinstaller.com/docs/otlite.md)