# maigret | Soxoj | Knowledge Base | Instagit

🕵️‍♂️ Collect a dossier on a person by username from 3000+ sites

GitHub Stars: 20.7k

Repository: https://github.com/soxoj/maigret

---

## Articles

### [How Maigret Handles Rate Limiting and Throttling in OSINT Searches](/soxoj/maigret/how-does-maigret-handle-rate-limiting-and-implement-throttling)

Learn how Maigret detects rate limiting via HTTP 429 codes and response keywords. Maigret empowers users to implement custom throttling and retry logic for OSINT searches.

- Tags: internals
- Published: 2026-04-30

### [How Does the D3.js Graph Report Visualization Work in Maigret? Source Code Analysis](/soxoj/maigret/how-does-the-d3-js-graph-report-visualization-work-in-maigret)

Discover how Maigret generates reports. This analysis clarifies that D3.js graph visualization is absent, detailing the Python Flask Jinja2 and Bootstrap server-side rendering process.

- Tags: internals
- Published: 2026-04-30

### [How to Run Maigret in Google Colab and Cloud Notebooks: A Complete Setup Guide](/soxoj/maigret/how-to-run-maigret-in-cloud-environments-like-google-colab)

Effortlessly run Maigret in Google Colab and Cloud Notebooks. Clone soxoj/maigret, install, and execute CLI commands. Discover the simple setup for this powerful OSINT tool.

- Tags: how-to-guide
- Published: 2026-04-30

### [What Identifier Types Does Maigret Support Besides Usernames?](/soxoj/maigret/what-identifier-types-does-maigret-support-besides-usernames)

Discover the nine identifier types Maigret supports beyond usernames, including Google GAIA and Steam numeric IDs. Use the --id-type CLI option to specify.

- Tags: deep-dive
- Published: 2026-04-30

### [How QueryNotifyPrint Reports Progress in Maigret: A Technical Deep Dive](/soxoj/maigret/how-does-the-querynotifyprint-notification-system-report-progress-in-maigret)

Discover how Maigret's QueryNotifyPrint system reports scan progress. Learn about its three-phase console output, color-coded symbols, and asynchronous progress bar.

- Tags: deep-dive
- Published: 2026-04-30

### [Maigret Check Types for Site Detection: The Three Methods for Username Verification](/soxoj/maigret/what-are-the-different-check_types-for-site-detection-in-maigret)

Discover Maigret check types for site detection: status_code, message, and response_url. Learn how Maigret verifies usernames to determine availability.

- Tags: deep-dive
- Published: 2026-04-30

### [How Maigret's Self-Check Feature Verifies Database Accuracy](/soxoj/maigret/how-does-maigrets-self-check-feature-verify-database-accuracy)

Learn how Maigret's self-check feature verifies its sites database by testing usernames against expected behaviors. Discover how Maigret ensures accuracy and reliability.

- Tags: internals
- Published: 2026-04-30

### [How Maigret Generates Username Permutations and Variants: Inside the Permutation Engine](/soxoj/maigret/how-does-maigret-generate-username-permutations-and-variants)

Discover how Maigret generates username permutations and variants using its Permute class. Learn about its approach to combinatorial permutations and visual variations.

- Tags: internals
- Published: 2026-04-30

### [How to Filter Maigret Searches by Tags: Categories, Countries, and Site Types](/soxoj/maigret/how-to-filter-maigret-searches-by-tags-like-categories-and-countries)

Filter Maigret searches by tags like categories and countries. Use --tags to whitelist and --exclude-tags to blacklist specific identifiers for targeted data collection.

- Tags: how-to-guide
- Published: 2026-04-30

### [How to Customize the Flask Web Interface of Maigret: Complete Guide](/soxoj/maigret/how-can-i-customize-the-flask-web-interface-of-maigret)

Easily customize Maigret's Flask web interface by editing templates, CSS, and app routes. Enhance Maigret's look and functionality without altering its core engine. A complete guide awaits.

- Tags: how-to-guide
- Published: 2026-04-30

### [How the Flask Web Interface Works in Maigret: Architecture and Implementation](/soxoj/maigret/how-does-the-flask-web-interface-work-in-maigret)

Explore the Flask web interface in Maigret. Discover how it manages asynchronous searches, generates reports (CSV, JSON, PDF, HTML), and implements its architecture.

- Tags: architecture
- Published: 2026-04-30

### [How Maigret Extracts Profile Information Using socid-extractor](/soxoj/maigret/how-does-maigret-extract-profile-information-using-socid_extractor)

Learn how Maigret extracts profile info with socid-extractor. Discover how it parses pages, analyzes HTML, and normalizes identifiers using SUPPORTED_IDS.

- Tags: deep-dive
- Published: 2026-04-30

### [How to Configure Proxy, Tor, and I2P Settings in Maigret for Privacy](/soxoj/maigret/how-to-configure-proxy-tor-and-i2p-settings-in-maigret-for-privacy)

Enhance Maigret privacy by configuring proxy, Tor, and I2P settings. Securely route network requests with simple CLI flags or the settings.json file for anonymous data collection.

- Tags: how-to-guide
- Published: 2026-04-30

### [How Maigret's Recursive Search Feature Works: Auto-Discovering Usernames Across Platforms](/soxoj/maigret/how-does-maigrets-recursive-search-feature-function)

Discover how Maigret's recursive search auto-discovers usernames across platforms. Maigret finds new identifiers in search results and linked pages for continuous username discovery.

- Tags: internals
- Published: 2026-04-30

### [How to Add a New Website to Maigret's Database: A Complete Guide](/soxoj/maigret/how-do-i-add-a-new-website-to-maigrets-database)

Learn how to add a new website to Maigret's database. Follow our guide to create a JSON entry and update Maigret's data for new site integrations.

- Tags: how-to-guide
- Published: 2026-04-30

### [Maigret Site Database Structure: Complete Guide to data.json Fields](/soxoj/maigret/what-is-the-structure-of-maigrets-site-database-data-json-and-its-fields)

Explore the Maigret site database structure in data.json. Understand URL patterns, detection methods, and metadata tags for efficient username checking with Maigret.

- Tags: api-reference
- Published: 2026-04-30

### [How to Use Maigret as a Python Library in Your Own Projects](/soxoj/maigret/can-i-use-maigret-as-a-python-library-in-my-own-projects)

Integrate Maigret into your Python projects. Programmatically search usernames asynchronously using the Maigret Python library for advanced automation and custom tools.

- Tags: how-to-guide
- Published: 2026-04-30

### [How Maigret's Asynchronous Site Checking Engine Operates: Technical Architecture Guide](/soxoj/maigret/how-does-maigrets-asynchronous-site-checking-engine-operate)

Explore Maigret's asynchronous site checking engine architecture. Discover how its asyncio worker pool dispatches thousands of HTTP requests concurrently for high-speed username enumeration.

- Tags: architecture
- Published: 2026-04-30