PhoneInfopy is a python tool to directly make request to Truecaller API's and get response. This module will allow you to register your number, validate OTP while registering and search information about a phone number.

Table to Contents

• PhoneInfoPy
  • Requirements
  • Command Line Usage
    • Installation
    • Login
    • Search Number
  • Module usage
    • Installation
    • Register
    • Validate OTP
    • Search phone number

To use PhoneInfopy module you need below pre requirements.

• valid mobile number
• python
• truecaller auth token [This token will get by login/register process]

You can install PhoneInfopy package using pip

• phoneinfopy -h [--help] for help
• phoneinfopy -l [--login] for login [Need to mention country code]
• phoneinfopy -c [--code] for country code
• phoneinfopy -i [--info] for search mobile number [Need to mention country code]

pip install phoneinfopy

python3 -m phoneinfopy.cli -c <countryCode> -l <phoneNumber>

python3 -m phoneinfopy.cli -c +91 -l 98xxxxxxxx

You can search phone number by using below command

python3 -m phoneinfopy.cli -c +91 -i 98xxxxxxxx

You can install the phoneinfopy moudle using pip:

pip install phoneinfopy

from phoneinfopy import register_phone_number

number = "+9198xxxxxxxx"
response = register_phone_number(number)

# register_phone_number method will return json object
# example:
# {
#   status : bool,
#   message: str
#   requestId: str
# }

Once you get success response from register method next you need to verify the OTP to get access token.

from phoneinfopy import validate_OTP

number = "+9198xxxxxxxx"
OTP = "123456"
requestId = "<you get this ID while register process>"
response = validate_OTP(number, OTP, requestId)

# validate_OTP method will return json object
# {
#   status: bool
#   message: str
#   access_token: str  [If OTP validatino is success]
# }

You need to get user information using phone number you can use like this..

from phoneinfopy import get_phone_info

target_number = "98xxxxxxxx"
country_code = "+91"
access_token = "a10--******" ["you get this token while validating OTP"]

response = get_phone_info(target_number, country_code, access_token)

# get_phone_info will return json object 
#{
#   status: bool
#   message: str
#   data: object [if user info found]
# }

Contributions to the phoneinfopy package are welcome!... If you faced any issue or you have good idea to improve please open a issue or submit a pull request.

• Instagram
• LinkedIn
• Youtube