tellows API Key for Phone Number Blacklist (Interface for Programmers) - 2 Years

The tellows API-Key

Thanks to the tellows API Key, programmers and telecommunications device developers are now able to query the tellows database through your telecommunications device (e.g. Asterisk). Regardless of whether you want to use the API Key as a real time block list or just to identify calls. Thanks to the great interest for the tellows score lists, we now want to offer our customers the possibility of a real-time caller protection. With the help of the API Key and a suitable phone system this is no longer a problem.

The API Key is an application programming interface and allows programmers and developers access through their telephone system to the tellows database and therefore to both trustworthy and dubious numbers, including their ratings.  No matter which telecommunications device they use, as long as there is access to the Internet and the API Key is compatible, there should not be a problem for a real-time query to be sent to the tellows server.

The tellows score enables you to easily distinguish trustworthy calls from dubious ones. Calls are rated on a scale from 1 (trustworthy) to 9 (dubious) by the community. With more than 40,000 database entries and about 1.3 million visitors per month this makes your telecommunications device an effective weapon against unwanted calls. The protection is always up to date, therefore there is no need to download updates manually. The license is active for 2 years.
> More information about how to use the API you will find here

How do I get the API key?

After purchase, you can download the access data for the API key from your download area in the tellows shop. To do this, click on the link in the download area of ​​your user account. A new page opens with your access data to the API.

Attention We recommend opening the download link to your access data via Mozilla Firefox or Internet Explorer. Google Chrome may not be able to read the file extension correctly. If this is the case, you can open the file by changing the file extension to ".html".

How do I use the API key?

We recommend using the Scorelist API for the application, which contains a list of all relevant phone numbers and details about the number and is matched for incoming calls.

The partner name of the key is tellowskey and is required for the request. The URLs for the queries can be customised for individual results with parameters within the download URL. This allows you to refine the output and, for example, only display phone numbers with a desired minimum score or minimum number of comments.

Advantages
- Daily update of current lists according to parameters (e.g. score, number of comments)
- Clear display of the most relevant data fields (most used caller name, area code, most used caller category)
- Fast checking of numbers with the locally stored score list, as no real-time server request is necessary

A detailed insight into the tellows API with all available parameters can be found in our documentation:
> Documentation of the tellows Scorelist API

> More information about the tellows products and API

The API key can only be used with developer knowledge. Please note that we cannot offer technical support for the integration.

Disclaimer regarding commercial and the non-commercial use
The API Key is solely used for private purposes.
> tellows API Key for Commercial Use
> Further information about the tellows Partner Program