{"id":17036212,"url":"https://github.com/lorey/socials","last_synced_at":"2025-12-30T18:14:24.457Z","repository":{"id":32440104,"uuid":"133252399","full_name":"lorey/socials","owner":"lorey","description":"👨‍👩‍👦 Social account detection and extraction in Python, e.g. for crawling/scraping.","archived":false,"fork":false,"pushed_at":"2022-12-26T20:37:03.000Z","size":36,"stargazers_count":46,"open_issues_count":4,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-10T20:13:10.395Z","etag":null,"topics":["crawling","facebook","instagram","linkedin","python","scraping","social-network"],"latest_commit_sha":null,"homepage":"https://socials.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lorey.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-13T15:59:42.000Z","updated_at":"2024-08-12T19:38:31.000Z","dependencies_parsed_at":"2023-01-14T21:13:50.905Z","dependency_job_id":null,"html_url":"https://github.com/lorey/socials","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lorey%2Fsocials/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lorey","download_url":"https://codeload.github.com/lorey/socials/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248566584,"owners_count":21125691,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crawling","facebook","instagram","linkedin","python","scraping","social-network"],"created_at":"2024-10-14T08:49:42.191Z","updated_at":"2025-12-30T18:14:24.410Z","avatar_url":"https://github.com/lorey.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"=======\nSocials\n=======\n\n\n.. image:: https://img.shields.io/pypi/v/socials.svg\n        :target: https://pypi.python.org/pypi/socials\n\n.. image:: https://img.shields.io/travis/lorey/socials.svg\n        :target: https://travis-ci.org/lorey/socials\n\n.. image:: https://readthedocs.org/projects/socials/badge/?version=latest\n        :target: https://socials.readthedocs.io/en/latest/?badge=latest\n        :alt: Documentation Status\n\n\n\n\nSocial Account Detection and Extraction for Python\n\n\n* Free software: GNU General Public License v3\n* Documentation: https://socials.readthedocs.io.\n* Source: https://github.com/lorey/socials\n\n\nFeatures\n--------\n\n* Detect and extract URLs of social accounts: throw in URLs, get back URLs of social media profiles by type.\n* Currently supports Facebook, Twitter, LinkedIn, GitHub, and Emails.\n\nUsage\n-----\n\nInstall it with ``pip install socials`` and use it as follows:\n\n.. code-block:: python\n\n    \u003e\u003e\u003e hrefs = ['https://facebook.com/peterparker', 'https://techcrunch.com', 'https://github.com/lorey']\n    \u003e\u003e\u003e socials.extract(hrefs).get_matches_per_platform()\n    {'github': ['https://github.com/lorey'], 'facebook': ['https://facebook.com/peterparker']}\n    \u003e\u003e\u003e socials.extract(hrefs).get_matches_for_platform('github')\n    ['https://github.com/lorey']\n\nRead more about `usage in our documentation`_.\n\n.. _usage in our documentation: https://socials.readthedocs.io/en/latest/usage.html\n\nSocials API\n--------\nThere's also `an API called Socials API`_ that allows you to use the functionality via REST.\nYou can use a `free online version`_, try it in the browser, or deploy it yourself.\n\n.. _an API called Socials API: https://github.com/lorey/socials-api\n.. _free online version: https://socials.karllorey.com\n\nDevelopment\n-----------\n\n* Create virtual envirenment ``venv`` with ``virtualenv -p /usr/bin/python3 venv``.\n* Activate the environment with ``source venv/bin/activate``.\n* Install the development requirements with ``pip install -r requirements-dev.txt``.\n* Run the tests: ``tox`` or ``python setup.py test``\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Florey%2Fsocials","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Florey%2Fsocials","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Florey%2Fsocials/lists"}