Skip to main content

Extract accounts' identifiers from personal pages on various platforms

Project description

socid_extractor

Extract information about a user from profile webpages / API responses and save it in machine-readable format.

Usage

As a command-line tool:

$ socid_extractor --url https://www.deviantart.com/muse1908
country: France
created_at: 2005-06-16 18:17:41
gender: female
username: Muse1908
website: www.patreon.com/musemercier
links: ['https://www.facebook.com/musemercier', 'https://www.instagram.com/muse.mercier/', 'https://www.patreon.com/musemercier']
tagline: Nothing worth having is easy...

Without installing:

$ ./run.py --url https://www.deviantart.com/muse1908

As a Python library:

>>> import socid_extractor, requests
>>> r = requests.get('https://www.patreon.com/annetlovart')
>>> socid_extractor.extract(r.text)
{'patreon_id': '33913189', 'patreon_username': 'annetlovart', 'fullname': 'Annet Lovart', 'links': "['https://www.facebook.com/322598031832479', 'https://www.instagram.com/annet_lovart', 'https://twitter.com/annet_lovart', 'https://youtube.com/channel/UClDg4ntlOW_1j73zqSJxHHQ']"}

Installation

$ pip3 install socid-extractor

The latest development version can be installed directly from GitHub:

$ pip3 install -U git+https://github.com/soxoj/socid_extractor.git

Sites and methods

More than 100 methods for different sites and platforms are supported!

  • Google (all documents pages, maps contributions), cookies required
  • Yandex (disk, albums, znatoki, music, realty, collections), cookies required to prevent captcha blocks
  • Mail.ru (my.mail.ru user mainpage, photo, video, games, communities)
  • Facebook (user & group pages)
  • VK.com (user page)
  • OK.ru (user page)
  • Instagram
  • Reddit
  • Medium
  • Flickr
  • Tumblr
  • TikTok
  • GitHub

...and many others.

You can also check tests file for data examples, schemes file to expore all the methods.

When it may be useful

  • Getting all available info by the username or/and account UID. Examples: Week in OSINT, OSINTCurious
  • Users tracking, checking that the account was previously known (by ID) even if all public info has changed. Examples: Aware Online
  • Searching by commonly used cross-service UIDs (GAIA ID, Facebook UID, Yandex Public ID, etc.)
    • DB leaks of forums and platforms in SQL format
    • Indexed links that contain target profile ID
  • Searching for tracking data by comparison with other IDs - how it works, how can it be used.
  • Law enforcement investigations

SOWEL classification

This tool uses the following OSINT techniques:

Tools using socid_extractor

  • Maigret - powerful namechecker, generate a report with all available info from accounts found.

  • TheScrapper - scrape emails, phone numbers and social media accounts from a website.

  • InfoHunter - An open source OSINT tool that allows you to search, collect and analyze information online to get a complete picture of the person or company you are interested in.

  • YaSeeker - tool to gather all available information about Yandex account by login/email.

  • Marple - scrape search engines results for a given username.

Testing

python3 -m pytest tests/test_e2e.py -n 10  -k 'not cookies' -m 'not github_failed and not rate_limited'

Contributing

Check separate page if you want to add a new methods of fix anything.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

socid_extractor-0.0.27.tar.gz (56.4 kB view details)

Uploaded Source

Built Distribution

socid_extractor-0.0.27-py3-none-any.whl (55.1 kB view details)

Uploaded Python 3

File details

Details for the file socid_extractor-0.0.27.tar.gz.

File metadata

  • Download URL: socid_extractor-0.0.27.tar.gz
  • Upload date:
  • Size: 56.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for socid_extractor-0.0.27.tar.gz
Algorithm Hash digest
SHA256 d2032e483ae92c2f305eb2ffbb3e70667262df9e68fe3f0f63f315694b3ef3cb
MD5 15324c14a688dad3205c95c500dd14d1
BLAKE2b-256 e0b8782444b5a4c2bd3ceb030852770c57f8379e68cbb7386a37acb0b5ee9141

See more details on using hashes here.

Provenance

The following attestation bundles were made for socid_extractor-0.0.27.tar.gz:

Publisher: python-publish.yml on soxoj/socid-extractor

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file socid_extractor-0.0.27-py3-none-any.whl.

File metadata

File hashes

Hashes for socid_extractor-0.0.27-py3-none-any.whl
Algorithm Hash digest
SHA256 8a2de445fc75f5bf416892c301c783c835076f080ed39a27c82330acb2b7f39d
MD5 0a0f53d606c51653b9515e88380f9ae0
BLAKE2b-256 0c4ff18382e3ef14c0a00cbd457d10a2c82f66b9a68ef644a2a8bb967ae2c0bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for socid_extractor-0.0.27-py3-none-any.whl:

Publisher: python-publish.yml on soxoj/socid-extractor

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page