⚒ Raw#
The next page contains raw functions that accept an instance of Me in the first parameter, make an API call and return raw data.
meapi maps the data to objects, but these functions can be accessed manually:
from meapi.api.raw.account import phone_search_raw, get_profile_raw
from meapi import Me
me = Me(972123456789) # initialize the client
search_res = phone_search_raw(me, 972987654321)
profile_res = get_profile_raw(me, 'fdsfs-fdsfs-fdsfs-fdsfs')
🔐 Auth#
- meapi.api.raw.auth.activate_account_raw(client: Me, phone_number: int, activation_code: str) Dict[str, str]#
Activate your account with the activation code.
- Parameters:
- Return type:
dict
Example:
{ "access": "eyxxxxKV1xxxxxx1NiJ9.xxx.xxx", "pwd_token": "xxxx-xxxx-xxxxx-xxxx-xxxxxxxxxxd2", "refresh": "xxxx.xxxxxx.xxxx-xxxxx-xxxx" }
- meapi.api.raw.auth.ask_for_call_raw(client: Me, phone_number: str, session_token: str) dict#
Ask Me to call you with the activation code.
- Parameters:
- Return type:
dict
Example:
{ "activation_type": "failb", "error_message": "", "provider_name": "TwilioCall", "success": True }
- meapi.api.raw.auth.ask_for_sms_raw(client: Me, phone_number: str, session_token: str) Dict[str, Union[str, bool]]#
Ask me to send you the activation code in SMS.
- Parameters:
- Return type:
dict
Example:
{ "activation_type": "sms", "error_message": "", "provider_name": "IsraelSms", "success": True }
👤 Account#
- meapi.api.raw.account.add_calls_raw(client: Me, calls: List[dict]) dict#
Add call to your calls log. See
upload_random_data().- Parameters:
- Returns:
dict with upload result.
- Return type:
dict
Example of list of calls to add:
[ { "called_at": "2021-07-29T11:27:50Z", "duration": 28, "name": "043437535", "phone_number": 43437535, "tag": None, "type": "missed", } ]
- meapi.api.raw.account.add_contacts_raw(client: Me, contacts: List[dict]) dict#
Upload new contacts to your Me account.
- Parameters:
- Return type:
dict
Example of list of contacts to add:
[ { "country_code": "XX", "date_of_birth": None, "name": "Chandler", "phone_number": 512145887, } ]
Example of results:
{ 'total': 1, 'added': 1, 'updated': 0, 'removed': 0, 'failed': 0, 'same': 0, 'result': [{ 'phone_number': 512145887, 'name': 'Chandler', 'email': None, 'referenced_user': None, 'created_at': '2022-06-25T22:28:41:955339Z', 'modified_at': '2022-06-25T22:28:41Z', 'country_code': 'XX', 'date_of_birth': None }], 'failed_contacts': [] }
- meapi.api.raw.account.block_numbers_raw(client: Me, numbers: List[int]) dict#
Block numbers.
- Parameters:
- Returns:
list of dicts with the blocked numbers.
- Return type:
List[
dict]
Example:
[ { "block_contact": True, "me_full_block": False, "phone_number": 1234567890 } ]
- meapi.api.raw.account.block_profile_raw(client: Me, phone_number: int, block_contact: bool, me_full_block: bool) dict#
Block user profile.
- Parameters:
- Returns:
Dict of results.
- Return type:
dict
Example of results:
{ 'success': True, 'message': 'Successfully block updated' }
- meapi.api.raw.account.get_blocked_numbers_raw(client: Me) List[dict]#
Get your blocked numbers.
Example:
[ { "block_contact": True, "me_full_block": False, "phone_number": 1234567890 } ]
- meapi.api.raw.account.get_my_profile_raw(client: Me) dict#
Get your profile.
Example:
{ 'first_name': 'Ross geller', 'last_name': '', 'facebook_url': '123456789', 'google_url': None, 'email': 'ross@friends.tv', 'profile_picture': 'https://d18zaexen4dp1s.cloudfront.net/dXXXXXXXXXXXXX26b.jpg', 'date_of_birth': '9999-12-12', 'gender': None, 'location_latitude': -37.57539, 'location_longitude': 31.30874, 'location_name': 'Argentina', 'phone_number': 387648734435, 'is_premium': False, 'is_verified': False, 'uuid': '3XXXb-3f7e-XXXX-XXXXX-XXXXX', 'slogan': 'Pivot!', 'device_type': 'ios', 'carrier': 'BlaMobile', 'country_code': 'AR', 'phone_prefix': '387', 'gdpr_consent': True, 'login_type': 'apple', 'verify_subscription': True }
- meapi.api.raw.account.get_profile_raw(client: Me, uuid: str = None) dict#
Get other users profile.
- Parameters:
- Returns:
Dict with profile details
- Return type:
dict
Example:
{ "comments_blocked": False, "is_he_blocked_me": False, "is_permanent": False, "is_shared_location": False, "last_comment": None, "mutual_contacts_available": True, "mutual_contacts": [ { "phone_number": 1234567890, "name": "Ross geller", "referenced_user": { "email": "rossgeller@friends.com", "profile_picture": "https://d18zaexen4dp1s.cloudfront.net/59XXXXXXXXXXXXXXXX67.jpg", "first_name": "Ross", "last_name": "", "gender": 'M', "uuid": "XXXX-XXX-XXX-83c1-XXXX", "is_verified": True, "phone_number": 3432434546546, "slogan": "Pivot!", "is_premium": False, "verify_subscription": True, }, "date_of_birth": '1980-03-13', } ], "profile": { "carrier": "XXX mobile", "comments_enabled": False, "country_code": "XX", "date_of_birth": '2222-05-20', "device_type": "android", "distance": None, "email": "user@domain.com", "facebook_url": "133268763438473", "first_name": "Chandler", "gdpr_consent": True, "gender": 'M', "google_url": None, "is_premium": False, "is_verified": True, "last_name": "Bing", "location_enabled": False, "location_name": "XXXX", "login_type": "email", "me_in_contacts": True, "phone_number": 123456789012, "phone_prefix": "123", "profile_picture": "https://d18zaexen4dp1s.cloudfront.net/5XXX712a0676XXXXXXXfa67.jpg", "slogan": "I will always be there for you", "user_type": "BLUE", "uuid": "XXXXXXXXXXXXXXXXXXX3c1-6932bc9eb597", "verify_subscription": True, "who_deleted_enabled": True, "who_watched_enabled": True, }, "share_location": False, "social": { "facebook": { "posts": [], "profile_id": "https://www.facebook.com/app_scoped_user_id/XXXXXXXXXXX/", "is_active": True, "is_hidden": True, }, "fakebook": { "is_active": False, "is_hidden": True, "posts": [], "profile_id": None, }, "instagram": { "posts": [ { "posted_at": "2021-12-23T22:21:06Z", "photo": "https://d18zaexen4dp1s.cloudfront.net/XXXXXXXXXXXXXX.jpg", "text_first": None, "text_second": "IMAGE", "author": "username", "redirect_id": "CXXXXIz-0", "owner": "username", } ], "profile_id": "username", "is_active": True, "is_hidden": False, }, "linkedin": { "is_active": True, "is_hidden": False, "posts": [], "profile_id": "https://www.linkedin.com/in/username", }, "pinterest": { "posts": [], "profile_id": "https://pin.it/XXXXXXXX", "is_active": True, "is_hidden": False, }, "spotify": { "is_active": True, "is_hidden": False, "posts": [ { "author": "Chandler bing", "owner": "4xgXXXXXXXt0pv", "photo": "https://d18zaexen4dp1s.cloudfront.net/9bcXXXfa7dXXXXXXXac.jpg", "posted_at": None, "redirect_id": "4KgES5cs3SnMhuAXuBREW2", "text_first": "My friends playlist songs", "text_second": "157", }, { "author": "Chandler Bing", "owner": "4xgoXcoriuXXXXpt0pv", "photo": "https://d18zaexen4dp1s.cloudfront.net/55d3XXXXXXXXXXXXXXXXXX4.jpg", "posted_at": None, "redirect_id": "3FjSXXXCQPB14Xt", "text_first": "My favorite songs!", "text_second": "272", }, ], "profile_id": "4xgot8coriuXXXXXpt0pv", }, "tiktok": { "is_active": False, "is_hidden": True, "posts": [], "profile_id": None, }, "twitter": { "is_active": True, "is_hidden": False, "posts": [ { "author": "username", "owner": "username", "photo": "https://pbs.twimg.com/profile_images/13XXXXX76/AvBXXXX_normal.jpg", "posted_at": "2021-08-24T10:02:45Z", "redirect_id": "https://twitter.com/username/status/1XXXXXX423", "text_first": "My tweet #1 https://t.co/PLXXXX2Tw https://t.co/zXXXXkk", "text_second": None, }, { "author": "username", "owner": "username", "photo": "https://pbs.twimg.com/profile_images/1318XXXX0976/AvBXXXUk_normal.jpg", "posted_at": "2021-08-12T10:09:23Z", "redirect_id": "https://twitter.com/username/status/142XXXXX86624", "text_first": "My second tweet https://t.co/xtqXXXtAC", "text_second": None, }, ], "profile_id": "username", }, }, }
- meapi.api.raw.account.phone_search_raw(client: Me, phone_number: Union[str, int]) dict#
Get information on any phone number.
- Parameters:
- Return type:
dict
Example for existed user:
{ "contact": { "name": "Chandler bing", "picture": None, "user": { "email": "user@domain.com", "profile_picture": "https://d18zaexXXp1s.cloudfront.net/5XXX971XXXXXXXXXfa67.jpg", "first_name": "Chandler", "last_name": "Bing", "gender": 'M', "uuid": "XXXXX-XXXX-XXXX-XXXX-XXXX", "is_verified": True, "phone_number": 7434872457, "slogan": "User bio", "is_premium": False, "verify_subscription": True, "id": 42453345, "comment_count": 0, "location_enabled": False, "distance": None, }, "suggested_as_spam": 0, "is_permanent": False, "is_pending_name_change": False, "user_type": "BLUE", "phone_number": 7434872457, "cached": True, "is_my_contact": False, "is_shared_location": False, } }
Example for non user:
{ "contact": { "name": "Chandler bing", "picture": None, "user": None, "suggested_as_spam": 0, "is_permanent": False, "is_pending_name_change": False, "user_type": "GREEN", "phone_number": 123456789, "cached": False, "is_my_contact": False, "is_shared_location": False, } }
- meapi.api.raw.account.remove_calls_raw(client: Me, calls: List[dict]) dict#
Remove call from your calls log
- Parameters:
- Returns:
dict with upload result.
- Return type:
dict
Example of list of calls to remove:
[ { "called_at": "2021-07-29T11:27:50Z", "duration": 28, "name": "043437535", "phone_number": 43437535, "tag": None, "type": "missed", } ]
- meapi.api.raw.account.remove_contacts_raw(client: Me, contacts: List[dict]) dict#
Remove contacts from your Me account.
- Parameters:
- Return type:
dict
Example of list of contacts to remove:
[ { "country_code": "XX", "date_of_birth": None, "name": "Chandler", "phone_number": 512145887, } ]
Example of results:
{ 'total': 1, 'added': 0, 'updated': 0, 'removed': 1, 'failed': 0, 'same': 0, 'result': [], 'failed_contacts': [] }
- Parameters:
contacts –
- meapi.api.raw.account.suspend_account_raw(client: Me) dict#
Suspend your account.
Example:
{ 'mutual_contacts_available': False, 'contact_suspended': True, 'last_backup_at': None, 'last_restore_at': None, 'who_watched_enabled': False, 'comments_enabled': False, 'language': 'en', 'notifications_enabled': False, 'location_enabled': False, 'names_notification_enabled': False, 'who_watched_notification_enabled': False, 'comments_notification_enabled': False, 'birthday_notification_enabled': False, 'system_notification_enabled': False, 'distance_notification_enabled': False, 'who_deleted_enabled': False, 'who_deleted_notification_enabled': False }
- meapi.api.raw.account.unblock_numbers_raw(client: Me, numbers: List[int]) dict#
Unblock phone numbers.
- Parameters:
- Returns:
dict with unblock success details.
- Return type:
dict
Example:
{ 'success': True, 'message': 'Phone numbers successfully unblocked' }
- meapi.api.raw.account.unblock_profile_raw(client: Me, phone_number: int, unblock_contact=True, me_full_unblock=True) dict#
Unlock user profile.
- Parameters:
- Returns:
Dict of results.
- Return type:
dict
Example of results:
{ 'success': True, 'message': 'Successfully block updated' }
- meapi.api.raw.account.update_fcm_token_raw(client: Me, fcm_token: str = None) dict#
Update FCM token.
- meapi.api.raw.account.update_profile_details_raw(client: Me, **kwargs) dict#
Update your profile details.
Example:
{ 'first_name': 'Joey', 'last_name': 'Tribbiani', 'facebook_url': '123456789', 'google_url': None, 'email': 'joeyt@friends.tv', 'profile_picture': 'https://refr.cloudfront.net/dde.jpg', 'date_of_birth': '1999-01-01', 'gender': 'M', 'location_latitude': -12.5465657, 'location_longitude': 32.454354, 'location_name': 'XX', 'phone_number': 95435436545765483, 'is_premium': False, 'is_verified': True, 'uuid': '3850f44b-3f7e-41cf-af6a-27ce13b64d0d', 'slogan': 'Joey doesnt share food!', 'device_type': 'ios', 'carrier': 'MobileBla', 'country_code': 'US', 'phone_prefix': '123', 'gdpr_consent': True, 'login_type': 'apple', 'verify_subscription': True }
- meapi.api.raw.account.upload_image_raw(client: Me, binary_img: bytes) dict#
Upload image to
Meservers.- Parameters:
- Returns:
dict with upload details.
- Return type:
dict
Example:
{ 'attributes': { 'image_type': 'jpeg' }, 'content_type': 'image/jpeg', 'created_at': '2022-07-20T20:40:09Z', 'deletion_msg': None, 'deletion_status': None, 'file_hash': '24edcdoisubas7afb94hd8w7a2c38', 'id': 422374926, 'is_processed': True, 'name': '165didw08856_temp.jpg', 'old_url': None, 'path': '/meapp-s3-files/ehfe9whufe9ufh9eww.jpg', 'processed_at': None, 'size': 0.0, 'url': 'https://d18zaexen4dp1s.cloudfront.net/24e9a99sdisfiseorew0b5a7a2c38.jpg' }
⚙️Settings#
- meapi.api.raw.settings.change_settings_raw(client: Me, **kwargs) dict#
Change current settings.
- Parameters:
kwargs – Dict with new settings.
- Returns:
Dict with settings.
- Return type:
dict
Example:
{ "birthday_notification_enabled": True, "comments_enabled": True, "comments_notification_enabled": True, "contact_suspended": False, "distance_notification_enabled": True, "language": "iw", "last_backup_at": None, "last_restore_at": None, "location_enabled": True, "mutual_contacts_available": True, "names_notification_enabled": True, "notifications_enabled": True, "system_notification_enabled": True, "who_deleted_enabled": True, "who_deleted_notification_enabled": True, "who_watched_enabled": True, "who_watched_notification_enabled": True, }
- meapi.api.raw.settings.get_settings_raw(client: Me) dict#
Get current settings.
- Returns:
Dict with settings.
- Return type:
dict
Example:
{ "birthday_notification_enabled": True, "comments_enabled": True, "comments_notification_enabled": True, "contact_suspended": False, "distance_notification_enabled": True, "language": "iw", "last_backup_at": None, "last_restore_at": None, "location_enabled": True, "mutual_contacts_available": True, "names_notification_enabled": True, "notifications_enabled": True, "spammers_count": 24615, "system_notification_enabled": True, "who_deleted_enabled": True, "who_deleted_notification_enabled": True, "who_watched_enabled": True, "who_watched_notification_enabled": True, }
🔔 Notifications#
- meapi.api.raw.notifications.get_notifications_raw(client: Me, page_number: int, results_limit: int, categories: Optional[List[str]] = None) dict#
Get notifications.
- Parameters:
page_number (
int) – Page number.results_limit (
int) – Number of results per page.categories (List[
str]) – List of categories to filter.
- Returns:
Dict with notifications.
- Return type:
dict
Example:
{ "count": 94, "next": "https://app.mobile.me.app/notification/notification/items/?page=2&page_size=30&status=distributed", "previous": None, "results": [ { "id": 103466332, "created_at": "2022-03-18T11:17:09Z", "modified_at": "2022-03-18T11:17:09Z", "is_read": False, "sender": "2e7XXX-84XXXX-4ec7-b6cb-d4XXXXXX", "status": "distributed", "delivery_method": "push", "distribution_date": "2022-03-18T11:17:09Z", "message_subject": None, "message_category": "BIRTHDAY", "message_body": None, "message_lang": "iw", "context": { "name": "Ross geller", "uuid": "2e7XXXX-XXXX-XXXX-b6cXb-d46XXXXX1", "category": "BIRTHDAY", "phone_number": 97849743536, "notification_id": None, "profile_picture": None, }, }, { "id": 18987495325, "created_at": "2022-04-06T11:18:03Z", "modified_at": "2022-04-06T11:18:03Z", "is_read": False, "sender": "5XXXXX0e-XXXX-XXXX-XXXX-XXXXXXX", "status": "distributed", "delivery_method": "push", "distribution_date": "2022-04-06T11:18:03Z", "message_subject": None, "message_category": "UPDATED_CONTACT", "message_body": None, "message_lang": "iw", "context": { "name": "Chandler", "uuid": "XXXXXX-XXXX-XXXXX-XXX-XXXXX", "category": "UPDATED_CONTACT", "new_name": "Your new name", "phone_number": 8479843759435, "notification_id": None, "profile_picture": None, }, }, { "id": 17983743351, "created_at": "2022-04-11T06:45:27Z", "modified_at": "2022-04-11T06:45:27Z", "is_read": False, "sender": "XXXXXX-XXXX-XXXXX-XXX-XXXXX", "status": "distributed", "delivery_method": "push", "distribution_date": "2022-04-11T06:45:27Z", "message_subject": None, "message_category": "CONTACT_ADD", "message_body": None, "message_lang": "iw", "context": { "name": "Monica", "uuid": "XXXXXX-XXXX-XXXXX-XXX-XXXXX", "category": "CONTACT_ADD", "new_name": "Ross", "phone_number": 878634535436, "notification_id": None, "profile_picture": None, } } ] }
- meapi.api.raw.notifications.read_notification_raw(client: Me, notification_id: int) dict#
Mark notification as read.
- Parameters:
notification_id (
int) – Notification ID.- Returns:
Dict with notification.
- Return type:
dict
Example:
{ 'id': 3487438454, 'created_at': '2022-06-28T22:12:36Z', 'modified_at': '2022-06-30T23:56:59Z', 'is_read': True, 'sender': 'fejdsfns-hdiu-ddv-83c1-hdisds', 'status': 'distributed', 'delivery_method': 'push', 'distribution_date': '2022-06-28T22:12:35Z', 'message_subject': None, 'message_category': 'NEW_COMMENT', 'message_body': None, 'message_lang': 'en', 'context': { 'name': 'Monica', 'uuid': 'dsfsds-dsfd-490a-dfdfg-dfoeiffs', 'category': 'NEW_COMMENT', 'phone_number': 972538607327, 'notification_id': None, 'profile_picture': 'https://dfsfs.cloudfront.net/dhiucds.jpg' } }