meapi


Namemeapi JSON
Version 0.6.6 PyPI version JSON
download
home_page
SummaryUnofficial api for 'Me - Caller ID & Spam Blocker' app
upload_time2023-02-04 21:32:39
maintainer
docs_urlNone
authorDavid Lev
requires_python
licenseMIT
keywords me caller id spam blocker meapi
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. image:: https://user-images.githubusercontent.com/42866208/164977163-2837836d-15bd-4a75-88fd-4e3fe2fd5dae.png
  :width: 95
  :alt: Me Logo
.. end-logo

`meapi <https://github.com/david-lev/meapi>`_: Unofficial api for 'Me - Caller ID & Spam Blocker'
##################################################################################################


.. image:: https://img.shields.io/pypi/dm/meapi?style=flat-square
    :alt: PyPI Downloads
    :target: https://pypi.org/project/meapi/

.. image:: https://badge.fury.io/py/meapi.svg
    :alt: PyPI Version
    :target: https://badge.fury.io/py/meapi

.. image:: https://www.codefactor.io/repository/github/david-lev/meapi/badge/main
   :target: https://www.codefactor.io/repository/github/david-lev/meapi/overview/main
   :alt: CodeFactor

.. image:: https://readthedocs.org/projects/meapi/badge/?version=latest&style=flat-square
   :target: https://meapi.readthedocs.io
   :alt: Docs

.. image:: https://badges.aleen42.com/src/telegram.svg
   :target: https://t.me/me_api
   :alt: Telegram

________________________

☎️ **meapi** is a Python3 library to identify, discover and get information about phone numbers, indicate and report spam, get and manage socials, profile management and much more.

🔐 To **get started**, read the `Setup guide <https://meapi.readthedocs.io/en/latest/content/setup.html>`_.

📖 For a **complete documentation** of available functions, see the `Reference <https://meapi.readthedocs.io/en/latest/content/reference.html>`_.

>>️ *For more information about Me® -* `Click here <https://meapp.co.il/>`_.


🎛 Installation
--------------
.. installation

- **Install using pip3:**

.. code-block:: bash

    pip3 install -U meapi

- **Install from source:**

.. code-block:: bash

    git clone https://github.com/david-lev/meapi.git
    cd meapi && python3 setup.py install

.. end-installation

🎉 **Features**
---------------

🔎 Searching:
^^^^^^^^^^^^^

* 📞 Search phone numbers
* 😎 Get full user profile: profile picture, birthday, location, platform, socials and more
* 🚫 Spam indication and report

🌐 Social:
^^^^^^^^^^

* 📱 Get user social networks: facebook, instagram, twitter, spotify and more
* ✍️ See how people call you
* 🙌 Get mutual contacts
* 👁 See who watched your profile
* 🗑 See who deleted you from his contacts book
* 💬 Get, publish and manage comments
* 📍 Get users location
* 🔔 Read app notifications

⚙️ Settings:
^^^^^^^^^^^^^

* ✏ Change profile information
* 🛡 Configure social settings
* 🔗 Connect social networks (And get verified blue check)
* ⬆ Upload contacts and calls history
* ⛔ Block profiles and numbers
* ❌ Delete or suspend your account


👨‍💻 **Usage**
----------------
.. code-block:: python

    from meapi import Me

    # Initialize the Client:
    me = Me(phone_number=972123456789, interactive_mode=True)
    # me = Me(access_token='eyJ0eXAiOiJ') # If you have official access token

    # ☎ Get information about any phone number:
    search_res = me.phone_search('+972548776658')
    if search_res:
        print(search_res.name)

    # 😎 Get user full profile:
    if search_res.user:
        profile = search_res.get_profile()
        print(profile.email, profile.date_of_birth, profile.slogan)

        # 📱 Get social media accounts:
        for social in profile.social:
            if social.is_active:
                print(f"Social media ({social.name}): {social.profile_url}")
                for post in social.posts:
                    print(f"Post from {post.posted_at}:\n{post.text_first}\n{post.text_second}")

    # 💬 Watch, approve and like comments:
    for comment in me.get_comments():
        print(f"Comment from {comment.author.name} at {comment.created_at}: {comment.message}")
        if comment.status == 'waiting':
            comment.approve()
        comment.like()

    # ✍️ Change your profile details:
    my_profile = me.get_my_profile()
    my_profile.first_name = 'David'

    # 🎴 Get your profile in vCard format:
    with open('~/Downloads/my_vcard.vcf', 'w') as f:
        f.write(my_profile.as_vcard(dl_profile_picture=True))

    # 👥 See how people call you:
    for group in me.get_groups(sorted_by='count'):
        print(f"People named you {group.name} {group.count} times")

    # 👁 who watched your profile:
    for watcher in me.who_watched(incognito=True, sorted_by='last_view'):
        print(f"The user {watcher.user.name} watched you {watcher.count} times")

    # 🗑 who deleted you:
    for deleted in me.who_deleted():
        print(f"The user {deleted.user.name} deleted you at {deleted.created_at}")

    # ➕ And much much more...

📚 For more usage examples, read the `Examples <https://meapi.readthedocs.io/en/latest/content/examples.html>`_ page.

💾 **Requirements**
--------------------

- Python 3.6 or higher - https://www.python.org

📖 **Setup and Usage**
-----------------------

See the `Documentation <https://meapi.readthedocs.io/>`_ for detailed instructions

⛔ **Disclaimer**
------------------

**This application is intended for educational purposes only. Any use in professional manner or to harm anyone or any organization doesn't relate to me and can be considered as illegal.
Me name, its variations and the logo are registered trademarks of NFO LTD. I have nothing to do with the registered trademark.
I'm also not responsible for blocked accounts or any other damage caused by the use of this library. it is always
recommended to use virtual phone numbers for testing purposes.**

.. end-readme

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "meapi",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "me,caller id,spam blocker,meapi",
    "author": "David Lev",
    "author_email": "davidlev@telegmail.com",
    "download_url": "https://files.pythonhosted.org/packages/82/b6/ee34994297671c1cd7fbfda1d2af0f9ac5e6a86610fb36db30c60b8b8c54/meapi-0.6.6.tar.gz",
    "platform": null,
    "description": ".. image:: https://user-images.githubusercontent.com/42866208/164977163-2837836d-15bd-4a75-88fd-4e3fe2fd5dae.png\n  :width: 95\n  :alt: Me Logo\n.. end-logo\n\n`meapi <https://github.com/david-lev/meapi>`_: Unofficial api for 'Me - Caller ID & Spam Blocker'\n##################################################################################################\n\n\n.. image:: https://img.shields.io/pypi/dm/meapi?style=flat-square\n    :alt: PyPI Downloads\n    :target: https://pypi.org/project/meapi/\n\n.. image:: https://badge.fury.io/py/meapi.svg\n    :alt: PyPI Version\n    :target: https://badge.fury.io/py/meapi\n\n.. image:: https://www.codefactor.io/repository/github/david-lev/meapi/badge/main\n   :target: https://www.codefactor.io/repository/github/david-lev/meapi/overview/main\n   :alt: CodeFactor\n\n.. image:: https://readthedocs.org/projects/meapi/badge/?version=latest&style=flat-square\n   :target: https://meapi.readthedocs.io\n   :alt: Docs\n\n.. image:: https://badges.aleen42.com/src/telegram.svg\n   :target: https://t.me/me_api\n   :alt: Telegram\n\n________________________\n\n\u260e\ufe0f **meapi** is a Python3 library to identify, discover and get information about phone numbers, indicate and report spam, get and manage socials, profile management and much more.\n\n\ud83d\udd10 To **get started**, read the `Setup guide <https://meapi.readthedocs.io/en/latest/content/setup.html>`_.\n\n\ud83d\udcd6 For a **complete documentation** of available functions, see the `Reference <https://meapi.readthedocs.io/en/latest/content/reference.html>`_.\n\n>>\ufe0f *For more information about Me\u00ae -* `Click here <https://meapp.co.il/>`_.\n\n\n\ud83c\udf9b Installation\n--------------\n.. installation\n\n- **Install using pip3:**\n\n.. code-block:: bash\n\n    pip3 install -U meapi\n\n- **Install from source:**\n\n.. code-block:: bash\n\n    git clone https://github.com/david-lev/meapi.git\n    cd meapi && python3 setup.py install\n\n.. end-installation\n\n\ud83c\udf89 **Features**\n---------------\n\n\ud83d\udd0e Searching:\n^^^^^^^^^^^^^\n\n* \ud83d\udcde Search phone numbers\n* \ud83d\ude0e Get full user profile: profile picture, birthday, location, platform, socials and more\n* \ud83d\udeab Spam indication and report\n\n\ud83c\udf10 Social:\n^^^^^^^^^^\n\n* \ud83d\udcf1 Get user social networks: facebook, instagram, twitter, spotify and more\n* \u270d\ufe0f See how people call you\n* \ud83d\ude4c Get mutual contacts\n* \ud83d\udc41 See who watched your profile\n* \ud83d\uddd1 See who deleted you from his contacts book\n* \ud83d\udcac Get, publish and manage comments\n* \ud83d\udccd Get users location\n* \ud83d\udd14 Read app notifications\n\n\u2699\ufe0f Settings:\n^^^^^^^^^^^^^\n\n* \u270f Change profile information\n* \ud83d\udee1 Configure social settings\n* \ud83d\udd17 Connect social networks (And get verified blue check)\n* \u2b06 Upload contacts and calls history\n* \u26d4 Block profiles and numbers\n* \u274c Delete or suspend your account\n\n\n\ud83d\udc68\u200d\ud83d\udcbb **Usage**\n----------------\n.. code-block:: python\n\n    from meapi import Me\n\n    # Initialize the Client:\n    me = Me(phone_number=972123456789, interactive_mode=True)\n    # me = Me(access_token='eyJ0eXAiOiJ') # If you have official access token\n\n    # \u260e Get information about any phone number:\n    search_res = me.phone_search('+972548776658')\n    if search_res:\n        print(search_res.name)\n\n    # \ud83d\ude0e Get user full profile:\n    if search_res.user:\n        profile = search_res.get_profile()\n        print(profile.email, profile.date_of_birth, profile.slogan)\n\n        # \ud83d\udcf1 Get social media accounts:\n        for social in profile.social:\n            if social.is_active:\n                print(f\"Social media ({social.name}): {social.profile_url}\")\n                for post in social.posts:\n                    print(f\"Post from {post.posted_at}:\\n{post.text_first}\\n{post.text_second}\")\n\n    # \ud83d\udcac Watch, approve and like comments:\n    for comment in me.get_comments():\n        print(f\"Comment from {comment.author.name} at {comment.created_at}: {comment.message}\")\n        if comment.status == 'waiting':\n            comment.approve()\n        comment.like()\n\n    # \u270d\ufe0f Change your profile details:\n    my_profile = me.get_my_profile()\n    my_profile.first_name = 'David'\n\n    # \ud83c\udfb4 Get your profile in vCard format:\n    with open('~/Downloads/my_vcard.vcf', 'w') as f:\n        f.write(my_profile.as_vcard(dl_profile_picture=True))\n\n    # \ud83d\udc65 See how people call you:\n    for group in me.get_groups(sorted_by='count'):\n        print(f\"People named you {group.name} {group.count} times\")\n\n    # \ud83d\udc41 who watched your profile:\n    for watcher in me.who_watched(incognito=True, sorted_by='last_view'):\n        print(f\"The user {watcher.user.name} watched you {watcher.count} times\")\n\n    # \ud83d\uddd1 who deleted you:\n    for deleted in me.who_deleted():\n        print(f\"The user {deleted.user.name} deleted you at {deleted.created_at}\")\n\n    # \u2795 And much much more...\n\n\ud83d\udcda For more usage examples, read the `Examples <https://meapi.readthedocs.io/en/latest/content/examples.html>`_ page.\n\n\ud83d\udcbe **Requirements**\n--------------------\n\n- Python 3.6 or higher - https://www.python.org\n\n\ud83d\udcd6 **Setup and Usage**\n-----------------------\n\nSee the `Documentation <https://meapi.readthedocs.io/>`_ for detailed instructions\n\n\u26d4 **Disclaimer**\n------------------\n\n**This application is intended for educational purposes only. Any use in professional manner or to harm anyone or any organization doesn't relate to me and can be considered as illegal.\nMe name, its variations and the logo are registered trademarks of NFO LTD. I have nothing to do with the registered trademark.\nI'm also not responsible for blocked accounts or any other damage caused by the use of this library. it is always\nrecommended to use virtual phone numbers for testing purposes.**\n\n.. end-readme\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Unofficial api for 'Me - Caller ID & Spam Blocker' app",
    "version": "0.6.6",
    "split_keywords": [
        "me",
        "caller id",
        "spam blocker",
        "meapi"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "82b6ee34994297671c1cd7fbfda1d2af0f9ac5e6a86610fb36db30c60b8b8c54",
                "md5": "3cacd6c56d91d9ead29dd85911a0c72b",
                "sha256": "ea795a5d64791c2524c0cb67723b719b9ba035443455024581693b8b5b2fa119"
            },
            "downloads": -1,
            "filename": "meapi-0.6.6.tar.gz",
            "has_sig": false,
            "md5_digest": "3cacd6c56d91d9ead29dd85911a0c72b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 66414,
            "upload_time": "2023-02-04T21:32:39",
            "upload_time_iso_8601": "2023-02-04T21:32:39.569238Z",
            "url": "https://files.pythonhosted.org/packages/82/b6/ee34994297671c1cd7fbfda1d2af0f9ac5e6a86610fb36db30c60b8b8c54/meapi-0.6.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-02-04 21:32:39",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "meapi"
}
        
Elapsed time: 0.09488s