Skip to content
This repository has been archived by the owner on Nov 3, 2019. It is now read-only.
/ caller-lookup Public archive

Reverse Caller Id using TrueCaller

License

Notifications You must be signed in to change notification settings

scottphilip/caller-lookup

Repository files navigation

Caller Lookup

Looks up any telephone number and returns known information about owner, including a score attribute that helps determine if the call is genuine or a marketing cold caller. This is helpful for looking up a caller id number before accepting.

Installation Instructions

pip install CallerLookup

Usage

with CallerLookup(username="[email protected]",
                  password="password",
                  secret="secret") as caller_lookup:

    result = caller_lookup.search(number="0202-456-1111", region_dial_code="1")
    print(str(result))

Output:

{
    "IS_VALID": True,
    "SCORE": 80.0,
    "RESULT": "SUCCESS",
    "REGION_DIAL_CODE": "1",
    "ADDRESS": "1600PennsylvaniaAveNW,
    TheWhiteHouse,
    Downtown,
    Washington,
    DC20006",
    "NUMBER_E164": "+12024561111",
    "REGION": "US",
    "NUMBER_NATIONAL": "(202)456-1111",
    "TIME_TAKEN": 0.701,
    "NAME": "WhiteHouse"
}

Dependencies

PyPI Packages:

  • GoogleToken
  • phonenumbers
  • cryptography
  • appdirs
  • requests
  • python-dateutil

Testing

Tested on Python:

  • 2.7
  • 3.6

Credits

Scott Philip

Berlin, Germany

Licence

GNU General Public License (Version 3, 29 June 2007)

CallerLookup Copyright © 2017 Scott Philip