# Maigret Username OSINT Search (`ntriqpro/maigret-actor`) Actor

Search for a username across 3000+ websites using maigret. Discover social media profiles, forums, and online accounts associated with a username.

- **URL**: https://apify.com/ntriqpro/maigret-actor.md
- **Developed by:** [daehwan kim](https://apify.com/ntriqpro) (community)
- **Categories:** AI, Developer tools, Business
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$10.00 / 1,000 profile founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Maigret Username OSINT Search

Search for a **username across 3000+ websites** and discover all associated social media profiles, forums, and online accounts — powered by [maigret](https://github.com/soxoj/maigret) (MIT License).

> **Legal Disclaimer: This Actor is an unofficial integration of maigret and is not affiliated with, endorsed by, or sponsored by the original maigret project or its maintainers. Use responsibly and only on usernames you have authorization to investigate.**

---

### What does Maigret Username OSINT Search do?

This Actor runs the open-source OSINT tool **maigret** to search for a given username across thousands of social networks, developer platforms, forums, and more. It returns a structured dataset of all sites where the username was found, including profile URLs, extracted data (full name, avatar, location), site tags, and HTTP status codes.

Built for security researchers, investigators, journalists, and developers who need automated username reconnaissance.

---

### Why use this Actor?

- **3000+ sites checked** — GitHub, Twitter/X, Instagram, Reddit, TikTok, LinkedIn, and thousands more
- **Profile data extraction** — automatically extracts full names, avatars, bios, and location when available
- **Tag-based filtering** — filter by category (social, coding, video, dating, etc.)
- **Structured JSON output** — ready to integrate with Apify datasets, webhooks, or downstream pipelines
- **Scheduled runs** — set up recurring username monitoring via Apify Scheduler
- **API access** — call via REST API, MCP, or Apify Console

---

### How to use Maigret Username OSINT Search

1. **Open the Actor** in Apify Console and click **Try for free**
2. **Enter a username** in the `Username` field (e.g., `john`)
3. **Configure options** — set `Top N sites` (default 500), timeout, or tag filters
4. **Start the Actor** and wait for results (500 sites ≈ 1–3 minutes)
5. **Download results** from the Output tab as JSON, CSV, or Excel

---

### Input

| Field | Type | Description | Default |
|-------|------|-------------|---------|
| `username` | string | **Required.** Username to search | — |
| `topSites` | integer | Top N sites by Alexa rank (0 = all 3000+) | `500` |
| `timeout` | integer | Per-request timeout in seconds | `30` |
| `tags` | string | Comma-separated tag filter (e.g. `social,coding`) | — |
| `excludeTags` | string | Comma-separated tags to exclude | — |
| `sites` | string | Specific site names to check (e.g. `GitHub,Instagram`) | — |
| `noRecursion` | boolean | Disable recursive search for related IDs | `false` |
| `printNotFound` | boolean | Include "not found" sites in output | `false` |

**Example input:**
```json
{
    "username": "johndoe",
    "topSites": 500,
    "timeout": 30,
    "tags": "social,coding",
    "noRecursion": false
}
````

***

### Output

Each dataset item represents a site where the username was **found**:

```json
{
    "username": "johndoe",
    "siteName": "GitHub",
    "profileUrl": "https://github.com/johndoe",
    "siteMainUrl": "https://github.com",
    "status": "Claimed",
    "httpStatus": 200,
    "isSimilar": false,
    "alexaRank": 65,
    "tags": ["coding"],
    "fullName": "John Doe",
    "bio": "Software Engineer",
    "image": "https://avatars.githubusercontent.com/johndoe",
    "location": "San Francisco, CA",
    "extractedIds": {
        "github_id": "12345",
        "fullname": "John Doe"
    },
    "scrapedAt": "2026-04-16T00:00:00.000Z"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

***

### Data fields

| Field | Format | Description |
|-------|--------|-------------|
| `username` | text | Searched username |
| `siteName` | text | Website name |
| `profileUrl` | link | Direct profile URL |
| `status` | text | `Claimed` / `Not Found` / `Unknown` |
| `httpStatus` | number | HTTP response code |
| `alexaRank` | number | Site Alexa rank (lower = more popular) |
| `tags` | array | Site category tags |
| `fullName` | text | Extracted full name (if available) |
| `bio` | text | Extracted bio/description |
| `image` | link | Profile avatar URL |
| `location` | text | Extracted location |
| `extractedIds` | object | All extracted identifiers |
| `scrapedAt` | date | Timestamp |

***

### Pricing / Cost estimation

This Actor uses standard Apify platform billing (compute units).

- Checking top 500 sites: approximately **0.02–0.05 USD per run**
- Checking all 3000+ sites: approximately **0.10–0.25 USD per run**
- New Apify users receive free monthly credits to get started

***

### Tips and Advanced Options

- **Speed up searches**: Set `topSites` to 100–200 for quick checks on major platforms
- **Category focus**: Use `tags: "social"` to check only social networks, or `"coding"` for developer platforms
- **Specific sites**: Use the `sites` field to check a small custom list (e.g. `"GitHub,Twitter,Reddit"`)
- **Monitoring**: Schedule this Actor weekly to detect new account registrations for a username
- **Disable recursion**: Set `noRecursion: true` to skip recursive sub-searches (faster, less data)

***

### FAQ, Disclaimers & Support

#### Is this legal?

This Actor searches **publicly accessible pages only** — the same pages anyone can view in a browser. However:

- **Only search usernames you are authorized to investigate** (your own, or with explicit permission)
- Comply with applicable laws including GDPR, CCPA, and local privacy regulations
- Do not use results to harass, stalk, or harm individuals
- The Actor does not access private data, bypass authentication, or scrape restricted content

#### Legal Disclaimer

**This Actor is an unofficial integration of [maigret](https://github.com/soxoj/maigret) (MIT License). It is NOT affiliated with, endorsed by, or sponsored by the original maigret project or its authors. The Actor author provides this tool for legitimate security research, journalism, and authorized investigations only. Users are solely responsible for ensuring their use complies with applicable laws and the Terms of Service of checked websites. The author accepts no liability for misuse.**

#### Known Limitations

- Some sites may block automated requests (rate limiting, CAPTCHA)
- Results accuracy depends on the maigret database (updated automatically)
- Very common usernames may return false positives on some sites

#### Support

- Found a bug? Open an issue in the **Issues** tab
- Need a custom OSINT solution? Contact via the Apify platform

***

### 🔗 Related Actors by ntriqpro

Extend this actor with the ntriqpro intelligence network:

- [**cve-threat-prioritizer**](https://apify.com/ntriqpro/cve-threat-prioritizer) — Prioritize CVEs by exploitability & active threats
- [**nist-cve-vulnerability-scanner**](https://apify.com/ntriqpro/nist-cve-vulnerability-scanner) — NIST NVD CVE vulnerability lookup
- [**first-cvss-severity-index**](https://apify.com/ntriqpro/first-cvss-severity-index) — FIRST CVSS severity scoring

### ⭐ Love it? Leave a Review

Your rating helps professionals discover this actor. [Rate it here](https://apify.com/ntriqpro/maigret-actor/reviews).

# Actor input Schema

## `username` (type: `string`):

The username to search for across social networks and websites.

## `topSites` (type: `integer`):

Limit search to top N sites by Alexa rank. Set 0 to search all 3000+ sites (slow). Default: 500.

## `timeout` (type: `integer`):

Time in seconds to wait for each site response. Default: 30.

## `tags` (type: `string`):

Comma-separated list of site tags to include (e.g. 'social,coding,video'). Leave empty to check all.

## `excludeTags` (type: `string`):

Comma-separated list of site tags to exclude.

## `sites` (type: `string`):

Comma-separated list of specific site names to check (e.g. 'GitHub,Twitter,Instagram'). Leave empty to use topSites.

## `noRecursion` (type: `boolean`):

Disable recursive search for additional usernames/IDs found during the search. Faster but less thorough.

## `printNotFound` (type: `boolean`):

Also save sites where the username was NOT found in the dataset.

## Actor input object example

```json
{
  "username": "john",
  "topSites": 500,
  "timeout": 30
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "username": "john",
    "topSites": 500,
    "timeout": 30,
    "tags": "",
    "excludeTags": "",
    "sites": "",
    "noRecursion": false,
    "printNotFound": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("ntriqpro/maigret-actor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "username": "john",
    "topSites": 500,
    "timeout": 30,
    "tags": "",
    "excludeTags": "",
    "sites": "",
    "noRecursion": False,
    "printNotFound": False,
}

# Run the Actor and wait for it to finish
run = client.actor("ntriqpro/maigret-actor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "username": "john",
  "topSites": 500,
  "timeout": 30,
  "tags": "",
  "excludeTags": "",
  "sites": "",
  "noRecursion": false,
  "printNotFound": false
}' |
apify call ntriqpro/maigret-actor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ntriqpro/maigret-actor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Maigret Username OSINT Search",
        "description": "Search for a username across 3000+ websites using maigret. Discover social media profiles, forums, and online accounts associated with a username.",
        "version": "1.0",
        "x-build-id": "LNcpghiM2NN3kImxy"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ntriqpro~maigret-actor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ntriqpro-maigret-actor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/ntriqpro~maigret-actor/runs": {
            "post": {
                "operationId": "runs-sync-ntriqpro-maigret-actor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/ntriqpro~maigret-actor/run-sync": {
            "post": {
                "operationId": "run-sync-ntriqpro-maigret-actor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "username"
                ],
                "properties": {
                    "username": {
                        "title": "Username",
                        "type": "string",
                        "description": "The username to search for across social networks and websites."
                    },
                    "topSites": {
                        "title": "Top N sites to check",
                        "minimum": 0,
                        "maximum": 3000,
                        "type": "integer",
                        "description": "Limit search to top N sites by Alexa rank. Set 0 to search all 3000+ sites (slow). Default: 500."
                    },
                    "timeout": {
                        "title": "Request timeout (seconds)",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "Time in seconds to wait for each site response. Default: 30."
                    },
                    "tags": {
                        "title": "Filter by tags (include)",
                        "type": "string",
                        "description": "Comma-separated list of site tags to include (e.g. 'social,coding,video'). Leave empty to check all."
                    },
                    "excludeTags": {
                        "title": "Filter by tags (exclude)",
                        "type": "string",
                        "description": "Comma-separated list of site tags to exclude."
                    },
                    "sites": {
                        "title": "Specific sites to check",
                        "type": "string",
                        "description": "Comma-separated list of specific site names to check (e.g. 'GitHub,Twitter,Instagram'). Leave empty to use topSites."
                    },
                    "noRecursion": {
                        "title": "Disable recursive search",
                        "type": "boolean",
                        "description": "Disable recursive search for additional usernames/IDs found during the search. Faster but less thorough."
                    },
                    "printNotFound": {
                        "title": "Include 'not found' results",
                        "type": "boolean",
                        "description": "Also save sites where the username was NOT found in the dataset."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
