otlite · Social media

Install socid-extractor on Linux or macOS in one command

socid-extractor takes a profile URL and returns the structured fields on the page: user ID, display name, bio, follower counts, linked accounts. It is the extraction engine Maigret uses, exposed on its own.

socid-extractor in three lines

pipx install otlite
otlite install socid-extractor
otlite run socid-extractor -- url:https://example.com

Runs soxoj/socid-extractor (MIT, ★ 1.1k, otlite 1.2.1, catalog updated Oct 23, 2026). otlite installs and runs it at a tested version; it does not change or verify the tool itself.

What socid-extractor is for

Getting the numeric user ID behind a profile, which survives username changes.
Structured fields from one URL without a full Maigret run.
JSON output for scripts.

Typed inputs for socid-extractor

otlite translates these prefixes into socid-extractor's own flags. Anything else after -- is passed through unchanged, so every original flag still works.

url:: URL · otlite run socid-extractor -- url:https://example.com

Run every installed tool that takes the same input at once: otlite run --all url:https://example.com

Where the results go

Every run lands under ./results/socid-extractor/<target>/ as a timestamped output file, a .meta.json sidecar (the exact command, start and end time, exit code, and the SHA-256 of the output), and a .envelope.json with the entities found, in the same shape for every tool. List runs with otlite results, group them with --case, compare the last two with otlite diff socid-extractor <target>, and pull indicators out with otlite extract socid-extractor.

Before you run it

Some sites only return fields with cookies; pass them with the original --cookies flag.

Update, remove, inspect

otlite info socid-extractor      # inputs, keys, an example command
otlite example socid-extractor   # sample output, where there is one
otlite update socid-extractor    # move to the next tested version
otlite remove socid-extractor    # delete its virtualenv

Full reference: the otlite docs, and the tool's own README on GitHub.

Pairs with

Maigret

Maigret searches a username across thousands of sites and, where it finds a profile, extracts the public fields on it: display name, bio, location, linked accounts.

Linkook

Linkook starts from a username, finds profiles, then follows the links those profiles publish to discover further accounts and emails.

Instaloader

Instaloader downloads the public posts, stories, captions, and metadata of an Instagram profile into a folder.

FAQ

socid-extractor with otlite, answered

How do I install socid-extractor on Kali, Ubuntu, or macOS?

Install otlite once with pipx install otlite (or the one-line installer on the otlite page), run otlite init, then otlite install socid-extractor. The tool lands in its own virtualenv under ~/.otlite/, pinned to a version that was tested, so nothing touches your system Python. otlite doctor prints the command that fixes a missing git or venv module.

Which inputs does socid-extractor take through otlite?

url: (url). otlite maps each prefix to socid-extractor's own flag. Everything after -- that is not a typed input is passed through unchanged, so the original flags still work.

Where does otlite save socid-extractor results?

Under ./results/socid-extractor/<target>/ in the folder you run from, as a timestamped output file plus a .meta.json sidecar (the exact command, timing, exit code, and SHA-256) and a .envelope.json with the entities found. Add --case <name> to group runs, otlite results to list them, and otlite diff socid-extractor <target> to compare the last two.

Does socid-extractor need an API key or a login?

No key is required for the basic run. Optional keys, where the project supports them, go in with otlite keys set NAME and are passed only to tools that declare them.

Can I run socid-extractor together with other tools?

Yes. otlite run --all url:https://example.com runs every installed tool that takes url input, in parallel, including socid-extractor. Save the combination as a playbook to repeat it.