https://github.com/lorey/socials

👨‍👩‍👦 Social account detection and extraction in Python, e.g. for crawling/scraping.
https://github.com/lorey/socials

crawling facebook instagram linkedin python scraping social-network

Last synced: about 2 months ago
JSON representation

👨‍👩‍👦 Social account detection and extraction in Python, e.g. for crawling/scraping.

• Host: GitHub
• URL: https://github.com/lorey/socials
• Owner: lorey
• License: other
• Created: 2018-05-13T15:59:42.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-12-26T20:37:03.000Z (almost 2 years ago)
• Last Synced: 2024-09-16T23:34:21.743Z (3 months ago)
• Topics: crawling, facebook, instagram, linkedin, python, scraping, social-network
• Language: Python
• Homepage: https://socials.readthedocs.io/
• Size: 35.2 KB
• Stars: 46
• Watchers: 3
• Forks: 9
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
=======

Socials

=======

.. image:: https://img.shields.io/pypi/v/socials.svg

        :target: https://pypi.python.org/pypi/socials

.. image:: https://img.shields.io/travis/lorey/socials.svg

        :target: https://travis-ci.org/lorey/socials

.. image:: https://readthedocs.org/projects/socials/badge/?version=latest

        :target: https://socials.readthedocs.io/en/latest/?badge=latest

        :alt: Documentation Status

Social Account Detection and Extraction for Python

* Free software: GNU General Public License v3

* Documentation: https://socials.readthedocs.io.

* Source: https://github.com/lorey/socials

Features

--------

* Detect and extract URLs of social accounts: throw in URLs, get back URLs of social media profiles by type.

* Currently supports Facebook, Twitter, LinkedIn, GitHub, and Emails.

Usage

-----

Install it with ``pip install socials`` and use it as follows:

.. code-block:: python

    >>> hrefs = ['https://facebook.com/peterparker', 'https://techcrunch.com', 'https://github.com/lorey']

    >>> socials.extract(hrefs).get_matches_per_platform()

    {'github': ['https://github.com/lorey'], 'facebook': ['https://facebook.com/peterparker']}

    >>> socials.extract(hrefs).get_matches_for_platform('github')

    ['https://github.com/lorey']

Read more about `usage in our documentation`_.

.. _usage in our documentation: https://socials.readthedocs.io/en/latest/usage.html

Socials API

--------

There's also `an API called Socials API`_ that allows you to use the functionality via REST.

You can use a `free online version`_, try it in the browser, or deploy it yourself.

.. _an API called Socials API: https://github.com/lorey/socials-api

.. _free online version: https://socials.karllorey.com

Development

-----------

* Create virtual envirenment ``venv`` with ``virtualenv -p /usr/bin/python3 venv``.

* Activate the environment with ``source venv/bin/activate``.

* Install the development requirements with ``pip install -r requirements-dev.txt``.

* Run the tests: ``tox`` or ``python setup.py test``

Credits

-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter

.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage