socid-extractor

What it is and what it does

socid_extractor is a Python library that parses social media profile pages and API responses to extract structured account data. It handles 130+ platforms—including Facebook, Instagram, GitHub, Reddit, TikTok, Bluesky, and many others—returning a flat dictionary with normalized field names (username, fullname, created_at, is_verified, etc.) and crucially, stable internal identifiers that survive username changes and platform redesigns. These IDs (GAIA for Google, UID for Facebook, pk for Instagram, and dozens more) are the core value: they let you correlate the same account across leaks, archives, and search indices, and serve as join keys in breach databases.

The library requires no API keys or headless browser—just pass response text to a single extract() call. It ships as both a Python library and a CLI tool, and is battle-tested in production OSINT tools like Maigret. Dependencies are lightweight (requests, beautifulsoup4, python-dateutil), and the package is actively maintained with recent releases and no known vulnerabilities.

Use it for:

• Extract stable internal IDs from a profile page to correlate the same account across platform renames, redesigns, and deletions.
• Pivot from a username into breach databases and search-engine indices using the stable UID as a join key.
• Feed normalized account records into downstream OSINT pipelines (like Maigret) without writing per-platform scrapers.
• Batch-process profile URLs to build a cross-service identity map for investigation or enrichment workflows.
• Extract contact info, social links, and metadata from a profile in a single call without per-site glue code.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses HTML and API responses from 130+ social platforms to extract account metadata—usernames, display names, bios, avatars, locations, join dates, follower counts, and stable internal identifiers (GAIA ID, Facebook UID, Instagram pk, etc.) that persist across renames and redesigns.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and solves a real problem—extracting stable account identifiers across 130+ platforms with a single uniform interface. MIT license permits commercial use. Install it if you need to correlate social accounts, feed OSINT pipelines, or extract account metadata at scale.

Install

socid-extractor on PyPI

pip install socid-extractor

uv add socid-extractor

poetry add socid-extractor

Installing socid-extractor

Before you install

Low friction: pure Python wheel with three common runtime dependencies (requests, python-dateutil, beautifulsoup4). Last release 32 days ago, active maintenance, 1064 repository stars, and no known vulnerabilities.

License in practice

MIT license permits commercial use without restriction, though the maintainers note that page parsers degrade as platforms change and recommend reaching out for commercial support if you need maintained private parser plugins or a hosted API.

Quickstart

pip install socid-extractor

import requests
import socid_extractor

r = requests.get('https://www.patreon.com/annetlovart')
print(socid_extractor.extract(r.text))

Requires Python 3.10 or later.

Verify before relying

• Whether the 130+ platform count remains accurate as platforms change or deprecate.
• Performance characteristics when processing large batches of profiles.
• Whether cookies are required for all Google-ecosystem parsers or only some.

Package facts

Evidence: socid_extractor-0.1.1-py3-none-any.whl

Keywords: osint, scraping, username, profile, extractor, identity

Tags

More Python Modules packages