Username search

​

When to use it

• You have a handle, from a profile, a leak or the part of an email before the @, and want to know where it is used.
• You want the public profile on each platform: display name, bio, location, creation date, linked accounts.
• You want leads for the next step: a real name, a website or an email address found on a profile.

​

Request

curl https://api.orelys.io/v1/osint/username \
  -H "Authorization: Bearer $ORELYS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "username": "johndoe" }' \
  --max-time 160

const response = await fetch("https://api.orelys.io/v1/osint/username", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ORELYS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ username: "johndoe" }),
  signal: AbortSignal.timeout(100_000),
});

const data = await response.json();
if (!response.ok) throw new Error(`${data.error.code}: ${data.error.message}`);

for (const result of data.results) {
  const profile = result.data.rows.find((row) => row.label === "Profile");
  console.log(result.label, profile ? profile.value : "");
}
console.log(`Found on ${data.sources.found} of ${data.sources.checked} sources, charged: ${data.charged}`);

import os
import requests

response = requests.post(
    "https://api.orelys.io/v1/osint/username",
    headers={"Authorization": f"Bearer {os.environ['ORELYS_API_KEY']}"},
    json={"username": "johndoe"},
    timeout=100,
)
data = response.json()
if not response.ok:
    raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")

for result in data["results"]:
    print(result["label"])
    for row in result["data"]["rows"]:
        print(f"  {row['label']}: {row['value']}")
print("Credits left:", data["credits"]["remaining"])

​

What you get back

{
  "module": "username",
  "query": "johndoe",
  "extended": false,
  "count": 2,
  "results": [
    {
      "source": "steam",
      "label": "Steam",
      "extended": false,
      "data": {
        "found": true,
        "rows": [
          { "label": "Name", "value": "John Doe" },
          { "label": "Profile", "value": "https://steamcommunity.com/id/johndoe" },
          { "label": "Country", "value": "GB" }
        ],
        "lists": [{ "label": "Games", "items": ["Counter-Strike 2", "Dota 2"] }]
      }
    },
    {
      "source": "reddit",
      "label": "Reddit",
      "extended": false,
      "data": {
        "found": true,
        "rows": [
          { "label": "Karma", "value": "1824" },
          { "label": "Created", "value": "2016-11-02" }
        ],
        "lists": []
      }
    }
  ],
  "sources": { "checked": 316, "found": 2, "not_found": 305, "failed": 9 },
  "cost": 1,
  "charged": true,
  "credits": { "remaining": 37 }
}

​

Cost and limits

• Plans: Professional and Enterprise, the plans with API access. Both include the extended sources. Credits come in packs on the pricing page and never expire.
• Per account: 60 searches a minute and 3 at the same time on Professional, 120 and 5 on Enterprise. They are shared with your Intelligence X searches and with your dashboard on orelys.io.
• Per address: 120 calls a minute, whatever the plan.

​

Errors

​

Tips

• Batch at your simultaneous limit. A search holds one of your simultaneous slots for its whole run. On Professional, run 3 at a time: a fourth is refused with 429 concurrency_limited, not queued. Wait for one to finish, then send the next.
• Read failed apart from not_found. A failed source does not mean there is no account. When failed is high, try again later. A new search costs credits again, unless nothing is found.
• Map results to sites. source is the id of a source in GET /v1/osint/sources, which gives its site.
• Chain to the next search. An email address on a profile goes to Email search. The username itself can go to Intelligence Search, to look for it in leaked data.
• Check your balance before a batch. 402 insufficient_credits gives the cost and your balance in its message. credits.balance in GET /v1/me tells you before you start.

​

Reference