scottphilip / caller-lookup

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