crdc.be Belgium Number Provider Lookup

English / Français

Fast Belgian number provider lookup powered by crdc.be through a backend API workflow.
Look up Belgian phone numbers, normalize supported formats, and return the detected provider in clean JSON output.

Recherche rapide du fournisseur/opérateur d’un numéro belge via crdc.be avec un workflow basé sur une API backend.
Vérifiez des numéros belges, normalisez les formats pris en charge et récupérez l’opérateur détecté dans une sortie JSON propre.

---

English

Overview

This Actor checks Belgian phone numbers through a backend lookup API connected to crdc.be.
It is designed for simple bulk processing in Apify without exposing the backend URL or API key to users.

The Actor sends each number to the backend, stores one result per number in the dataset, and generates a final summary in the Actor output.

What this Actor does

• Checks Belgian phone numbers using a crdc.be-powered backend
• Accepts multiple Belgian number formats
• Normalizes numbers to Belgian local format when possible
• Returns structured output for each processed number
• Supports bulk processing with a configurable safety limit
• Produces a final run summary

Supported input formats

Examples of accepted formats:

• 0493189190
• 493189190
• 32493189190
• +32493189190
• 0032493189190

Typical use cases

• Belgian telecom operator verification
• Phone number enrichment
• Lead validation
• Internal telecom checks
• Bulk provider lookup for Belgian numbers

How it works

1. The Actor reads the input list of numbers.
2. It removes empty values and duplicate entries.
3. It sends each number to the backend lookup API.
4. It stores one dataset item per processed number.
5. It writes a final summary to the Actor output.

Input

Example input

{
  "numbers": [
    "0493189190",
    "+32493189190",
    "32493189190"
  ],
  "timeoutSec": 25,
  "maxNumbers": 100
}

Input fields

Field	Type	Description
numbers	array	List of Belgian phone numbers to check
timeoutSec	integer	HTTP timeout per lookup request
maxNumbers	integer	Maximum number of numbers to process in one run

Output

Each processed number produces one dataset item.

Example successful result

{
  "success": true,
  "status": "ok",
  "message": "Provider found",
  "input_number": "0493189190",
  "normalized_number": "0493189190",
  "provider": "Proximus",
  "captcha_used": true,
  "duration_sec": 1.78,
  "_http_status": 200
}

Example not found result

{
  "success": true,
  "status": "not_found",
  "message": "Provider not found",
  "input_number": "0493000000",
  "normalized_number": "0493000000",
  "provider": null,
  "captcha_used": true,
  "duration_sec": 1.81,
  "_http_status": 200
}

Example timeout result

{
  "success": false,
  "status": "upstream_timeout",
  "message": "Backend request timed out",
  "input_number": "0493189190",
  "normalized_number": null,
  "provider": null,
  "captcha_used": null,
  "duration_sec": null,
  "_http_status": 504
}

Status values

Common status values returned by the Actor or backend include:

• ok – provider found successfully
• not_found – no provider returned for the number
• bad_request – invalid input format
• unauthorized – backend rejected the request
• upstream_timeout – backend request timed out
• network_error – connection problem while calling the backend
• invalid_response – backend returned an unexpected response
• error – unexpected processing failure

Run summary output

At the end of the run, the Actor also writes a summary output like:

{
  "success": true,
  "processed": 3,
  "ok_count": 2,
  "not_found_count": 1,
  "error_count": 0,
  "message": "Actor finished successfully"
}

Notes

• This Actor is based on a backend API workflow, not a direct browser workflow
• Users do not need to configure the backend URL or backend API key in input
• Large runs should be tested gradually before scaling up

Limitations

• Results depend on the current behavior of the backend lookup service
• The upstream source may change at any time
• Some numbers may return not_found or timeout depending on upstream conditions

Changelog

0.1

• Initial Apify Actor release
• Bulk Belgian number provider lookup
• Clean dataset output
• Summary output per run

---

Français

Présentation

Cet Actor vérifie des numéros de téléphone belges via une API backend connectée à crdc.be.
Il est conçu pour un traitement simple en masse sur Apify, sans exposer l’URL du backend ni la clé API aux utilisateurs.

L’Actor envoie chaque numéro à l’API de recherche, enregistre un résultat par numéro dans le dataset, puis écrit un résumé final dans la sortie de l’Actor.

Ce que fait l’Actor

• Vérifie des numéros belges via un backend alimenté par crdc.be
• Accepte plusieurs formats de numéros belges
• Normalise les numéros au format local belge quand c’est possible
• Retourne une sortie structurée pour chaque numéro traité
• Permet le traitement en masse avec une limite de sécurité configurable
• Produit un résumé final du run

Formats d’entrée pris en charge

Exemples de formats acceptés :

• 0493189190
• 493189190
• 32493189190
• +32493189190
• 0032493189190

Cas d’usage

• Vérification de l’opérateur télécom belge
• Enrichissement de numéros de téléphone
• Validation de leads
• Contrôles télécom internes
• Recherche en masse du fournisseur pour des numéros belges

Fonctionnement

1. L’Actor lit la liste des numéros en entrée.
2. Il supprime les valeurs vides et les doublons.
3. Il envoie chaque numéro à l’API backend.
4. Il enregistre un élément de dataset par numéro traité.
5. Il écrit un résumé final dans la sortie de l’Actor.

Entrée

Exemple d’entrée

{
  "numbers": [
    "0493189190",
    "+32493189190",
    "32493189190"
  ],
  "timeoutSec": 25,
  "maxNumbers": 100
}

Champs d’entrée

Champ	Type	Description
numbers	array	Liste de numéros de téléphone belges à vérifier
timeoutSec	integer	Délai HTTP maximum par requête
maxNumbers	integer	Nombre maximal de numéros à traiter dans un run

Sortie

Chaque numéro traité produit un élément dans le dataset.

Exemple de résultat réussi

{
  "success": true,
  "status": "ok",
  "message": "Provider found",
  "input_number": "0493189190",
  "normalized_number": "0493189190",
  "provider": "Proximus",
  "captcha_used": true,
  "duration_sec": 1.78,
  "_http_status": 200
}

Exemple de résultat non trouvé

{
  "success": true,
  "status": "not_found",
  "message": "Provider not found",
  "input_number": "0493000000",
  "normalized_number": "0493000000",
  "provider": null,
  "captcha_used": true,
  "duration_sec": 1.81,
  "_http_status": 200
}

Exemple de dépassement de délai

{
  "success": false,
  "status": "upstream_timeout",
  "message": "Backend request timed out",
  "input_number": "0493189190",
  "normalized_number": null,
  "provider": null,
  "captcha_used": null,
  "duration_sec": null,
  "_http_status": 504
}

Valeurs possibles du statut

Les statuts courants retournés par l’Actor ou le backend sont :

• ok – fournisseur trouvé avec succès
• not_found – aucun fournisseur retourné pour ce numéro
• bad_request – format d’entrée invalide
• unauthorized – requête refusée par le backend
• upstream_timeout – délai dépassé côté backend
• network_error – problème de connexion vers le backend
• invalid_response – réponse inattendue du backend
• error – erreur de traitement non prévue

Résumé final du run

À la fin du run, l’Actor écrit aussi un résumé du type :

{
  "success": true,
  "processed": 3,
  "ok_count": 2,
  "not_found_count": 1,
  "error_count": 0,
  "message": "Actor finished successfully"
}

Remarques

• Cet Actor utilise un workflow backend API, pas un navigateur direct
• Les utilisateurs n’ont pas besoin de configurer l’URL du backend ni la clé API dans l’entrée
• Il est préférable de tester progressivement avant de lancer de gros volumes

Limites

• Les résultats dépendent du comportement actuel du service backend
• La source amont peut changer à tout moment
• Certains numéros peuvent retourner not_found ou un timeout selon les conditions amont

Journal des versions

0.1

• Première version de l’Actor Apify
• Recherche en masse du fournisseur pour des numéros belges
• Sortie dataset propre
• Résumé final par run