Consultar el operador de un teléfono
Una api consultar operador de un telefono responde lo que un número validado por sí solo no puede: quién lo opera y qué tipo de línea es, móvil, fija o VoIP. Eso importa en el momento en que necesita decidir si un número siquiera puede recibir un SMS, o si un centro de llamadas debería enrutarlo distinto.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Validez no es lo mismo que utilidad
Un número telefónico puede ser perfectamente válido, con formato correcto, estructuralmente sano, y aun así resultar inútil para su propósito. Una línea fija no puede recibir un mensaje de texto. Un número VoIP asociado a una oficina virtual podría ser exactamente lo que un flujo de registro quiere bloquear, o exactamente lo que un negocio remoto quiere aceptar. Conocer el tipo de línea convierte una verificación de pasa o no pasa en un dato con el que sus sistemas realmente pueden razonar.
Qué devuelve la consulta de operador
Dado un número telefónico, el endpoint devuelve el país detectado, el nombre del operador actual cuando es posible determinarlo, y la clasificación del tipo de línea, móvil, fija, VoIP o desconocido. La detección de operador refleja datos de portabilidad numérica y enrutamiento en lugar de una tabla fija de prefijos, ya que los suscriptores cambian de operador con frecuencia manteniendo el mismo número, una realidad que ha hecho la consulta de operador considerablemente más difícil que cuando los códigos de área correspondían limpiamente a una sola compañía telefónica.
Cómo leer el resultado
Envía la solicitud y recibe un task_id de inmediato; el detalle real, país, operador, tipo de línea, llega a través de su webhook o un enlace firmado válido por 24 horas, tal como se resuelve cualquier tarea de esta API. Cuando un número no se puede vincular a un operador específico, quizás porque pertenece a un operador regional pequeño o los datos de portabilidad están incompletos, la respuesta lo refleja honestamente como desconocido en lugar de adivinar.
Una palabra sobre la división móvil, fija y VoIP
Los números móviles dominan el uso global hoy, pero las líneas fijas siguen siendo comunes en negocios y entre demografías de mayor edad en muchos países, y los números VoIP, asociados a servicios en vez de líneas físicas, han crecido rápido porque son baratos de aprovisionar y fáciles de descartar, precisamente la razón por la que los equipos antifraude les prestan más atención. Distinguir entre los tres no es cosmético; cambia lo que un número puede hacer técnicamente y el perfil de riesgo que suele acarrear.
Ponerla a trabajar
Ejecute la consulta de operador justo después de validar el teléfono en su flujo de registro para enrutar los números móviles hacia verificación por SMS y las líneas fijas hacia un camino de verificación por llamada de voz. Los equipos de fraude y riesgo usan la marca de VoIP como una señal más entre varias al calificar cuentas nuevas, y los centros de llamadas usan los datos de operador y tipo de línea para priorizar campañas salientes hacia números que realmente se pueden alcanzar. Como en cada tarea aquí, las consultas fallidas nunca se cobran y se reintentan automáticamente hasta tres veces.
Qué puede hacer con ella
Enrutamiento entre SMS y voz
Enrute automáticamente los números móviles hacia verificación por SMS y los números fijos hacia un camino de verificación por llamada de voz, en vez de enviar un texto que una línea fija nunca podrá recibir.
Puntuación de fraude basada en VoIP
Marque los números VoIP desechables como una señal de riesgo más durante la creación de cuentas, ya que son baratos de conseguir y fáciles de abandonar.
Priorización de centros de llamadas salientes
Ordene una lista de llamadas para que los agentes marquen primero números móviles y fijos alcanzables y salten los que los datos de operador marcan como no resueltos o con patrón inactivo.
Reportes internacionales por operador
Desglose una base de contactos de clientes por país y operador para entender dónde vale la pena fortalecer alianzas de soporte o entrega.
Preguntas frecuentes
¿Qué devuelve una api consultar operador de un telefono?
Devuelve el país detectado, el nombre del operador actual cuando es posible determinarlo, y el tipo de línea, móvil, fija, VoIP o desconocido.
¿Puede decirme si un número es móvil o fijo?
Sí, la clasificación del tipo de línea, móvil, fija o VoIP, es parte central de la respuesta de esta api consultar operador de un telefono.
¿Es gratis usarla?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta cada consulta?
Cada solicitud a /verify/phone-carrier cuesta 0.002 dólares, cobrados únicamente por tareas completadas con éxito.
¿Por qué la detección de operador a veces devuelve desconocido?
La portabilidad numérica permite que un suscriptor cambie de operador manteniendo su número, y los operadores regionales pequeños o los datos de portabilidad incompletos pueden hacer que el operador actual no se pueda determinar; la respuesta lo refleja honestamente en lugar de adivinar.
¿Necesito validar el número primero?
Se recomienda ejecutar primero la validación de teléfono para confirmar que el número es estructuralmente correcto, y luego usar la consulta de operador para el detalle de operador y tipo de línea; ambos endpoints están diseñados para complementarse.
¿Cómo recibo el resultado?
Obtiene un task_id de inmediato, y los datos de país, operador y tipo de línea llegan mediante su webhook firmado o un enlace firmado válido por 24 horas.
¿Funciona con números fuera de un solo país?
Sí, la detección de operador y tipo de línea cubre números en todo el mundo, no el plan de numeración de un solo país.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/verify/phone-carrier \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/verify/phone-carrier", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/phone-carrier",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/phone-carrier", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/phone-carrier", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"items": [
"valor-1",
"valor-2"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "verify.phone_carrier",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |