Skip to content

socials

Turn URLs into structured social media profiles.

You have a list of URLs from a scrape, a CSV export, or email signatures. Some of them are social media profiles. Socials finds them and gives you structured data to work with.

Quick Start

pip install socials

import socials

repo = socials.parse("https://github.com/lorey/socials")
print(repo)
# GitHubRepoURL(owner='lorey', repo='socials')

print(repo.platform)
# 'github'

print(repo.owner)
# 'lorey'

Supported Platforms

Platform Entity Types Example URL
GitHub profile, repo github.com/lorey/socials
Twitter/X profile twitter.com/karllorey
LinkedIn profile, company linkedin.com/in/karllorey
Facebook profile facebook.com/zuck
Instagram profile instagram.com/instagram
YouTube channel youtube.com/c/GoogleDevelopers
Email email mailto:hello@example.com
Phone phone tel:+1234567890

What You Get

Each URL is parsed into a typed Python object:

  • platform - Which social network
  • entity_type - Profile, repo, company, etc.
  • Platform-specific fields like username, repo, company_name

No regex. No string parsing. Just data.

Next Steps

Architecture