meapi: Unofficial api for ‘Me - Caller ID & Spam Blocker’#

☎️ 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.

📖 For a complete documentation of available functions, see the Reference.

>>️ For more information about Me® - Click here.

🎛 Installation#

Install using pip3:

pip3 install -U meapi

Install from source:

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

🎉 Features#

🔎 Searching:#

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

⚙️ 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#

from meapi import Me

# Initialize the client in interactive mode:
me = Me(interactive_mode=True)

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

# 😎 Get user full profile:
if res.user:
    user = res.user
    print(f"{user.name=}, {user.email=}, {user.slogan=} {user.profile_picture=}")
    profile = res.get_profile()
    print(f"{profile.date_of_birth=}, {profile.location_name=}, {profile.gender=}, {profile.device_type=}")

    # 📱 Get social media accounts:
    for social in profile.social:
        if social:
            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}: {comment.message}")
    if comment.status == 'waiting':
        comment.approve()


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

# 🎴 Get your profile in vCard format:
with open('/home/david/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 page.

💾 Requirements#

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

📖 Setup and Usage#

See the Documentation 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.