Dossiers

Build a dossier for a username

A deeper pass than search_username: every claimed profile is read for the details it publishes (names, locations, avatars, bios, other identifiers and the usernames it links to), and those are collected into one report. Answers 202 with a job; the per-site rows are its hits and the report is its summary.

post/dossiers

Request

  • Base URL: https://api.socially.run/v1
  • URL: https://api.socially.run/v1/dossiers
  • Auth: HTTP bearer

Request body

usernamestring required

The handle to build the dossier around.

depth'top500' | 'all'

top500 covers the highest-ranked sites; all covers the whole upstream database and takes several minutes.

recursionboolean

Follow usernames the claimed profiles link to, inside the same run. Turn it off for a narrower, faster dossier.

includeNsfwboolean

Include adult sites. Requires a plan that allows them.

includeUnreliableboolean

Also check sites the upstream database has marked unreliable.

Response

Build a dossier for a username

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.