docs / username-osint
Username Search API
Username Search API
base /username-osint/v11 endpoints
post
/username-osint/v1/username3 creditsFind 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| username | required | — | The public username/handle to check across the platform stable-set. A public handle, NOT an email or phone. Letters, digits, . _ - only. |
| top = 300 | optional | — | How many of the most-popular sites to scan (20-500). More sites = broader coverage but slower. Default 300 (~15s). |
| tags | optional | — | Restrict the scan to Maigret site tags (e.g. gaming, social, coding, photo, music, forum, finance, us, ru). Comma-separated. Default = all. |
| sites | optional | — | Restrict the scan to these exact platform names (case-insensitive). Default = the full stable-set for the input type. Unknown names ignored. |
| deep = false | optional | — | Parse found profiles to extract linked identifiers (other usernames, ids, names) for pivoting. Slower. Default false. |
Example request · username
curl -X POST https://api.reefapi.com/username-osint/v1/username \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"username":"torvalds","top":30}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}