Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/scottphilip/caller-lookup

Reverse Caller Id using TrueCaller
https://github.com/scottphilip/caller-lookup

agi asterisk asterisk-pbx callerid cid cname coldcalls freepbx marketing nuisancecalls pbx spam superfecta truecaller voip wrapper

Last synced: 3 months ago
JSON representation

Reverse Caller Id using TrueCaller

Host: GitHub
URL: https://github.com/scottphilip/caller-lookup
Owner: scottphilip
License: gpl-3.0
Archived: true
Created: 2017-04-25T05:58:54.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2018-06-07T03:58:50.000Z (about 6 years ago)
Last Synced: 2024-03-30T10:22:47.705Z (3 months ago)
Topics: agi, asterisk, asterisk-pbx, callerid, cid, cname, coldcalls, freepbx, marketing, nuisancecalls, pbx, spam, superfecta, truecaller, voip, wrapper
Language: Python
Size: 248 KB
Stars: 68
Watchers: 9
Forks: 20
Open Issues: 0
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES
- License: LICENSE

Lists

awesome-stars - scottphilip/caller-lookup - Reverse Caller Id using TrueCaller (Python)

README

.. image:: https://img.shields.io/pypi/v/CallerLookup.svg
:target: https://pypi.python.org/pypi/CallerLookup

.. image:: https://img.shields.io/pypi/pyversions/CallerLookup.svg
:target: https://pypi.python.org/pypi/CallerLookup

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
-----

.. code:: python

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:

.. code:: json

{
"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)