Next to the six archive search modes, Orelys has two OSINT modules. Each takes one identifier and asks every source it knows about it: The answer lists only the sources that found something, with what each one found. GET /v1/osint/sources gives the full list of sources, with no key needed.

​
Credits

The OSINT modules are paid in credits, not from your daily quota.
  • Nothing found, nothing charged. When no source finds anything, the credits are given back: charged: false. This holds for a daily allowance of searches that find nothing (your daily quota, at least 10); past it, they are charged like the others (see Limits).
  • Invalid input costs nothing: it is refused before anything is charged.
  • Credits never expire. The packs are on the pricing page, but they are not on sale on the website yet: for credits, write to support@orelys.io.
  • Your balance is in GET /v1/me (credits.balance), and after every OSINT search in credits.remaining and the X-Credits-Remaining header.

​
Extended sources

"extended": true adds the sources with the deepest data — for example developer identities, account-recovery details and public keys. They cost 3 credits more, and they are in the catalogue with "extended": true.
The API has two OSINT modules, Username and Email. There is no Telegram lookup in the API.

​
What a result holds

Each item of results is one source that found something:
  • source, label — which source.
  • extended — whether it is an extended source.
  • data — what it found: rows (label and value pairs, like a profile card) and lists (a label and its items).
Every source has its own fields, and any of them can be missing. It is the same data the dashboard’s JSON download gives on orelys.io. sources counts what happened across the search: found, not_found (answered, nothing there), and failed (could not answer, or was not reached in time).

​
Timing

A search asks its sources several at a time and answers within about 100 seconds. A source that has not answered — or has not been reached — by then counts as failed, and the answer carries everything the others found. Set your HTTP client’s timeout to at least 120 seconds.

​
Rules

  • Usernames are 4 to 40 characters — letters, digits, _, . and - — and a leading @ is dropped.
  • Email addresses are compared in lower case.
  • OSINT searches count toward the per-minute and simultaneous limits like any other search.
  • A removed selector returns nothing and costs nothing.
Results are public data about real people. Use them only for lawful purposes you can justify — see the Acceptable Use Policy.