phonecode.app API · Documentación

Datos de prefijos en JSON

Identifica con fiabilidad números, prefijos y países.

La API de phonecode.app ofrece datos estructurados de prefijos locales e internacionales, números de servicio y emergencia, y conversión de números locales al formato internacional. Diseñada para tiendas, sistemas CRM, herramientas de soporte, formularios de clientes potenciales y calidad interna de datos.

28.608 Registros
5.200 Redes locales alemanas
206 países y territorios
76 Rangos de servicio y emergencia
382 Rangos móviles

Inicio rápido

Tu primera consulta en minutos.

1

Verificar cuenta

Regístrate en la cuenta de cliente y verifica tu correo electrónico.

2

Crear clave

Crea una clave API. Solo se muestra una vez en texto sin cifrar.

3

Obtener JSON

Envía la clave únicamente como Bearer Token en la cabecera Authorization.

Bearer Token

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

Transmitir claves de forma segura

Las claves API nunca deben aparecer en URL, historial del navegador, registros de proxy ni referencias de origen. Por eso no se aceptan parámetros de consulta.

Puntos de acceso

Puntos de acceso JSON claros para búsqueda, cuentas y facturación.

GET

/api/search.php

Busca prefijos, números de teléfono, localidades, países y números de servicio o emergencia.

ParámetroDescripción
qTérmino de búsqueda, por ejemplo 030, Berlin, +44, 0800.
limitOpcional, de 1 a 50 resultados. Predeterminado: 12.
GET

/api/internationalize.php

Convierte un número local de un país en un formato internacional que se puede copiar.

ParámetroDescripción
numberNúmero local, por ejemplo 0343 222 1234.
countryCódigo ISO del país del número, por ejemplo GB, DE, AT. Predeterminado: 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

Devuelve el estado y los recuentos actuales de datos.

GET

/api/billing/plans.php

Devuelve los planes API disponibles, límites y estado de PayPal.

POST

/api/account/api-keys.php

Crea una clave API para usuarios autenticados y verificados.

Formato de respuesta

Cada resultado contiene los datos para mostrar, comprobar y dar formato.

codePrefijo o rango de números, por ejemplo 030 o +49.
nameLocalidad, país, servicio o denominación de emergencia.
kindOrt, Land, Region, Dienst, Notruf.
local_formatFormato nacional de visualización recomendado.
international_formatFormato internacional de visualización recomendado.
adviceConsejo comprensible sobre costes, uso o forma de marcar.

Planes API

Cuotas mensuales previsibles con uso gratuito justo.

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