# Username Search API — find every public account for a username across 3000+ sites: check a username (or Steam ID/URL) and get each platform where it exists plus the public profile link (GitHub, Instagram, TikTok, Reddit, Discord, Telegram, Twitch, YouTube and thousands more)

> Find every public account for a username across 3000+ sites (powered by the Maigret OSINT engine) → for each site where the account exists: the platform + the public profile link. Also accepts a Steam numeric ID or profile URL (steamcommunity.com/profiles/...). Scan the top-N most-popular sites (default 300), filter by tag (gaming/social/coding/…), or deep-scan to extract linked identifiers.
> ReefAPI engine `username-osint` · 1 endpoint · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/username-osint/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /username-osint/v1/username — 3 credits
Find every public account for a username across 3000+ sites (powered by the Maigret OSINT engine) → for each site where the account exists: the platform + the public profile link. Also accepts a Steam numeric ID or profile URL (steamcommunity.com/profiles/...). Scan the top-N most-popular sites (default 300), filter by tag (gaming/social/coding/…), or deep-scan to extract linked identifiers.

**Parameters:**
- `username` (string, required) — The public username/handle to check across the platform stable-set. A public handle, NOT an email or phone. Letters, digits, . _ - only.
- `top` (integer, optional, default 300) — How many of the most-popular sites to scan (20-500). More sites = broader coverage but slower. Default 300 (~15s).
- `tags` (array, optional) — Restrict the scan to Maigret site tags (e.g. gaming, social, coding, photo, music, forum, finance, us, ru). Comma-separated. Default = all.
- `sites` (array, optional) — Restrict the scan to these exact platform names (case-insensitive). Default = the full stable-set for the input type. Unknown names ignored.
- `deep` (boolean, optional, default false) — Parse found profiles to extract linked identifiers (other usernames, ids, names) for pivoting. Slower. Default false.

**Returns:** input_type, query, results[]{platform, category, status, profile_url?}, summary{platforms_checked, platforms_found, found_platforms[], category_distribution, status_counts}, sites_scanned, linked_identifiers?

**Example request body:**
```json
{
  "username": "torvalds",
  "top": 30
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=username-osint
- Human docs page: https://reefapi.com/docs/username-osint
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt