Données d’indicatifs en JSON

Identifiez fiablement les numéros, indicatifs et pays.

L’API phonecode.app fournit des données structurées sur les indicatifs locaux et internationaux, les numéros de service et d’urgence, et la conversion des numéros locaux au format international. Conçue pour les boutiques, CRM, outils d’assistance, formulaires de prospects et la qualité des données internes.

Créer une clé Démarrage rapide

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28 608 Enregistrements

5 200 Réseaux locaux allemands

206 pays et territoires

76 Plages de service et d’urgence

382 Plages mobiles

Démarrage rapide

Votre première requête en quelques minutes.

Vérifier le compte

Créez un compte client et vérifiez votre adresse e-mail.

Créer une clé

Créez une clé API. Sa valeur en clair n’est affichée qu’une seule fois.

Récupérer le JSON

Envoyez la clé uniquement comme Bearer Token dans l’en-tête Authorization.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

Transmettre les clés en sécurité

Les clés API ne doivent jamais figurer dans les URL, l’historique du navigateur, les journaux proxy ou les référents. Les paramètres de requête sont donc refusés.

Points d’accès

Des points d’accès JSON clairs pour la recherche, les comptes et la facturation.

GET

/api/search.php

Recherche les indicatifs, numéros de téléphone, lieux, pays et numéros de service ou d’urgence.

Paramètre	Description
q	Terme recherché, par exemple `030`, `Berlin`, `+44`, `0800`.
limit	Facultatif, de 1 à 50 résultats. Par défaut : 12.

GET

/api/internationalize.php

Convertit un numéro local d’un pays en format international copiable.

Paramètre	Description
number	Numéro local, par exemple `0343 222 1234`.
country	Code pays ISO du numéro, par exemple `GB`, `DE`, `AT`. Par défaut : `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

Renvoie l’état et les compteurs actuels des données.

GET

/api/billing/plans.php

Renvoie les offres API disponibles, les limites et l’état PayPal.

POST

/api/account/api-keys.php

Crée une clé API pour les utilisateurs connectés et vérifiés.

Format de réponse

Chaque résultat contient les données d’affichage, de validation et de formatage.

codeIndicatif ou plage de numéros, par exemple 030 ou +49.

nameLieu, pays, service ou désignation d’urgence.

kindOrt, Land, Region, Dienst, Notruf.

local_formatFormat d’affichage national recommandé.

international_formatFormat d’affichage international recommandé.

adviceConseil compréhensible sur les coûts, l’utilisation ou la numérotation.

Forfaits API

Des quotas mensuels prévisibles avec un usage gratuit équitable.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.