Skip to main content

NulledAPI - UnOfficial Nulled API

Project description

NulledAPI - Unofficial Nulled.to API

NulledAPI is an unofficial nulled.to API to better and more easily integrate features such as a ramped up version of nulled auth, and have access to useful functions such as searching for users, getting user info (much more functions in the works).

It has been created by M3GZ

REQUIREMENTS:

Python 3

INSTALLATION:

pip install nulledapi

EXAMPLE USAGE:

from nulledapi import Nulled
nulled = Nulled()
print(nulled.get_user_info(1234144))
Output

(In Dict Format)

{
    'user_found': True,
    'username': 'finndev',
    'id': 1234144,
    'group': 'reverser',
    'shouts': 1,
    'discord': None,
    'error': (False, 'NO_ERROR_USER_FOUND')
}

METHODS:

  1. auth(auth_code: str)

    Returns dictionary in the format below

    Example usage
    print(nulled.auth('NULLED-5E72C-60984-4D332-5B526-X'))

    {
    	'authenticated': True,
    	'user_found': True,
    	'username': 'M3GZ',
    	'id': 4103370,
    	'group': 'aqua',
    	'shouts': 348,
    	'discord': '_megz#1304',
    	'error': (False, 'NO_ERROR_USER_FOUND')
    }
    

    Now you can limit parts of your programs for different usergroups Kappa

    Parameters
    auth_code : str Description: Nulled auth code (https://www.nulled.to/auth.php)

  2. get_user_info(user_name_or_id, secure_hash, session_id)

    Returns dictionary in the format below

    Example usage
    print(nulled.get_user_info('brian','secure_hash','session_id'))
    OR
    print(nulled.get_user_info(1468487))

    {
    	'user_found': True,
    	'username': 'Brian',
    	'id': 1468487,
    	'group': 'disinfector',
    	'shouts': 2381,
    	'discord': None,
    	'error': (False, 'NO_ERROR_USER_FOUND')
    }
    
    Go crazy with the information, information is power, especially when it's just one line of code to get it

    Parameters
    1. user_name_or_id : str/int Description: Use either UID or username UID: Standalone usage Username: You need to put in your session_id and secure_hash (Check notes)

     2. secure_hash : str, not required with UID
         Description: Your nulled.to secure_hash
             UID: Standalone usage
             Username: You need to put in your secure_hash
                       (Check notes)
    
     3. session_id : str, not required with UID
         Description: Your nulled.to secure_hash
             UID: Standalone usage
             Username: You need to put in your latest session_id
                       (Check notes)
    
  3. search_user(username: str, secure_hash: str, session_id: str)

    Returns dictionary of all similarly named users found

    Example usage
    print(nulled.search_user('m3gz','secure_hash','session_id'))

    {
        '4103370': {        #Dict keys are the UIDs
            'name': 'M3GZ',
            'group': 'Aqua',
            'profile_pic': 'https://www.nulled.to/uploads/profile/photo-thumb-4103370.png?_r=1598880866'
        },
        '2515890': {
            'name': 'm3gzz',
            'group': 'Members',
            'profile_pic': 'https://media.nulled.to/public/style_images/images/profile/default_large.png'
        }
    }
    
    User search function might be useful to get user-list for various purposes,
    you could check each user with get_user_info() to get more information

    Parameters
    1. username : str Description: Username to search

     2. secure_hash : str
         Description: Your nulled.to secure_hash
         You need to put in your secure_hash
         (Check notes)
    
     3. session_id : str
         Description: Your nulled.to secure_hash
         You need to put in your latest session_id
         (Check notes)
    
  4. More functions WIP

Notes

To get the session_id and secure_hash:

  1. Open any nto page on your browser being logged in
  2. Then press Ctrl + U
  3. In the source page, search for the term secure_hash
  4. There'll be a line like ipb.vars['secure_hash'] = 'xyz';
    xyz is the secure_hash, use that in the methods
  5. The line below the secure_hash line will contain the session_id

Note: session_id keeps changing occasionally, so you'll need to input the latest one while calling the method.

Documentation can also be viewed using Visual Studio Code - https://i.imgur.com/PkEUaLo.png
While we are on the topic, might I suggest using VSCodium

Important: The API might fail to return results if Nulled is having cloudflare (or any general) errors.
If you keep getting error codes like BAD_SESSION_ID_OR_CF_ERROR even with the correct session_id, open your browser page, solve the cloudflare captcha and run the code again.
Unfortunately this will be an issue till the stable release of V4.

Made with 🖤 by M3GZ
For Terms of Service visit https://bit.ly/3aeIVfl

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for NulledAPI, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size NulledAPI-1.0.4-py3-none-any.whl (5.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size NulledAPI-1.0.4.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page