SnapOSINT

A cross-platform OSINT tool that gathers publicly available information from Snapchat Public Profiles.

Disclaimer: This tool ONLY extracts publicly available metadata. It does not bypass authentication, scrape private data, or violate terms of service. Everything is sourced from publicly accessible unauthenticated endpoints and metadata tags.

Features

• Interactive Wizard Mode: Run without arguments to launch a user-friendly wizard.
• Deep Metadata Extraction: Parse Display Name, Username, Bio, Location, Subscriber Count, Verified status, Snap Star status, and Website.
• Media Extraction: Download raw video files (.mp4) and images (.jpg) for active Stories and Spotlights.
• Related Accounts: Discover suggested alternative profiles tied to the target.
• Terminal UI: Beautiful dashboard interface powered by rich.
• Exporting: Save data to JSON, CSV, Markdown, and HTML.

Installation

Using uv (recommended):

git clone https://github.com/xposed73/snaposint.git
cd snaposint
uv sync

Quick Start

You can run SnapOSINT interactively or provide arguments directly:

# Interactive Wizard (Recommended)
uv run snaposint

# By username with media download
uv run snaposint username --download-images

# By handle
uv run snaposint @username

# By URL
uv run snaposint https://www.snapchat.com/add/username

CLI Options

uv run snaposint --help

• --json: Export as JSON
• --csv: Export as CSV
• --markdown: Export as Markdown
• --html: Export as HTML
• --save: Save exports to disk (creates exports directory)
• --output: Specify custom output directory
• --download-images: Save raw videos (.mp4) and thumbnails (.jpg) locally
• --verbose: Enable debug logging
• --timeout: Set HTTP request timeout in seconds
• --user-agent: Provide a custom User-Agent

Example Output

uv run snaposint username --markdown --download-images

This will fetch the profile, display the dashboard, download all active Story/Spotlight .mp4 videos into an exports/ folder, and save a username.md report.

Development

Set up the project for development:

uv sync --all-groups
uv run pre-commit install

Testing

Run the test suite with pytest:

uv run pytest

Check typing with mypy:

uv run mypy src

Architecture Roadmap

SnapOSINT uses an abstract scraper architecture allowing easy extension to other platforms (Instagram, TikTok, Facebook, etc.) in the future without changing the core reporting engine.

License

MIT