TelCheck offers two tools for webmasters and developers who want to integrate phone reputation data into their site or application: a ready-to-use iframe widget and a REST API for more advanced integrations. This guide explains how to use both, their use cases and best practices.
The iframe widget: one-line integration
Embed the TelCheck widget via an iframe pointing to https://telcheck.fr/embed/{number} — replace {number} with the number in national or international format. Example: <iframe src="https://telcheck.fr/embed/0612345678" width="320" height="200" frameborder="0"></iframe>. The widget displays the reputation score, the colour-coded risk badge, and a summary of the main TelCheck community reports. It is responsive and adapts to the available width.
Widget use cases
- Consumer forums: embed next to discussions about a suspicious number to show live reputation data.
- Classified ad sites: show a seller's TelCheck score alongside their contact number to reassure buyers.
- Blogs and news sites: illustrate a scam article with the widget for the relevant number.
- Internal business tools: integrate reputation checks into a call management system or CRM.
The REST API: programmatic integration
TelCheck exposes a REST API at /api/phone/{number}. It returns a JSON object containing the reputation score, dominant category, report count, number location and other metadata. Consult the API Docs page on TelCheck for the full schema and rate-limit details.
Integration best practices
- Cache responses for at least one hour — TelCheck reputation data changes slowly.
- Handle errors gracefully — show a neutral fallback if the API is temporarily unavailable.
- Be transparent — indicate that data comes from TelCheck and the TelCheck community.
- Attribution — a visible link to telcheck.fr helps grow the community and improves scores for everyone.