Vorwahl-Daten per JSON
Telefonnummern, Vorwahlen und Länder zuverlässig erkennen.
Die vorwahl.app API liefert strukturierte Daten für Ortsvorwahlen, internationale Landesvorwahlen, Servicenummern, Notrufnummern und die Umwandlung lokaler Telefonnummern ins internationale Format. Entwickelt für Shops, CRM-Systeme, Support-Tools, Lead-Formulare und interne Datenqualität.
Quickstart
In wenigen Minuten zur ersten Abfrage.
Konto bestätigen
Registriere dich im Kundenkonto und bestätige deine E-Mail-Adresse.
API-Schlüssel erzeugen
Lege einen API-Schlüssel an. Er wird nur einmal im Klartext angezeigt.
JSON abrufen
Sende den Schlüssel als Bearer Token oder als Parameter api_key.
Bearer Token
curl "https://plant-id.de/api/search.php?q=040" \
-H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"Query Parameter
curl "https://plant-id.de/api/search.php?q=+43&limit=5&api_key=vwl_DEIN_API_SCHLUESSEL"Endpunkte
Klare JSON-Endpunkte für Suche, Konto und Billing.
GET
/api/search.php
Sucht nach Vorwahl, Telefonnummer, Ort, Land, Service- oder Notrufnummer.
| Parameter | Beschreibung |
|---|---|
| q | Suchbegriff, z. B. 030, Berlin, +44, 0800. |
| limit | Optional, 1 bis 50 Ergebnisse. Standard: 12. |
| api_key | Optional, wenn kein Bearer Token genutzt wird. |
GET
/api/internationalize.php
Wandelt eine lokale Telefonnummer eines Landes in ein internationales, kopierbares Format um.
| Parameter | Beschreibung |
|---|---|
| number | Lokale Nummer, z. B. 0343 222 1234. |
| country | ISO-Ländercode der Nummer, z. B. GB, DE, AT. Standard: DE. |
| api_key | Optional, wenn kein Bearer Token genutzt wird. |
curl "https://plant-id.de/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
Liefert Status und aktuelle Zähler der Datenbasis.
GET
/api/billing/plans.php
Liefert verfügbare API-Pakete, Limits und PayPal-Status.
POST
/api/account/api-keys.php
Erstellt einen API-Schlüssel für angemeldete und bestätigte Nutzer.
Antwortformat
Ein Treffer enthält alles für Anzeige, Prüfung und Formatierung.
codeVorwahl oder Rufnummerngasse, z. B. 030 oder +49.nameOrt, Land, Dienst oder Notrufbezeichnung.kindOrt, Land, Region, Dienst oder Notruf.local_formatEmpfohlenes nationales Anzeigeformat.international_formatEmpfohlenes internationales Anzeigeformat.adviceNutzerfreundlicher Hinweis zu Kosten, Nutzung oder Wahlweise.Pakete und Limits
Planbare Monatskontingente mit fairer kostenloser Nutzung.
Free
0 €5 Suchabfragen pro Tag, 150 pro Monat. Internationalizer: 2 pro Tag. API-Keys: 1.
Online buchbar
Pro
9,90 €/Monat1.000 Suchabfragen pro Tag, 10.000 pro Monat. Internationalizer: 100 pro Tag. API-Keys: 5.
Online buchbar
Business
49 €/Monat10.000 Suchabfragen pro Tag, 250.000 pro Monat. Internationalizer: 1.000 pro Tag. API-Keys: 50.
Online buchbar
Business Pro
99 €/Monat1.000.000 Suchabfragen pro Tag, 10.000.000 pro Monat. Internationalizer: unbegrenzt. API-Keys: 100.
Auf Anfrage
Die Zahlen werden live aus /api/health.php und /api/billing/plans.php geladen. Bei Überschreitung antwortet die API mit HTTP 429 und einem Hinweis auf das Kundenkonto.
Fehlercodes
Vorhersehbare Antworten für robuste Integrationen.
Support
Fragen zur Integration?
Schreib uns mit Anwendungsfall, erwarteter Last und gewünschtem Datenumfang.