Solicitud cURL
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_activity_batch \
-F country=US \
-F [email protected]Actividad del número
Obtén una señal de actividad por número mediante una tarea de archivo asíncrona. Combina los resultados true/false con tus registros de interacción para revisar grupos y prioridades de seguimiento.
Este producto solo está disponible como tarea asíncrona con archivo. La consulta de operador en tiempo real no devuelve señales de validez ni de actividad.
Dos pasos: enviar el archivo y consultar la tarea
Al enviar se devuelve de inmediato un ID de tarea; consulte la tarea con ese ID y, cuando se complete correctamente, la respuesta incluirá el enlace de descarga del archivo de resultados. Cada solicitud se muestra con su propia respuesta.
1. Enviar el archivo
El ID de tarea se devuelve de inmediato con preparing en true mientras el archivo se prepara en segundo plano: se eliminan las líneas no válidas, los duplicados y, en las tareas de números, los números sin código de país o de otro país, que no se cobran. El saldo se reserva para las líneas enviadas y se liquida al completarse; la diferencia se reembolsa.
Respuesta: tarea creada
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_activity_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Consultar la tarea
Sondee por ID de tarea. Cuando finaliza la preparación, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, donde total es lo que se verifica y se cobra. Una respuesta correcta incluye los recuentos de éxitos y fallos y el enlace de descarga del archivo de resultados; una tarea rechazada durante la preparación queda en failed con reason_detail y se reembolsa íntegramente.
Solicitud cURL
GET /api/v1/bulk-tasks/{id}curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Respuesta: tarea finalizada
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_activity_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Qué ocurre con una tarea masiva
El modo masivo no es una versión ampliada del tiempo real: se envía una vez, se ejecuta en segundo plano y se recoge más tarde. No necesita mantener la página abierta; el estado de la tarea y los resultados permanecen en su panel.
01Suba el archivo
Un archivo .txt o .csv con un número por línea. Se transmite directamente; no se escribe nada en disco.
02Comprobación previa y reserva
Los problemas evidentes (un archivo vacío, un formato incorrecto, muy pocas líneas) se rechazan al subirlo. A continuación se reserva el saldo y el archivo se prepara en segundo plano: se eliminan las líneas duplicadas y no válidas, y se comprueba la regla de país. Un archivo que no supera esa fase termina como tarea fallida y se reembolsa íntegramente; en caso contrario, solo se verifican las líneas restantes y la tarea se liquida al completarse.
03Ejecución en segundo plano
La tarea se ejecuta por sí sola: puede cerrar la página si lo desea. Un fallo se notifica de inmediato y se reembolsa íntegramente.
04Descargue el resultado
Recoja el archivo en la página de verificación masiva. Solo paga por los números que realmente devolvieron un resultado; la diferencia se reembolsa.
Columnas del archivo de resultados
La descarga es un único archivo CSV con la tabla de resultados completa.
Columnas del archivo de resultados
identifier·12345678900— El número enviado en dígitos sin formato con el código de país, sin signo más ni espacios (p. ej., 12345678900), que se usa para volver a escribir el resultado de actividad en una lista, un cliente o un registro de lead. Solo sirve para asociar y rastrear; no incluye hora de actividad, frecuencia ni detalles de interacción.activated·true— Decisión de actividad del servicio: true es una coincidencia y false un negativo explícito. No incluye fecha, recuento ni ventana temporal. Interprétala con tus registros; no predice una respuesta.
Cuándo recurrir a este producto
Segmentación por actividad
Escriba la señal devuelta en etiquetas de audiencia y revísela junto con el inicio de sesión reciente, las compras o el estado de consentimiento para crear grupos listos para una revisión de seguimiento.
Relaciona identifier con el registro original y conserva la fuente para la revisión manual.
Clave de unión: identifier
Reactivación
Antes de planificar la reactivación, use la señal y sus registros de interacción existentes para fijar prioridades de revisión; una señal ausente no significa que una persona nunca vaya a responder.
Separa true, false y resultados ausentes; conserva los ausentes en la cola de revisión.
Campo de agrupación: activated
Planificación de audiencias
Divida las listas por señal, región o etapa del cliente antes de definir contenido, frecuencia y cadencia de contacto distintos para cada grupo, y siga midiendo sus propios resultados de negocio.
Guarda el resultado con la fecha de tarea registrada por tu equipo. Envía otra tarea para actualizarlo.
Campos de actualización: identifier · activated
¿Qué es la Verificación de actividad masiva?
Sube una lista de un solo país y descarga identifier y activated al finalizar. La señal ayuda a agrupar audiencias, pero no incluye ventana de observación, última actividad ni recuentos. Un resultado negativo por sí solo no identifica a un cliente inactivo.
Límites de este producto
- Interprete activated según el producto elegido: validez/activación o actividad. No incluye fechas ni frecuencia de actividad.
- Un resultado no acredita identidad ni consentimiento, ni garantiza que una llamada o un mensaje llegue a su destino.
- Los resultados no se actualizan automáticamente. Envíe una nueva tarea cuando necesite otra comprobación.
Acerca de Verificación de actividad
¿Qué significan true, false y un resultado ausente?
True es una coincidencia y false un negativo explícito de esta prueba. Ambos son decisiones obtenidas; false no significa fallo de ejecución ni fila gratuita. Trata los resultados ausentes, indeterminados y fallidos por separado según las estadísticas y la liquidación final; no los rellenes con false.
¿Muestra actividad de los últimos días o garantiza la entrega?
No. No incluye ventana de observación, última actividad, frecuencia ni historial de interacción y no garantiza llamadas ni mensajes. Úsalo junto con tus datos y el permiso de contacto.
¿Está disponible como comprobación en tiempo real?
Este producto solo está disponible como tarea asíncrona con archivo. La consulta de operador en tiempo real no devuelve señales de validez ni de actividad.
¿Qué ocurre con los números no válidos del archivo?
La comprobación previa descarta las líneas mal formadas, por lo que nunca entran en el recuento facturable. De los números restantes, tampoco se cobran los que el servicio de origen no pueda resolver. Solo paga por los números que realmente devuelven un resultado.
¿Cuánto tarda una tarea?
Depende de la cantidad de números y del producto. Puede cerrar la página después de enviarla; la tarea se ejecuta en segundo plano y el resultado le espera en la página de verificación masiva.
¿Se me reembolsa si falla?
Sí. Una tarea fallida se reembolsa íntegramente. Si la tarea se completa correctamente pero algunos números no devuelven nada, esa parte se reembolsa automáticamente. La diferencia entre el importe reservado y lo realmente cobrado siempre se devuelve.
Otros productos masivos
Consulta de operador globalSuba un archivo completo de números: operador, operador subyacente, tipo de línea, país, región y ciudad de cada uno, los mismos campos que la consulta de operador en tiempo real.Validación de números de teléfonoObtén una señal de validez o activación por número mediante una tarea de archivo asíncrona. Los resultados true/false ayudan a revisar listas importadas, depurar datos y mantener el CRM.Cree una cuenta para enviar una tarea masiva
Las verificaciones masivas y en tiempo real consumen el mismo saldo: no hay nada adicional que activar. Regístrese y suba su primer archivo en la página de verificación masiva.