ritiek / trunofficial

[NOT WORKING ANYMORE!] Unofficial API to the Truecaller phone number search

trunofficial

Unofficial API to the Truecaller phone number search.

Installation

pip install trunofficial

or if you like to live on the bleeding edge:

python setup.py install

Command-line Usage

usage: trunofficial [-h] [-c COUNTRYCODE] [NUMBER [NUMBER ...]]

Unofficial API to the Truecaller phone number search.

positional arguments:
  NUMBER                phone numbers to lookup on Truecaller

optional arguments:
  -h, --help            show this help message and exit
  -c COUNTRYCODE, --countrycode COUNTRYCODE
                        prioritize search by country

Example:

$ trunofficial 2024561111

Library Usage

>>> import trunofficial

>>> owner = trunofficial.search('2024561111')
>>> print(owner.name)

>>> mobile = owner.phone
>>> print(mobile.number)
>>> print(mobile.countrycode)
>>> print(mobile.carrier)

>>> house = owner.address
>>> print(house.city)
>>> print(house.timezone)

For more examples, check the examples directory or read the full Documentation.

Running Tests

python -m pytest test

Disclaimer

This method of accessing Truecaller's database may stop working any moment. Use it at your own risk.

License

The MIT License