Giter Club home page Giter Club logo

meapi's Introduction

Me Logo

meapi: Unofficial api for 'Me - Caller ID & Spam Blocker'

PyPI Downloads PyPI Version CodeFactor Docs 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 Authentication 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 user full 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

from meapi import Me

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

# ☎ Get information about any phone number:
search_res = me.phone_search('+865-456-234-12')
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:
    if profile.social.twitter.is_active:
        print(profile.social.twitter.profile_id)
        print(profile.social.twitter.posts)

# 💬 Watch and manage your comments:
for comment in me.get_comments():
    print(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'

# 👁 who watched your profile:
for watcher in me.who_watched(incognito=True, sorted_by='last_view'):
    print(watcher.user.name, watcher.count)

# 👥 See how people call you:
for group in me.get_groups():
    print(group.name, group.count)

# ➕ And much much more...

📚 For more usage examples, read the Examples page.

💾 Requirements

📖 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.

meapi's People

Contributors

david-lev avatar imgbotapp avatar maorgershman avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.